Håll tillbaka Facebook SDK tills användaren samtyckt, i en Flutter-app

Senast uppdaterad 17 november 2026

Flaggorna de flesta appar sätter räcker inte

Som standard initieras Facebook SDK innan din Dart-kod körs. På iOS initierar pluginet det när det registreras. På Android körs SDK:ns egen FacebookInitProvider när processen startar.

Initieringen är inte passiv. Den hämtar gatekeeper-, server- och domänkonfiguration från Meta och skriver till lokal lagring. Flaggorna AutoLogAppEventsEnabled och AdvertiserIDCollectionEnabled hindrar inte det. De stoppar bara att app-händelser loggas.

Om din app inte får nå Meta förrän användaren sagt ja är det alltså inte lösningen att stänga av auto-loggning. Du måste skjuta upp själva initieringen.

Stäng av den automatiska initieringen

Sätt en nyckel per plattform:

<!-- 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"/>

Initiera sedan från Dart när samtycket finns:

final facebookAppEvents = FacebookAppEvents();

// Efter att användaren samtyckt, och vid varje senare start
// där samtycket redan är sparat.
await facebookAppEvents.initializeSdk();
await facebookAppEvents.activateApp(); // bara om auto-loggning också är avstängd

Pluginet kommer inte ihåg beslutet åt dig. Anropa initializeSdk() vid varje start där samtycket är sparat. Att anropa det flera gånger är ofarligt, och en saknad nyckel betyder att automatisk initiering är kvar, så befintliga appar påverkas inte.

De två plattformarna beter sig inte likadant

Det är här samtyckesflöden går sönder.

iOS: ingenting fungerar förrän du initierat

Med FacebookAutoInitEnabled satt till false är iOS-SDK:n okonfigurerad, och den tål inte anrop i det läget. Metoder för app-händelser kastar fel i debug-byggen och släpps tyst i release. De sparade inställningarnas setters kraschar. App-id:t cachas som tomt för resten av processen.

Därför avvisar pluginet varje metod utom initializeSdk och setGraphApiVersion med felkoden sdk_not_initialized. Felet är avsiktligt. Det syns under utveckling i stället för som förlorad data i produktion.

I praktiken: anropa initializeSdk() före setUserData, setDataProcessingOptions, setLimitEventAndDataUsage, setAutoLogAppEventsEnabled och alla loggningsanrop.

Android: SDK:n är redan vaken

AutoInitEnabled=false håller inte Android-SDK:n sovande. App-id och client token läses fortfarande in när processen startar, och plugin-anrop fungerar. SDK:n är bara inte "fullt initierad", och initializeSdk() slutför det steget.

Ett samtyckesflöde som skrivits och testats på Android kan därför ha fel ordning för iOS. Testa flödet på båda.

När Android rapporterar sdk_not_initialized

På Android betyder felet något annat: SDK:n startade inte alls. Det sker tyst. Det enda spåret är en rad på info-nivå i logcat, Failed to auto initialize the Facebook SDK, och appen kör vidare.

Äldre plugin-versioner visade detta som lateinit property appEventsLogger has not been initialized. Från version 0.34.0 misslyckas anropen som behöver SDK:n med sdk_not_initialized, och initializeSdk() berättar varför:

try {
  await facebookAppEvents.initializeSdk();
} on FacebookAppEventsException catch (e) {
  if (e.errorCode == FacebookAppEventsErrorCode.sdkInitializationFailed) {
    // SDK:ns egen förklaring, till exempel en saknad client token.
    debugPrint(e.message);
  }
}

Den vanliga orsaken är att app-id eller client token inte kunde läsas från AndroidManifest.xml. Var client token hör hemma går igenom de två filer Android behöver.

Två detaljer är viktiga. Pluginet initierar aldrig SDK:n på egen hand, så en app som håller tillbaka SDK:n för samtycke körs inte över. Och använd await på dina plugin-anrop inne i try-blocket. Ett anrop utan await som misslyckas blir ett ohanterat fel och når aldrig din catch.

Vad Android ändå samlar in före samtycke

Att skjuta upp initieringen skjuter inte upp allt på Android. Sedan Facebook SDK v19 sparar SDK:n den URL som öppnade din app, och på Android börjar det när processen startar även med AutoInitEnabled=false. Om ingenting får samlas in före samtycke behöver du en nyckel till i manifestet. Vad SDK v19 lägger till i dina händelser har detaljerna.

Kontrollera din uppsättning

  • FacebookAutoInitEnabled är false i Info.plist och com.facebook.sdk.AutoInitEnabled är false i AndroidManifest.xml
  • initializeSdk() körs vid varje start där samtycket redan är sparat, inte bara vid starten där användaren sa ja
  • På iOS anropas initializeSdk() före alla setters och loggningsanrop
  • Du har testat samtyckesflödet på både iOS och Android, inte bara på en av dem
  • Plugin-anropen har await inne i det try-block som ska fånga deras fel
  • Om ingenting får sparas före samtycke på Android är även com.facebook.sdk.AutoLogMetaDataEnabled satt till false

Metas referensdokumentation

API-referens för pluginet

Fortfarande fast?

Det är en defekt i pluginet

Om pluginet gör något som det nativa Facebook SDK:t inte gör, då är det vår bugg. Öppna ett ärende och vi åtgärdar det. Gratis, alltid, utan villkor.

Öppna ett ärende på GitHub

Det är en användningsfråga

Frågor om konfiguration och integration ställs bäst där andra utvecklare kan hitta svaret senare.

Fråga på StackOverflow

Dina siffror är fel och pengar rör sig

Om Meta-installationskampanjer spenderar och attributionen inte går ihop, då är det ett annat problem än en trasig build. Det börjar med ett gratis samtal på 20 minuter. Diagnossamtalet på en timme, 300 USD som krediteras mot granskningen, följer om det är värt det.

Se diagnossamtalet och granskningen

Relaterade guider