Aller au contenu

Google Login sur Android

GitHub

Dans ce guide, vous apprendrez à configurer Google Login avec Capgo Social Login pour Android. Je suppose que vous avez déjà lu la guide de configuration générale.

Utiliser la connexion Google sur Android

Section intitulée « Utiliser Google Login sur Android »

Dans cette partie, vous apprendrez à configurer Google Login sur Android.

  1. Créer un identifiant client Android.

    1. Cliquez sur la barre de recherche

      Barre de recherche de la Google Console
    2. Recherchez credentials et cliquez sur APIs and Services celui-ci (numéro 2 sur la capture d'écran)

      Résultats de recherche affichant l’option « Identifiants » avec « API et services » en surbrillance
    3. Cliquez sur create credentials

      Bouton « Créer des identifiants » dans la console Google
    4. Sélectionnez OAuth client ID

      Option « ID client OAuth » dans le menu de création d’identifiants
    5. Sélectionnez l’ Android type d'application

      Sélection du type d'application avec l'option Android mise en évidence
    6. Ouvrir Android Studio

    7. Tout en bas du navigateur, trouvez la Gradle Scripts

      Section Gradle Scripts dans le navigateur de projet Android Studio
    8. Trouvez build.gradle pour le module app

      le fichier build.gradle (Module: app) dans la section Gradle Scripts
    9. Copiez le android.defaultConfig.applicationId. Ce sera votre package name dans la console Google

      Fichier build.gradle montrant la configuration applicationId
    10. Ouvrez maintenant le terminal. Assurez-vous d'être dans le android dossier de votre application et lancez la commande ./gradlew signInReport

    Terminal affichant la commande gradlew signInReport
    1. Remontez en haut de cette commande. Vous devriez voir ceci. Copiez le SHA1.
    Sortie du Terminal affichant l'empreinte du certificat SHA1
    1. Maintenant, retournez à la Google Console. Saisissez votre applicationId en tant que Package Name et votre SHA1 dans le champ certificat, puis cliquez sur create
    Formulaire de création de client Android avec les champs nom de package et SHA1 remplis
  2. Créer un client web (requis pour Android)

    1. Allez sur la Create credentials page dans la Google Console

    2. Définissez le type d'application sur Web

      Sélection du type d'application avec l'option Web en surbrillance
    3. Cliquez Create

      Formulaire de création du client Web avec le bouton Créer en bas
    4. Copiez l'ID client, vous l'utiliserez comme webClientId dans votre code JS/TS

      Détails de l'ID client affichant l'ID client Web à copier
  3. Modifiez votre MainActivity

    1. Ouvrez votre application dans Android Studio. Vous pouvez exécuter cap open android

    2. Trouvez MainActivity.java

      1. Ouvrez le app dossier

        Dossier App dans le navigateur de projet Android Studio
      2. Trouvez java

        Dossier Java dans la structure du projet Android Studio
      3. Trouvez votre MainActivity.java et cliquez dessus

        Fichier MainActivity.java dans la structure du package
    3. Modifier MainActivity.java. Veuillez ajouter le code suivant

      import ee.forgr.capacitor.social.login.GoogleProvider;
      import ee.forgr.capacitor.social.login.SocialLoginPlugin;
      import ee.forgr.capacitor.social.login.ModifiedMainActivityForSocialLoginPlugin;
      import com.getcapacitor.PluginHandle;
      import com.getcapacitor.Plugin;
      import android.content.Intent;
      import android.util.Log;
      import com.getcapacitor.BridgeActivity;
      // ModifiedMainActivityForSocialLoginPlugin is VERY VERY important !!!!!!
      public class MainActivity extends BridgeActivity implements ModifiedMainActivityForSocialLoginPlugin {
      @Override
      public void onActivityResult(int requestCode, int resultCode, Intent data) {
      super.onActivityResult(requestCode, resultCode, data);
      if (requestCode >= GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MIN && requestCode < GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MAX) {
      PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
      if (pluginHandle == null) {
      Log.i("Google Activity Result", "SocialLogin login handle is null");
      return;
      }
      Plugin plugin = pluginHandle.getInstance();
      if (!(plugin instanceof SocialLoginPlugin)) {
      Log.i("Google Activity Result", "SocialLogin plugin instance is not SocialLoginPlugin");
      return;
      }
      ((SocialLoginPlugin) plugin).handleGoogleLoginIntent(requestCode, data);
      }
      }
      // This function will never be called, leave it empty
      @Override
      public void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}
      }
    4. Enregistrer le fichier

  4. Utiliser Google Login dans votre application

    1. Tout d'abord, importez SocialLogin

      import { SocialLogin } from '@capgo/capacitor-social-login';
    2. Appelez initialize. Cette méthode ne doit être appelée qu'une seule fois.

      // onMounted is Vue specific
      // webClientId is the client ID you got in the web client creation step not the android client ID.
      onMounted(() => {
      SocialLogin.initialize({
      google: {
      webClientId: '673324426943-avl4v9ubdas7a0u7igf7in03pdj1dkmg.apps.googleusercontent.com',
      }
      })
      })
    3. Appelez SocialLogin.login. Créez un bouton et exécutez le code suivant au clic.

      const res = await SocialLogin.login({
      provider: 'google',
      options: {}
      })
      // handle the response
      console.log(JSON.stringify(res))
  5. Configurez l'émulateur pour les tests

    1. Allez dans Device manager et cliquez sur le bouton plus

      Device Manager dans Android Studio avec le bouton plus mis en évidence
    2. Créez un appareil virtuel

      Bouton Create Virtual Device dans la configuration de l'appareil virtuel
    3. Sélectionnez n'importe quel appareil avec une Play Store icône

      Sélection du matériel montrant les appareils compatibles Play Store

      Comme vous pouvez le voir, pixel 8 prend en charge les Play Store services

    4. Cliquez next

      Bouton Suivant dans l’assistant de création d’appareil
    5. Assurez-vous que l’image système est de type Google Play. ELLE DOIT être de type Google Play

      Sélection d’image système affichant les images de type Google Play
    6. Click next

      Bouton Suivant de l’écran de sélection d’image système
    7. Confirmez votre appareil. Vous pouvez nommer votre émulateur comme vous le souhaitez

      Écran de vérification de la configuration de l’appareil avec bouton Terminer
    8. Allez dans Device Manager et lancez votre simulateur

      Gestionnaire d'appareils avec un appareil virtuel listé et un bouton Play
    9. Une fois le simulateur démarré, allez dans ses paramètres

      Émulateur Android affichant l'application Paramètres
    10. Allez dans Google Play

    Écran des paramètres avec l'option Google Play
    1. Cliquez Update et attendez environ 60 secondes
    Écran de mise à jour Google Play avec bouton Update
  6. Testez votre application

    Si vous avez tout fait correctement, vous devriez voir le flux de connexion Google fonctionner correctement :

    Démo du flux de connexion Google sur Android montrant le processus de connexion et l'authentification réussie

En cas de problème, comparez d’abord la configuration de votre app avec les valeurs de la Google Cloud Console. Les échecs de connexion Google sur Android viennent généralement d’un nom de package, d’un SHA-1 ou d’un client ID qui ne correspondent pas.

Sur Android, ce plugin utilise Google Credential Manager (androidx.credentials et Sign in with Google), et non l’ancien GoogleSignInClient API. Les erreurs Logcat du type GetCredentialCustomException: [28444] Developer console is not set up correctly viennent de cette pile.

Filtrez Logcat avec GoogleProvider ou CapgoSocialLogin après un échec de connexion. Le plugin journalise votre nom de package, votre SHA-1 de signature et un webClientId afin de pouvoir les comparer avec Google Cloud Console.

Vous avez besoin de deux types d'ID client OAuth 2.0 dans le même projet Google Cloud :

Type de clientUsageUtilisation
Application webAudience du serveur / ID tokenwebClientId dans SocialLogin.initialize()
Android, un par clé de signatureProuve que votre APK est autorisé à appeler GoogleConsole Google Cloud uniquement. Ne transmettez pas cet ID à webClientId

Une erreur fréquente consiste à utiliser l’identifiant client Android comme webClientId. Credential Manager nécessite l’ID de client Web. Le client Android n’a besoin que du nom de package correct et du SHA-1 enregistrés dans la console.

Créez un client OAuth Android pour chaque certificat qui signe les builds que vous testez :

  • Debug : depuis ./gradlew signingReport pour la variante debug.
  • Release : depuis l’APK ou l’AAB que vous installez réellement.
  • Play App Signing : depuis Play Console > App integrity > App signing key certificate. C’est obligatoire pour les builds Play Store, même si le SHA-1 de votre clé d’upload est déjà enregistré.

Le applicationId dans android/app/build.gradle doit correspondre exactement au nom de package du client OAuth Android, y compris tout .debug suffixe.

Si l'écran de consentement OAuth est en mode test, ajoutez tous les comptes Google utilisés pour les tests sous Audience > Test users. La publication de l'application en Production n'est pas requise pour email et profile les scopes. Digital Asset Links (assetlinks.json) ne sont pas requis pour la connexion avec Google via Credential Manager.

Les modifications sur Google Cloud peuvent mettre quelques heures à se propager.

Erreur 28444 : la console développeur est mal configurée

Section intitulée « Erreur 28444 : la console développeur est mal configurée »

Cela signifie presque toujours que Google a rejeté la combinaison du certificat de signature de l'APK installé, du nom du package et de webClientId. Suivez cette checklist :

  1. Confirmer webClientId est l'ID client de l'application Web et se termine par .apps.googleusercontent.com.
  2. Lancez l'app, reproduisez l'échec et consultez Logcat pour GoogleProvider, signingSha1=, et package=.
  3. Dans Google Cloud Console > Identifiants, ouvrez votre client OAuth Android et vérifiez le nom de package et la SHA-1 exacts.
  4. Si vous testez un build de release, enregistrez la SHA-1 de ce build, pas seulement celle du keystore de debug.
  5. Si l’app est distribuée via Play Store, enregistrez également la SHA-1 de Play App Signing.
  6. Assurez-vous que les clients Web et Android appartiennent au même projet Google Cloud.
  7. Si l’écran de consentement est en mode test, vérifiez que le compte Google est un utilisateur de test.
  8. Wait and retry after console changes.

USER_CANCELLED Après avoir sélectionné un compte sur un build de debug mal configuré, il peut s’agir d’une incompatibilité SHA-1 ou d’identifiant client. Corrigez d’abord la configuration de la console ci-dessus.

Extraire le SHA-1 du build que vous installez

Section intitulée « Extraire la SHA-1 du build installé »

Builds de debug ou locaux :

Fenêtre de terminal
cd android && ./gradlew signingReport

APK de release signé :

Fenêtre de terminal
keytool -printcert -jarfile android/app/release/app-release.apk

Ajoutez ce SHA-1 à un client OAuth Android avec le nom de package correspondant, réinstallez le même APK signé et testez à nouveau :

Fenêtre de terminal
adb install android/app/release/app-release.apk

Les tokens sont imbriqués sous result:

const login = await SocialLogin.login({ provider: 'google' });
const idToken = login.result?.idToken;

Pour Firebase Auth, créez des identifiants avec celui-ci idToken et utilisez l’ID de client Web comme webClientId dans initialize.

Si vous ne parvenez pas à obtenir le certificat SHA-1 de développement, essayez un keystore personnalisé. Ce commentaire sur l’issue explique comment ajouter un keystore à votre projet.

Si vous utilisez 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.