Premiers pas

Vue d’ensemble

Plugin communautaire Capacitor pour Facebook Login et Facebook App Events sur
Android, iOS et le Web. Il encapsule les SDK Meta natifs sur Android et iOS, ainsi que
le SDK JavaScript Facebook sur le Web.

Installation

Ce plugin cible Capacitor 8, iOS 15 ou une version ultérieure, et Android API 24 ou une version ultérieure.
Il déclare les dépendances du SDK Facebook natif pour CocoaPods et Swift
Package Manager.

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

Installez la version majeure du plugin correspondant à celle de Capacitor.

Effectuez la configuration native et Web requise décrite dans
Configuration avant d’appeler le plugin.

Première connexion avec l’e-mail

Après l’installation et la configuration,
appelez login depuis une action utilisateur, comme un clic sur un bouton. Demandez uniquement email pour
ce premier essai :

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.');
  }
}

Résultat attendu : en cas de réussite, l’appel se résout avec un objet accessToken ; ne journalisez pas
la chaîne brute du jeton. Une annulation sur Android ou iOS se résout sans jeton. Sur
le Web, une connexion échouée rejette l’appel.

Limited Login sur iOS renvoie un jeton d’authentification OIDC (JWT), et non un jeton d’accès à
l’API Graph. L’accès au profil via Graph nécessite d’autres conditions de jeton ; consultez
Authentification.

Documentation

Commencez par Configuration, puis utilisez le guide de la
fonctionnalité que vous mettez en œuvre. Les signatures des méthodes et les informations de types générées
restent dans la section API ci-dessous.

• Configuration — paramètres de l’application Meta et configuration des SDK Android, iOS
  et Web.
• Authentification — connexion, déconnexion, jetons courants,
  champs du profil, réautorisation et différences entre plateformes.
• Événements de l’application — événements personnalisés, paramètres, enregistrement automatique
  des événements et paramètres publicitaires.