Firebase Google Login sur Android

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.

Introduction

Ce guide vous aidera à intégrer Google Sign-In avec Firebase Authentication sur Android. Je pars du principe que vous avez déjà terminé le configuration générale de Google avec Firebase

Setup Steps

Accédez à la vue d'ensemble de votre projet sur console.cloud.google.com
Cliquez sur Add app bouton

Il se peut que vous deviez chercher ce bouton ici. Cela ne s'applique que si vous avez déjà créé une autre application dans la console Firebase.
Sélectionnez Android
Remplissez la première partie du formulaire
1. Remplissez le Android package name
  1. Ouvrez votre application dans Android Studio avec npx cap open android
  2. Tout en bas du navigateur, trouvez la Gradle Scripts
  3. Trouvez build.gradle pour le module app
  4. Copiez le android.defaultConfig.applicationId. Ce sera votre package name dans la console Firebase
  L'ID affiché ici différera de celui que j'utiliserai pour le reste du guide. J'utiliserai app.capgo.plugin.SocialLogin pour le reste du guide.
  1. Collez-le dans la console Firebase
2. Cliquez sur Register app bouton
Ignorez le Download and then add config file étape
Ignorez le Add firebase SDK étape
Cliquez sur Continue to console bouton
Si l'authentification ne se fait pas automatiquement, allez sur settings -> general -> your apps -> trouvez votre application Android et cliquez dessus
Récupérez votre empreinte SHA1

Suivez les étapes 10-11 du guide de configuration Google Login pour Android:
1. Ouvrez maintenant le terminal. Assurez-vous d'être dans le android dossier de votre application et lancez la commande ./gradlew signInReport
2. Remontez en haut de cette commande. Vous devriez voir ceci. Copiez le SHA1.
J'utiliserai un SHA1 légèrement différent pour la suite du guide, car j'ai changé d'ordinateur depuis la rédaction du guide de configuration Google Login pour Android.

Le SHA1 est crucial. Si vous vous trompez, l'authentification échouera de manière imprévisible. Veuillez LIRE LE GUIDE DE CONFIGURATION GOOGLE LOGIN POUR ANDROID pour ne pas vous tromper.
Ajoutez le SHA1 au projet Firebase
1. Cliquez sur Add fingerprint bouton
2. Collez le SHA1 copié à l'étape précédente
3. Cliquez sur Save bouton
Récupérez votre ID client web
1. Accéder à Build -> Authentication
2. Cliquez sur Sign-in method bouton
3. Cliquez sur Google fournisseur
4. Cliquez sur Web SDK configuration bouton
5. Copiez le Web client ID. Ce sera votre webClientId dans l' initialize méthode du plugin.
Utilisez l'ID client web dans le JS.

Je recommande d'utiliser la authenticateWithGoogle fonction utilitaire disponible dans authUtils.ts du fichier de l'application d'exemple.

À ce stade, vous êtes TECHNIQUEMENT prêt à utiliser Google Sign-In avec Firebase Authentication sur Android. Cependant, je vous recommande de revérifier la configuration dans la console Google Cloud, comme expliqué à l'étape suivante.

Revérifier la configuration dans la console Google Cloud

Pour vous assurer que la configuration est correcte, vous devriez vérifier à nouveau les paramètres dans la console Google Cloud.

Accéder à console.cloud.google.com
Trouvez votre projet
1. Cliquez sur le sélecteur de projet
2. Recherchez votre projet en saisissant le nom exact de votre projet Firebase, puis cliquez dessus. Dans mon cas, il s'agit de sociallogin-tutorial-app.
Ouvrez la barre de recherche et ouvrez credentials
1. Ouvrez la barre de recherche
2. Recherchez credentials et cliquez sur APIs and Services celui-ci (numéro 2 sur la capture d'écran)
Vérifiez que les client IDs Android et Web apparaissent bien dans la liste.

Si vous ne voyez pas les ID client Android et Web dans la liste, vous avez fait une erreur lors de la configuration. Revenez en arrière et vérifiez vos étapes.
Il est aussi possible, et cela m'est déjà arrivé, que vous ayez déjà ajouté le hash SHA1 Android avec le même app ID dans un autre projet. Firebase ne pourra alors pas créer de client ID Android. Dans ce cas, vous devrez supprimer le SHA1 de l'autre projet ainsi que sur Firebase (via la console Firebase pour supprimer l'app Android) et le recréer sur Firebase.
Vérifiez que le client ID Android est correctement configuré dans la console Firebase.
1. Cliquez sur Android application
2. Confirmez que le hash SHA1 est correctement configuré et qu'il correspond à celui que vous avez copié lors des étapes précédentes.
Vérifiez que le client ID Web est correctement configuré dans la console Firebase.
1. Cliquez sur Web application
2. Vérifiez que l'ID client correspond à celui que vous avez copié lors des étapes précédentes.
Veuillez ignorer le reste des paramètres du client web. Nous en discuterons dans la guide de configuration web.

Et voilà ! Vous êtes maintenant prêt à utiliser Google Sign-In avec Firebase Authentication sur Android.

Troubleshooting

Si l'authentification bloque ou échoue :

Vérifier l' idToken l'audience correspond à votre ID client web Firebase
Vérifiez que Google Sign-In est activé dans la console Firebase
Assurez-vous que l'empreinte SHA-1 est correctement configurée
Consultez l’ exemple d’application code pour référence

Si vous utilisez Firebase Google Login sur Android pour planifier les flux d'authentification et de compte, le connecter à Utiliser @capgo/capacitor-social-login pour la capacité native dans Utiliser @capgo/capacitor-social-login @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, et Authentification à deux facteurs pour les détails d'implémentation de l'authentification à deux facteurs.