Kembali ke Beranda untuk Developer

Memperkenalkan Platform Facebook SDK v13.0 & Pembaruan Terkait

24 Februari 2022OlehJim Phillips

Hari ini kami merilis Facebook SDK v13.0 dan pembaruan tambahan untuk Platform Facebook SDK kami. Postingan ini menguraikan pembaruan dan langkah-langkah yang harus diambil developer untuk menghindari gangguan, jika perlu, untuk integrasi aplikasi mereka dengan platform kami. Berikut adalah ringkasan singkat dari beberapa pembaruan yang disertakan sebagai bagian dari rilis SDK v13.0:

  • Dukungan Graph API v13.0: Kami menambahkan dukungan untuk Graph API v13.0 dan Marketing API v13.0.
  • Permintaan Izin Tersemat untuk ID Pengiklan Android di Facebook SDK untuk Android: Android SDK v13.0 sekarang akan menyertakan permintaan izin untuk ID Pengiklan Android secara default sesuai dengan kebijakan Layanan Google Play pada ID Pengiklan. Semua developer yang memanfaatkan Facebook SDK untuk Android perlu mengambil tindakan sebelum penegakan yang direncanakan Google dimulai April 2022 untuk menghindari gangguan pelayanan.
  • Persyaratan untuk menyematkan Token Klien di SDK berlaku: Dengan dirilisnya Facebook SDK v13.0, developer sekarang diwajibkan untuk menyematkan Token Klien di SDK.
  • Persyaratan untuk menggunakan bytecode Java 8 berlaku: Kami sekarang mewajibkan developer untuk menggunakan Java 8 bytecode untuk menghindari kesalahan kompilasi aplikasi.
  • Pengumuman Penghentian: SDK v12 (termasuk v12.1, v12.2, dsb.) sekarang dalam status penghentian. Mulai hari ini, developer harus mulai bermigrasi ke v13.0 untuk menghindari penggunaan SDK yang tidak digunakan lagi untuk aplikasi mereka.

Temukan detail tambahan tentang pembaruan ini di bawah.

Rilis SDK v.13.0

Hari ini Platform SDK v13.0 diluncurkan di seluruh platform Android dan iOS. Sebagai bagian dari rilis ini, kami menambahkan dukungan SDK untuk Graph API v13.0 dan Marketing API v13.0 dari Facebook. Kami telah membuat postingan blog ini untuk menyoroti pengumuman tambahan, pembaruan produk, dan pengingat yang terkait dengan rilis Graph API v13.0 dan Marketing API v13.0.

Pembaruan Penting Lainnya

Berikut adalah ringkasan singkat dari pembaruan dan perubahan lainnya yang disertakan sebagai bagian dari rilis SDK v13.0:

Modernisasi SDK: Konversi dari Objective-C ke Swift

Kami mengonversi kode SDK kami dari Objective-C ke Swift sejalan dengan modernisasi Platform SDK kami. Rilis SDK v13.0 mencakup beberapa perubahan dari upaya konversi yang mungkin memerlukan tindakan oleh Developer. Perubahan ini mencakup:

  • Sejumlah jenis telah dikonversi dari Objective-C ke Swift. Developer mungkin perlu menggunakan pernyataan impor modular saat menggunakan GamingServicesKit dan sebagian besar ShareKit untuk menghindari kesalahan kompilasi di Objective-C. Dalam kasus tersebut, Developer akan perlu menggunakan @import dan bukan #import dalam file Objective-C saat menggunakan simbol dari kit ini. Developer juga dapat merujuk catatan perubahan untuk detail selengkapnya tentang cara menggunakan pernyataan impor modular.
  • Selain itu, kami semakin mengurangi penggunaan praktik jenis nilai Objective-C di ShareKit. Dimulai dengan rilis SDK v13.0, jenis konten ShareKit tidak akan lagi menerapkan perilaku berikut: kesesuaian dengan protokol NSCopying kemampuan hash dan persamaan khusus, dan kesesuaian dengan NSSecureCoding. Developer dapat melihat catatan perubahan untuk detail tambahan.
  • Kami juga telah membuat lebih banyak pembaruan pada jenis antarmuka pelaporan peristiwa aplikasi sehingga mereka sekarang menggunakan peristiwa aplikasi dan nama parameter formal. Developer yang bekerja dalam kode Swift diwajibkan untuk menggunakan instance AppEvents.Name dan AppEvents.ParameterName untuk masing-masing mewakili nama peristiwa aplikasi dan nama parameter. Developer yang bekerja dalam kode Objective-C dapat terus menggunakan nilai string untuk merujuk Antarmuka Pelaporan. Developer dapat melihat catatan perubahan untuk detail tambahan.

Migrasi komponen Gaming dari ShareKit ke GamingServicesKit:

Sebagai bagian dari rilis SDK v13.0, kami telah memigrasikan enam jenis publik komponen gaming dari ShareKit ke GamingServicesKit, dan jenis publik ini juga telah dikonversi dari Objective-C ke Swift. Enam jenis publik yang dimigrasikan adalah: GameRequestActionType, GameRequestContent, GameRequestDialog, GameRequestDialogDelegate, GameRequestFilter, dan GameRequestURLProvider.

Penghentian & Perubahan Sela:

Permintaan Izin Tersemat untuk ID Pengiklan Android di Facebook SDK untuk Android:

Android SDK v13.0 sekarang menyertakan permintaan izin ID Pengiklan Android secara default. Kami membuat perubahan ini sejalan dengan kebijakan Layanan Google Play pada ID Pengiklan. Kami mewajibkan Developer untuk mengambil tindakan di bawah ini sebelum April 2022 guna menghindari gangguan layanan pada aplikasi mereka:

  • Semua developer yang menggunakan Android SDK v12.1 ke bawah harus meningkatkan ke v13.0
  • Developer yang memanfaatkan Peristiwa Aplikasi harus mengambil langkah-langkah berikut:
    • Jika menggunakan v12.1 ke bawah – tingkatkan ke v13.0
    • Jika menggunakan v12.2 atau 12.3 – sertakan permintaan izin ID Pengiklan Android di file Manifes Aplikasi untuk menerima ID Pengiklan yang valid (pelajari selengkapnya di sini)
    • Jika menggunakan v13.0 ke atas – tidak diperlukan tindakan, permintaan izin ID Pengiklan Android disertakan secara default
  • Developer yang tidak memanfaatkan Peristiwa Aplikasi harus mengambil langkah-langkah berikut:
    • Jika menggunakan v12.3 ke bawah – pastikan bendera Peristiwa Aplikasi dinonaktifkan (pelajari selengkapnya di sini)
    • Jika menggunakan v13.0 dan lebih tinggi – pastikan bendera Peristiwa Aplikasi dinonaktifkan (pelajari selengkapnya di sini) dan hapus permintaan izin ID Pengiklan Android (pelajari selengkapnya di sini)

Persyaratan untuk menyematkan Token Klien di SDK berlaku:

Dimulai dengan rilis Platform SDK v13.0, developer sekarang diharuskan untuk menyematkan Token Klien di SDK untuk panggilan Graph API. Dimasukkannya Token Klien dalam SDK memungkinkan kami untuk menganalisis masalah platform secara lebih efektif dan meningkatkan kinerja platform secara keseluruhan. Dengan peluncuran Platform SDK v13.0, kami sekarang akan menggunakan Token Klien untuk memproses panggilan Graph API ketika Token Akses atau Autentikasi tidak tersedia. Akibatnya, aplikasi apa pun yang menggunakan SDK v13.0 ke atas yang tidak menyertakan Token Klien akan memunculkan pengecualian saat inisialisasi SDK. Developer dapat mempelajari selengkapnya tentang cara menyematkan Token Klien Aplikasi di Android SDK di sini dan di iOS SDK di sini untuk menghindari gangguan layanan.

Persyaratan untuk menggunakan bytecode Java 8 berlaku:

Sejalan dengan pengumuman Kotlin bahwa compiler Kotlin/JVM akan menghasilkan bytecode Java 8 secara default, kami sekarang mewajibkan developer yang menggunakan Facebook SDK untuk Android agar meningkatkan ke bytecode Java 8 guna menghindari masalah apa pun selama kompilasi aplikasi. Developer dapat mempelajari selengkapnya tentang meningkatkan ke bytecode Java 8 di sini.

Penghentian Platform SDK v12.0:

Dengan dirilisnya SDK v13.0, kami mengumumkan bahwa SDK v12.0 sekarang dalam status penghentian selama periode 2 tahun. Selama periode penghentian ini, tidak akan ada dukungan pemeliharaan formal yang diberikan untuk masalah apa pun yang muncul di SDK v12.0. Pada akhir periode penghentian 2 tahun, SDK v12.0 akan dihentikan dan tidak lagi beroperasi. Dengan tidak berlakunya SDK v12.0, developer didorong untuk memulai proses migrasi ke SDK v13.0 sesegera mungkin untuk menggunakan SDK terbaru dan terhebat dengan dukungan pemeliharaan formal.

Versi yang Tidak Berlaku Lagi:

Di bawah ini adalah versi Platform Facebook SDK yang tidak berlaku lagi dan tanggal terkait:

  • 24 Februari 2022: iOS & Android SDK v12 (Tidak berlaku lagi)
  • 21 Oktober 2021: iOS & Android SDK v11 (Tidak berlaku lagi)
  • 8 Juni 2021: iOS, Android & Unity SDK v9 (Tidak berlaku lagi)
  • 19 Januari 2021: iOS, Android & Unity SDK v8.2 ke bawah (Tidak berlaku lagi)

Catatan Perubahan:

Kunjungi Catatan Perubahan kami untuk meninjau perubahan spesifik pada SDK dan tetap mendapat informasi tentang peningkatan yang direncanakan: