Menahan Facebook SDK sampai pengguna memberi persetujuan di aplikasi Flutter
Terakhir diperbarui 17 November 2026
Flag yang biasa dipasang tidak cukup
Secara default Facebook SDK diinisialisasi sebelum kode Dart Anda berjalan. Di iOS, plugin menginisialisasinya saat plugin didaftarkan. Di Android, FacebookInitProvider milik SDK berjalan saat proses dimulai.
Inisialisasi bukan langkah yang pasif. Ia mengambil konfigurasi gatekeeper, server, dan domain dari Meta, lalu menulis ke penyimpanan lokal. Flag AutoLogAppEventsEnabled dan AdvertiserIDCollectionEnabled tidak mencegah hal itu. Keduanya hanya menghentikan pencatatan app event.
Kalau aplikasi Anda tidak boleh menjangkau Meta sebelum pengguna setuju, mematikan auto-log bukan jawabannya. Yang harus ditunda adalah inisialisasinya sendiri.
Matikan inisialisasi otomatis
Pasang satu key di tiap platform:
<!-- ios/Runner/Info.plist -->
<key>FacebookAutoInitEnabled</key>
<false/><!-- android/app/src/main/AndroidManifest.xml, under <application> -->
<meta-data android:name="com.facebook.sdk.AutoInitEnabled" android:value="false"/>Lalu inisialisasi dari Dart setelah persetujuan ada:
final facebookAppEvents = FacebookAppEvents();
// Setelah pengguna setuju, dan pada setiap pembukaan berikutnya
// ketika persetujuan sudah tersimpan.
await facebookAppEvents.initializeSdk();
await facebookAppEvents.activateApp(); // hanya jika auto-log juga dimatikanPlugin tidak mengingat keputusan itu untuk Anda. Panggil initializeSdk() pada setiap pembukaan aplikasi ketika persetujuan sudah tersimpan. Memanggilnya lebih dari sekali tidak berbahaya, dan key yang tidak ada berarti inisialisasi otomatis tetap aktif, jadi aplikasi yang sudah ada tidak terpengaruh.
Kedua platform tidak berperilaku sama
Di sinilah alur persetujuan biasanya rusak.
iOS: tidak ada yang berfungsi sebelum Anda menginisialisasi
Dengan FacebookAutoInitEnabled bernilai false, SDK iOS belum terkonfigurasi, dan ia tidak menoleransi pemanggilan dalam keadaan itu. Method app event melempar error di build debug dan dibuang diam-diam di build release. Setter pengaturan yang tersimpan membuat aplikasi crash. App id di-cache sebagai kosong sampai proses berakhir.
Karena itu plugin menolak semua method kecuali initializeSdk dan setGraphApiVersion dengan kode error sdk_not_initialized. Error ini disengaja. Ia muncul saat pengembangan, bukan sebagai data yang hilang di produksi.
Praktiknya: panggil initializeSdk() sebelum setUserData, setDataProcessingOptions, setLimitEventAndDataUsage, setAutoLogAppEventsEnabled, atau pemanggilan logging apa pun.
Android: SDK sudah aktif
AutoInitEnabled=false tidak membuat SDK Android tetap tidur. App id dan client token tetap dimuat saat proses dimulai, dan pemanggilan plugin tetap berfungsi. SDK hanya belum "fully initialized", dan initializeSdk() menyelesaikan langkah itu.
Jadi alur persetujuan yang ditulis dan diuji di Android bisa saja urutannya salah untuk iOS. Uji alurnya di keduanya.
Ketika Android melaporkan sdk_not_initialized
Di Android error ini berarti hal lain: SDK gagal berjalan sama sekali. Kegagalannya senyap. Satu-satunya jejak adalah baris level info di logcat, Failed to auto initialize the Facebook SDK, dan aplikasi tetap berjalan.
Versi plugin yang lebih lama menampilkannya sebagai lateinit property appEventsLogger has not been initialized. Mulai versi 0.34.0, pemanggilan yang membutuhkan SDK gagal dengan sdk_not_initialized, dan initializeSdk() memberi tahu sebabnya:
try {
await facebookAppEvents.initializeSdk();
} on FacebookAppEventsException catch (e) {
if (e.errorCode == FacebookAppEventsErrorCode.sdkInitializationFailed) {
// Alasan dari SDK sendiri, misalnya client token yang tidak ada.
debugPrint(e.message);
}
}Penyebab yang paling umum adalah app id atau client token tidak terbaca dari AndroidManifest.xml. Di mana client token harus diletakkan membahas dua file yang dibutuhkan Android.
Ada dua hal yang penting di sini. Plugin tidak pernah menginisialisasi SDK dengan sendirinya, jadi aplikasi yang menahan SDK demi persetujuan tidak akan dilangkahi. Dan gunakan await pada pemanggilan plugin di dalam blok try. Pemanggilan tanpa await yang gagal menjadi error yang tidak tertangani dan tidak pernah sampai ke catch Anda.
Apa yang tetap direkam Android sebelum persetujuan
Menunda inisialisasi tidak menunda semuanya di Android. Sejak Facebook SDK v19, SDK menyimpan URL yang membuka aplikasi Anda, dan di Android hal itu dimulai saat proses dimulai, bahkan dengan AutoInitEnabled=false. Kalau tidak boleh ada yang dikumpulkan sebelum persetujuan, Anda butuh satu key lagi di manifest. Detailnya ada di apa yang ditambahkan SDK v19 ke event Anda.
Periksa pengaturan Anda
- FacebookAutoInitEnabled bernilai false di Info.plist dan com.facebook.sdk.AutoInitEnabled bernilai false di AndroidManifest.xml
- initializeSdk() dijalankan pada setiap pembukaan ketika persetujuan sudah tersimpan, bukan hanya saat pengguna pertama kali setuju
- Di iOS, initializeSdk() dipanggil sebelum setter atau pemanggilan logging apa pun
- Anda menguji alur persetujuan di iOS dan di Android, bukan hanya di salah satunya
- Pemanggilan plugin memakai await di dalam blok try yang dimaksudkan untuk menangkap error-nya
- Kalau tidak boleh ada yang disimpan sebelum persetujuan di Android, com.facebook.sdk.AutoLogMetaDataEnabled juga bernilai false
Dokumentasi referensi Meta
Referensi API plugin
Masih terhambat?
Ini defek pada plugin
Jika plugin melakukan sesuatu yang tidak dilakukan Facebook SDK native, itu bug kami. Buka issue dan kami perbaiki. Gratis, selalu, tanpa syarat.
Buka issue di GitHubIni pertanyaan soal penggunaan
Pertanyaan soal konfigurasi dan integrasi paling baik diajukan di tempat yang bisa ditemukan developer lain nanti.
Tanya di StackOverflowAngka Anda salah dan ada uang yang bergerak
Jika kampanye instalasi Meta terus mengeluarkan biaya dan atribusinya tidak sesuai, itu masalah yang berbeda dari build yang rusak. Semuanya dimulai dengan panggilan gratis 20 menit. Panggilan diagnostik satu jam, 300 USD dan dikreditkan ke biaya audit, menyusul jika memang layak.
Lihat panggilan diagnostik dan audit