Peringatan Facebook "Please Upgrade SDK" di Events Manager (Flutter)

Tidak ada yang salah dengan versi SDK Anda. Peringatan itu adalah cacat pada antarmuka Events Manager milik Meta: para pengembang yang melaporkannya sudah memakai SDK yang lebih baru daripada versi yang dimintanya.

Plugin ini memakai Facebook SDK 18.x di kedua platform: FBSDKCoreKit ~> 18.0 di iOS dan facebook-android-sdk [18.0,19.0) di Android. Events Manager meminta Anda mencapai 4.34.0. Anda sudah jauh melewatinya.

• Jangan turunkan versi. Plugin ini membutuhkan 18.x di kedua platform, jadi mengunci SDK yang lebih lama membuat aplikasi gagal dibangun.
• Jangan tambahkan pod payung FacebookSDK yang sudah dihentikan. Meta berhenti menerbitkannya setelah versi 11.2.1, yang dirilis pada September 2021. Sudah tidak ada versi terbaru dari pod itu untuk ditambahkan.
• Jangan anggap peringatan itu sebagai lampu status. Pesan itu tidak mencerminkan versi SDK yang Anda pasang.

Codeless events semestinya tetap berjalan meski pesan itu muncul. Apa yang menentukan apakah alat penyiapan codeless bekerja untuk aplikasi Anda dibahas di bawah.

Facebook SDK untuk iOS dahulu dirilis sebagai satu pod payung CocoaPods bernama FacebookSDK. Meta menghentikan pod itu setelah versi 11.2.1.

Penggantinya adalah sekumpulan pod komponen, sehingga aplikasi hanya mengompilasi bagian yang dipakainya: FBSDKCoreKit untuk app events dan setelan, FBSDKLoginKit untuk Facebook Login, FBSDKShareKit untuk berbagi, dan beberapa lainnya. Plugin ini bergantung pada FBSDKCoreKit, komponen yang tepat untuk app events.

Kenapa pesan itu masih meminta 4.34.0 bukan sesuatu yang bisa dibaca dari file sumber oleh siapa pun di luar Meta: Events Manager berjalan di server Meta dan tidak bisa melihat Podfile Anda. Yang bisa kami katakan adalah bagaimana hal itu terlihat dari luar, yaitu seperti pemeriksaan yang ditulis untuk era pod payung, tanpa kosakata untuk pod komponen yang menggantikannya. Itu bacaan kami atas bukti yang ada, bukan mekanisme yang bisa kami tunjukkan. Nomor versinya cocok dengan bacaan itu: 4.34.0 berasal dari seri 4.x, bertahun-tahun sebelum pod payung dihentikan pada 11.2.1.

Yang bisa Anda baca sendiri adalah issue #402 di plugin ini. Events Manager memberi tahu pengembang itu bahwa SDK-nya belum diperbarui dengan benar, lalu menyuruhnya menghapus FBSDKCoreKit, FBSDKLoginKit, FBSDKShareKit, FBSDKPlacesKit dan FBSDKMessengerShareKit dari Podfile. FBSDKCoreKit adalah pod yang menjadi dependency plugin ini, komponen yang mencatat app events, jadi Events Manager meminta agar justru yang membuat event berjalan itu dihapus. Lima pengembang lain melaporkan hal yang sama. Issue itu ditutup karena tidak aktif pada Maret 2025 tanpa jawaban.

Itulah nilai kutipan tersebut: sebuah laporan nyata, dari pengembang yang memakai SDK generasi sekarang, tentang Events Manager yang menyuruhnya menghapus pod yang mencatat app events. Issue #2513 di repo iOS SDK milik Meta sendiri adalah kasus yang berdekatan, bukan kasus yang sama, yaitu pengembang di SDK 17.1.0 yang disuruh memperbarui SDK agar bisa menayangkan iklan di iOS 14.5 dan setelahnya, lalu ditutup sebagai duplikat tanpa diagnosis. Kami menautkannya karena polanya tidak terbatas pada Flutter, bukan karena ia menjelaskan peringatan Anda.

Tidak ada yang perlu Anda aktifkan di aplikasi. SDK mengambil app settings dari Meta dan hanya menyiapkan jalur codeless ketika setelan itu menyatakan codeless events atau automatic event setup aktif untuk aplikasi tersebut. Di Android gerbangnya ada di CodelessManager.onActivityResumed, yang membaca app settings dari Meta. Di iOS gerbangnya ada di FBSDKCodelessIndexer, yang memeriksa field auto_event_setup_enabled yang dikirim Meta. Jadi berfungsi atau tidaknya alat itu ditentukan di sisi Meta, bukan di build Anda.

Facebook SDK 18.x masih membawa satu flag codeless debug di tiap platform: com.facebook.sdk.CodelessDebugLogEnabled di Android dan FacebookCodelessDebugLogEnabled di iOS. Keduanya sudah tidak punya konsumen di dalam SDK. Tidak ada bagian dari jalur yang menjalankan codeless indexer yang membaca flag itu, jadi menyetelnya tidak mengubah apa pun. Kami memeriksanya langsung pada sumber SDK yang dipakai plugin ini: facebook-android-sdk 18.3.0 dan facebook-ios-sdk 18.1.0.

Dokumentasi Meta sendiri masih menyebut flag itu sebagai cara mengaktifkan codeless debug logging, dan referensi Android yang ditautkan di akhir halaman adalah tempat pernyataan itu berada. Untuk hal ini dokumentasinya tertinggal dari SDK yang benar-benar dirilis. Bacalah kode sumbernya, bukan dokumentasinya.

Dokumentasi Meta untuk codeless events juga tidak sejalan dengan SDK yang dirilis, hanya ke arah sebaliknya. Dokumen itu menyebut syarat iOS sebagai Full SDK v4.34 sampai v7.1.1, sebuah batas atas, dan menamai SDK payung alih-alih pod komponen yang menggantikannya, lalu menambahkan bahwa fitur ini tidak tersedia untuk v8.0.0 atau setelahnya. Dibaca apa adanya, itu mengecualikan SDK 18.x yang dipakai plugin ini. FBSDKCodelessIndexer masih ada di dalam FBSDKCoreKit hari ini, jadi dokumentasi dan SDK-nya saling bertentangan. Kami lebih memilih menunjukkan pertentangan itu daripada mengutip separuh dokumentasi Meta yang menguntungkan kami. Jadi bukan peringatan itu, bukan pula rentang versi tadi, yang menentukan apakah codeless setup tersedia untuk aplikasi Anda: yang menentukan adalah gerbang di sisi server tadi, dan rentang yang didokumentasikan Meta sudah basi di kedua arah, dengan batas bawah dari era 4.x dan batas atas yang sudah lama dilewati SDK yang benar-benar dirilis.

Pengaturan debug yang benar-benar bekerja

Plugin ini menyediakan setDebugLoggingEnabled(bool), yang mengaktifkan log verbose Facebook SDK untuk app events dan permintaan jaringan. Perilakunya simetris di kedua platform: di Android metode itu memanggil FacebookSdk.setIsDebugEnabled, di iOS ia mengaktifkan logging behavior untuk app events dan permintaan jaringan, dan nilai false mematikan keduanya kembali. Jadi inilah satu-satunya pengaturan debug di halaman ini yang benar-benar mengubah perilaku SDK, dan berguna untuk diaktifkan selama Anda menelusuri masalah ini. Pengaturan ini tidak mengaktifkan codeless logging: plugin ini tidak punya API Dart untuk itu.

Ujilah di ponsel sungguhan. Pasang build debug, buka aplikasinya, lalu goyangkan perangkat: gerakan itulah yang membuka alat tersebut, dan instruksi Meta sendiri memang sesederhana menggoyangkan ponsel. Perangkat fisik adalah jalur yang bisa diandalkan untuk mendapat jawaban yang bisa Anda tindaklanjuti.

Jika alat itu tidak terbuka di perangkat fisik, peringatan tadi tetap bukan penyebabnya. Telusuri daftar periksa di bawah, dimulai dari identifier lalu aplikasi mana yang Anda buka di Events Manager. Dan ingat bagian sebelumnya: jalur codeless disiapkan oleh app settings dari Meta, jadi aplikasi yang belum diaktifkan codeless setup-nya oleh Meta tidak akan menampilkan alat itu sebaik apa pun konfigurasinya.

Peringatan kosmetik dan event yang tidak sampai adalah dua masalah berbeda. Jika tidak ada apa pun yang sampai ke Events Manager, penyebabnya ada di tempat lain: client token, versi Graph API, setelan yang membatasi pengiriman event. Telusuri Facebook App Events tidak muncul di Events Manager sebagai gantinya.