개발자 소식으로 돌아가기

Facebook 플랫폼 SDK v13.0 소개 및 관련 업데이트

2022년 2월 24일제작:Jim Phillips

오늘 Facebook SDK v13.0 및 Facebook 플랫폼 SDK에 대한 추가 업데이트를 릴리스합니다. 이 게시물에서는 개발자가 Facebook 플랫폼과 앱을 통합할 때 앱 작동이 중단되지 않도록 하는 데 필요한 조치(필요한 경우)와 업데이트를 간략히 설명합니다. 아래에서 SDK v13.0 릴리스에 포함된 몇 가지 업데이트를 간단히 살펴보겠습니다.

  • 그래프 API v13.0 지원: 그래프 API v13.0 및 마케팅 API v13.0에 대한 지원을 추가합니다.
  • Facebook SDK for Android에 Android 광고주 ID에 대한 권한 요청 포함(embed): 이제 Android SDK v13.0에 Android 광고주 ID에 대한 권한 요청이 포함되며 기본적으로 광고주 ID에 대한 Google Play 서비스 정책에 따릅니다. Facebook SDK for Android를 사용하는 모든 개발자는 Google의 규정이 시행되는 2022년 4월 전에 조치를 취해야 서비스가 중단되지 않습니다.
  • SDK에 클라이언트 토큰 포함(embed)에 대한 요구 사항 적용: Facebook SDK v13.0이 릴리스되면서 개발자는 이제 SDK에 클라이언트 토큰을 포함(embed)해야 합니다.
  • Java 8 바이트코드 사용에 대한 요구 사항 적용: 이제 개발자는 Java 8 바이트코드를 사용하여 앱 컴파일 오류를 방지해야 합니다.
  • 사용 중단 알림: SDK v12(v12.1, v12.2 등 포함)는 이제 사용 중단된 상태입니다. 앱에 사용 중단된 SDK를 사용하지 않으려면 오늘부터 v13.0으로 마이그레이션을 시작해야 합니다.

이 업데이트에 대한 자세한 내용은 아래를 참조하세요.

SDK v13.0 릴리스

오늘 플랫폼 SDK v13.0이 Android와 iOS 플랫폼에서 출시됩니다. 이번 릴리스에서는 Facebook 그래프 API v13.0 및 마케팅 API v13.0에 대한 SDK 지원이 추가되었습니다. 이 블로그 게시물은 그래프 API v13.0과 마케팅 API v13.0 릴리스와 관련된 추가 공지, 제품 업데이트 및 알림을 알려드리기 위해 작성되었습니다.

기타 주요 업데이트

SDK v13.0 릴리스에 포함된 다른 업데이트 및 변경 사항에 대한 개요는 아래와 같습니다.

SDK 현대화: Objective-C에서 Swift로 전환

플랫폼 SDK 현대화에 맞추어 SDK 코드도 Objective-C에서 Swift로 전환 중입니다. SDK v13.0 릴리스에는 전환 과정에서 개발자의 조치가 필요한 여러 가지 변경 사항이 포함되어 있습니다. 변경 사항은 다음과 같습니다.

  • 여러 유형이 Objective-C에서 Swift로 전환되었습니다. 개발자는 GamingServicesKit와 ShareKit 대부분에서 모듈식 가져오기 명령문을 사용해야 Objective-C에서 컴파일 오류가 발생하지 않습니다. 이 경우 이러한 키트의 기호를 사용할 때 Objective-C 파일에서 #import 대신 @import를 사용해야 합니다. 모듈식 가져오기 명령문을 사용하는 방법에 대한 자세한 내용은 변경 사항을 참조할 수도 있습니다.
  • 또한 ShareKit에서 Objective-C 값-유형을 사용하던 방식을 줄여나갈 것입니다. SDK v13.0 릴리스부터 ShareKit 콘텐츠 유형은 더 이상 NSCopying 프로토콜 적합성, 사용자 정의 해시 가능성 및 동등성, NSSecureCoding 적합성의 동작을 구현하지 않습니다. 개발자는 변경 사항에서 자세한 정보를 확인할 수 있습니다.
  • 또한 앱 이벤트 보고 인터페이스 유형을 한층 업데이트하여 이제 공식 앱 이벤트와 매개변수 이름을 사용할 수 있도록 했습니다. Swift 코드로 개발하는 개발자는 각각 AppEvents.NameAppEvents.ParameterName 인스턴스를 사용하여 앱 이벤트 이름과 매개변수 이름을 나타내야 합니다. Objective-C 코드로 개발하는 개발자는 앞으로 계속 문자열 값을 사용하여 보고 인터페이스를 참조할 수 있습니다. 개발자는 변경 사항에서 자세한 정보를 확인할 수 있습니다.

ShareKit에서 GamingServicesKit로 게이밍 구성 요소 마이그레이션:

SDK v13.0 릴리스에서는 ShareKit에서 GamingServicesKit로 6가지 게이밍 구성 요소의 공개 유형을 마이그레이션하였고 해당 공개 유형은 Objective-C에서 Swift로 전환되었습니다. 마이그레이션된 6가지 공개 유형: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilterGameRequestURLProvider.

사용 중단 및 핵심 변경 사항:

Facebook SDK for Android에서 Android 광고주 ID에 대한 권한 요청 포함(embed)

이제 Android SDK v13.0에는 기본적으로 Android 광고주 ID 권한 요청이 포함됩니다. 이 변경 사항은 광고주 ID에 대한 Google Play 서비스 정책에 따른 것입니다. 개발자 여러분께서는 2022년 4월 전에 아래의 조치를 취해 앱 서비스가 중단되지 않도록 하세요.

  • Android SDK v12.1 이하를 사용하는 모든 개발자는 v13.0으로 업그레이드해야 합니다.
  • 앱 이벤트를 사용하는 개발자는 다음과 같은 단계를 따라야 합니다.
    • v12.1 이하를 사용할 경우 – v13.0으로 업그레이드
    • v12.2 또는 12.3을 사용할 경우 – Android 광고주 ID 권한 요청을 앱 매니페스트 파일에 넣어서 유효한 광고주 ID 수신(자세한 내용은 여기 참조)
    • v13.0 이상을 사용할 경우 – 조치 불필요, Android 광고주 ID 권한 요청을 기본적으로 포함
  • 앱 이벤트를 사용하지 않는 개발자는 다음과 같은 단계를 따라야 합니다.
    • v12.3 이하를 사용할 경우 – 앱 이벤트 플래그를 비활성화(자세한 내용은 여기 참조)
    • v13.0 이상을 사용할 경우 – 앱 이벤트 플래그를 비활성화(자세한 내용은 여기 참조)하고 Android 광고주 ID 권한 요청을 삭제(자세한 내용은 여기 참조)

SDK에 클라이언트 토큰 포함(embed)에 대한 요구 사항 적용:

플랫폼 SDK v13.0 릴리스부터 개발자는 SDK에 그래프 API 호출을 위한 클라이언트 토큰을 포함(embed)해야 합니다. SDK에 클라이언트 토큰을 포함하면 플랫폼 문제를 더 효과적으로 분석하고 플랫폼 전체의 성능을 향상할 수 있습니다. 플랫폼 SDK v13.0이 출시됨에 따라 이제 그래프 API 호출을 처리할 때 액세스 토큰이나 인증 토큰을 사용할 수 없는 경우 클라이언트 토큰을 사용합니다. 그러므로 SDK v13.0 이상을 사용하고 클라이언트 토큰을 포함하지 않은 앱은 SDK 초기화 시 예외가 발생합니다. 앱 클라이언트 토큰을 포함(embed)하는 방법에 대한 자세한 내용은 Android SDK의 경우 여기, iOS SDK의 경우 여기에서 참조하여 서비스가 중단되지 않도록 하세요.

Java 8 바이트코드 사용에 대한 요구 사항 적용:

Kotlin 알림에 따르면 Kotlin/JVM 컴파일러는 기본적으로 Java 8 바이트코드를 생성합니다. 이제 Facebook SDK for Android를 사용하는 개발자는 앱 컴파일 시 문제가 발생하지 않도록 Java 8 바이트코드로 업그레이드해야 합니다. Java 8 바이트코드 업그레이드에 대한 자세한 내용은 여기를 참조하세요.

플랫폼 SDK v12.0 사용 중단:

SDK v13.0이 릴리스되면서 이제 SDK v12.0이 2년 동안 사용 중단됩니다. 이 사용 중단 기간에는 SDK v12.0에서 발생한 문제에 대해 공식적인 유지관리가 지원되지 않습니다. 2년의 사용 중단 기간이 끝나면 SDK v12.0은 완전히 중단되고 더 이상 작동하지 않습니다. SDK v12.0이 사용 중단되었으므로 개발자 여러분께서는 최대한 이른 시일 내에 SDK V13.0으로 마이그레이션하는 절차를 시작하여 가장 기능이 우수하고 공식적인 유지관리가 지원되는 최신 SDK를 사용하시는 것이 좋습니다.

사용 중단 버전:

Facebook 플랫폼 SDK의 사용 중단된 버전과 관련 날짜는 다음과 같습니다.

  • 2022년 2월 24일: iOS & Android SDK v12(사용 중단)
  • 2021년 10월 21일: iOS & Android SDK v11(사용 중단)
  • 2021년 6월 8일: iOS, Android & Unity SDK v9(사용 중단)
  • 2021년 1월 29일: iOS, Android & Unity SDK v8.2 이하(사용 중단)

변경 사항:

변경 사항에서 SDK에 대한 구체적인 변경 사항을 검토하고 예정된 개선 사항을 확인하세요.