Erste Schritte

Überblick

Capacitor-Community-Plugin für Facebook Login und Facebook App Events unter Android, iOS und im Web. Es kapselt die nativen Meta-SDKs unter Android und iOS sowie das Facebook JavaScript SDK im Web.

Installation

Dieses Plugin richtet sich an Capacitor 8, iOS ab 15 und Android API ab 24. Es deklariert die nativen Facebook-SDK-Abhängigkeiten sowohl für CocoaPods als auch für Swift Package Manager.

npm install @capacitor-community/facebook-login
npx cap sync

Installieren Sie die Plugin-Hauptversion, die zu Ihrer Capacitor-Hauptversion passt.

Schließen Sie vor dem Aufruf des Plugins die erforderliche native und Web-Einrichtung unter Konfiguration ab.

Die erste Anmeldung mit E-Mail-Berechtigung

Rufen Sie nach Installation und Konfiguration login aus einer Nutzeraktion wie einem Schaltflächenklick auf. Fordern Sie für die erste Prüfung ausschließlich email an:

import { FacebookLogin } from '@capacitor-community/facebook-login';

async function onLoginClick() {
  const result = await FacebookLogin.login({ permissions: ['email'] });

  if (result.accessToken) {
    console.log('Facebook login succeeded.');
  } else {
    console.log('Facebook login canceled or returned no token.');
  }
}

Erwartetes Ergebnis: Bei Erfolg wird mit einem Objekt accessToken aufgelöst. Protokollieren Sie die rohe Token-Zeichenfolge nicht. Ein Abbruch unter Android und iOS wird ohne Token aufgelöst. Im Web wird eine fehlgeschlagene Anmeldung stattdessen zurückgewiesen.

iOS Limited Login gibt ein OIDC-Authentifizierungstoken (JWT) zurück, kein Graph-API-Zugriffstoken. Ein Profilabruf über Graph benötigt andere Token-Voraussetzungen. Siehe Authentifizierung.

Dokumentation

Beginnen Sie mit Konfiguration und verwenden Sie anschließend die Anleitung für die implementierte Funktion. Methodensignaturen und generierte Typinformationen stehen weiterhin im folgenden API-Abschnitt.

• Konfiguration — Meta-App-Einstellungen und Android-, iOS-
  sowie Web-SDK-Einrichtung.
• Authentifizierung — Anmeldung, Abmeldung, aktuelle Tokens,
  Profilfelder, erneute Autorisierung und Plattformunterschiede.
• App Events — eigene Ereignisse, Parameter, automatische Ereignis-
  protokollierung und Einstellungen für Werbetreibende.