Facebook-varningen "Please Upgrade SDK" i Events Manager (Flutter)

Det är inget fel på din SDK-version. Varningen är en defekt i Metas gränssnitt för Events Manager: utvecklarna som rapporterar den har redan ett SDK som är nyare än den version den ber om.

Det här pluginet bygger på Facebook SDK 18.x på båda plattformarna: FBSDKCoreKit ~> 18.0 på iOS och facebook-android-sdk [18.0,19.0) på Android. Events Manager ber dig nå 4.34.0. Du är redan långt förbi den.

• Nedgradera inte. Pluginet kräver 18.x på båda plattformarna, så om du låser ett äldre SDK slutar appen att byggas.
• Lägg inte till den avvecklade paraplypodden FacebookSDK. Meta slutade publicera den efter version 11.2.1, som släpptes i september 2021. Det finns ingen aktuell version av den att lägga till.
• Behandla inte varningen som en statuslampa. Meddelandet speglar inte den SDK-version du har installerad.

Kodlösa händelser (codeless events) bör fungera ändå, trots meddelandet. Vad som avgör om verktyget för kodlösa händelser fungerar för din app tas upp längre ner.

Facebook SDK för iOS levererades tidigare som en enda paraplypodd i CocoaPods, med namnet FacebookSDK. Meta avvecklade den podden efter version 11.2.1.

Det som ersatte den är en uppsättning komponentpoddar, så att en app bara kompilerar de delar den använder: FBSDKCoreKit för app-händelser och inställningar, FBSDKLoginKit för Facebook Login, FBSDKShareKit för delning, och några fler. Det här pluginet beror på FBSDKCoreKit, som är rätt komponent för app-händelser.

Varför meddelandet fortfarande ber om 4.34.0 är ingenting någon utanför Meta kan läsa ut ur en källfil: Events Manager körs på Metas servrar och kan inte se din Podfile. Vad vi kan säga är hur det ser ut utifrån, nämligen som en kontroll skriven för paraplypoddens tid, utan ord för de komponentpoddar som ersatte den. Det är vår läsning av bevisen, inte en mekanism vi kan visa dig. Versionsnumret passar den läsningen: 4.34.0 hör till 4.x-serien, år innan paraplypodden avvecklades i 11.2.1.

Vad du kan läsa själv är ärende #402 för det här pluginet. Events Manager sa till utvecklaren att SDK:t inte hade uppdaterats korrekt, och uppmanade till att ta bort FBSDKCoreKit, FBSDKLoginKit, FBSDKShareKit, FBSDKPlacesKit och FBSDKMessengerShareKit ur Podfile. FBSDKCoreKit är den podd det här pluginet beror på, komponenten som loggar app-händelser, så Events Manager bad om att det som får händelserna att fungera skulle raderas. Fem andra utvecklare rapporterade samma sak. Ärendet stängdes som inaktivt i mars 2025 utan svar.

Det är vad citeringen är värd: en verklig rapport, från en utvecklare på ett SDK ur den nuvarande generationen, om att Events Manager vill få bort podden som loggar app-händelser. Ärende #2513 i Metas eget iOS SDK-repo är ett närliggande fall snarare än samma, en utvecklare på SDK 17.1.0 som ombads uppdatera SDK:t för att kunna visa annonser på iOS 14.5 och senare, stängt som dubblett utan diagnos. Det länkas för att mönstret inte är begränsat till Flutter, inte för att det förklarar din varning.

Det finns ingenting i din app att slå på. SDK:t hämtar appinställningar från Meta och aktiverar den kodlösa vägen bara när de inställningarna säger att kodlösa händelser eller automatisk händelseuppsättning är påslaget för appen. På Android sitter grinden i CodelessManager.onActivityResumed, som läser Metas appinställningar. På iOS sitter den i FBSDKCodelessIndexer, som kontrollerar fältet auto_event_setup_enabled som Meta skickar tillbaka. Om verktyget fungerar avgörs på Metas sida, inte i ditt bygge.

Facebook SDK 18.x har fortfarande en flagga för kodlös felsökningsloggning på varje plattform: com.facebook.sdk.CodelessDebugLogEnabled på Android och FacebookCodelessDebugLogEnabled på iOS. Ingen av dem har någon konsument kvar i SDK:t. Ingenting på vägen som startar den kodlösa indexeraren läser dem, så att sätta någon av dem ändrar inget. Vi kontrollerade det mot de SDK-källor pluginet beror på: facebook-android-sdk 18.3.0 och facebook-ios-sdk 18.1.0.

Metas egen dokumentation beskriver fortfarande de flaggorna som vägen att slå på kodlös felsökningsloggning, och Android-referensen som länkas i slutet av sidan är där det står. På just den punkten ligger dokumentationen efter det SDK som faktiskt levereras. Läs källkoden, inte dokumentationen.

Metas dokumentation för kodlösa händelser stämmer inte med det SDK som levereras i andra riktningen heller. Den anger iOS-kravet som Full SDK v4.34 till v7.1.1, en övre gräns, och namnger paraply-SDK:t i stället för de komponentpoddar som ersatte det, och tillägger att funktionen inte är tillgänglig för v8.0.0 eller senare. Läst ordagrant utesluter det det 18.x-SDK som pluginet levererar. FBSDKCodelessIndexer finns fortfarande i FBSDKCoreKit i dag, så dokumentationen och SDK:t motsäger varandra. Vi visar hellre den motsägelsen än citerar den halva av Metas dokumentation som passar oss. Så varken varningen eller det versionsintervallet avgör om kodlös uppsättning är tillgänglig för din app: det gör den serverstyrda grinden ovan, och Metas dokumenterade intervall är föråldrat i båda riktningarna, med en undre gräns från 4.x-tiden och ett tak som det levererade SDK:t passerade för länge sedan.

Felsökningsinställningen som faktiskt gör något

Pluginet exponerar setDebugLoggingEnabled(bool), som slår på utförlig loggning från Facebook SDK för app-händelser och nätverksanrop. Den är symmetrisk mellan plattformarna: på Android anropar den FacebookSdk.setIsDebugEnabled, på iOS slår den på loggningsbeteendena för app-händelser och nätverksanrop, och false stänger av båda igen. Det gör den till den enda felsökningsinställningen på den här sidan som ändrar vad SDK:t gör, och den är värd att ha på medan du arbetar dig igenom det här. Den slår inte på kodlös loggning: pluginet har inget Dart-API för det.

Testa på en riktig telefon. Installera ett debug-bygge, öppna appen och skaka enheten: det är den rörelsen som öppnar verktyget, och Metas egen instruktion är just att skaka telefonen. En fysisk enhet är den tillförlitliga vägen till ett svar du kan agera på.

Om verktyget inte öppnas på en fysisk enhet är det ändå inte varningen som är orsaken. Arbeta igenom checklistan nedan, med identifierarna först och sedan vilken app du har öppen i Events Manager. Och håll föregående avsnitt i minnet: den kodlösa vägen aktiveras av Metas appinställningar, så en app som Meta inte har slagit på kodlös uppsättning för visar inte verktyget hur noga den än är konfigurerad.

En kosmetisk varning och uteblivna händelser är två olika problem. Om ingenting alls når Events Manager ligger orsakerna någon annanstans: client token, Graph API-version, inställningar som undertrycker händelser. Arbeta i stället igenom Facebook App Events syns inte i Events Manager.