Google-Login auf Android

GitHub

Eine Einrichtungsvorlage mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin kopieren.

Einführung

In dieser Anleitung lernen Sie, wie Sie Google-Login mit Capgo Social Login für Android einrichten. Ich gehe davon aus, dass Sie bereits die allgemeine Einrichtungsanleitung.

In diesem Abschnitt lernen Sie, wie Sie Google-Anmeldung in Android einrichten.

Die Android-Zertifikats-HASH1 ist ein Albtraum und ich möchte es niemandem wünschen, dies aufzustellen. Die folgenden Schritte gehen davon aus, dass die einfachste Szenario eines Apps ist, die nicht im Google Play Store veröffentlicht wurde und nur von der lokalen Simulator oder Entwicklungshardware-Gerät verwendet wird.

Wenn Sie Ihre App im Google Play Store veröffentlicht haben, Sie MUSSEN eine zusätzliche Android-Kunden-ID hinzufügen, die den SHA1 aus dem Google Play Console für Produktionsausgaben enthält. Sie können die SHA1-HASH finden, die Google Play verwendet, um Ihre Release-Bundle zu signieren, unter Test and release > Setup > App Signing.

Es ist wichtig zu erwähnen, dass, wenn Sie Fehler machen, der Fehler NICHT offensichtlich sein wird. Es kann sehr schwierig sein, ihn zu debuggen. Wenn Sie Schwierigkeiten mit der Einrichtung haben, schauen Sie bitte in die Github Probleme.

Zusätzlich können Sie die Fehlerbehebungsabschnitt des Google-Anmeldung für Android für weitere Informationen.

Eine Android-Kunden-ID erstellen.
1. Klicken Sie auf die Suchleiste
2. Nach suchen credentials und klicken Sie auf die APIs and Services eine (Nummer 2 auf dem Screenshot)
3. Klicken Sie auf die create credentials
4. Wählen Sie OAuth client ID
5. Wählen Sie die Android Anwendungstyp
6. Öffnen Sie Android Studio
7. Am unteren Ende des Navigators finden Sie die Gradle Scripts
8. Finden Sie build.gradle für das Modul app
9. Kopieren Sie den android.defaultConfig.applicationIdDies wird Ihr package name im Google-Konsolen
10. Öffnen Sie nun das Terminal. Stellen Sie sicher, dass Sie sich im Verzeichnis Ihres Apps befinden und führen Sie android Terminal-Anzeige mit dem Befehl gradlew signInReport ./gradlew signInReport
1. Terminal-Ausgabe mit dem SHA1-Zertifikatsfingerprint SHA1.
1. als applicationId und Ihren SHA1 in das Zertifikatsfeld ein und klicken Sie Package Name and your SHA1 in the certificate field and click create
Erstellen Sie einen Webclient (dies ist erforderlich für Android)
1. Gehe zur Create credentials Seite im Google-Konsolen
2. Setze die Anwendungsart auf Web
3. Klicken Sie auf Create
4. Kopieren Sie die Client-ID, Sie verwenden diese als webClientId in Ihrem JS/TS code

Passen Sie Ihre MainActivity

Öffnen Sie bitte Ihre App in Android Studio. Sie können es ausführen cap open android
Finden Sie MainActivity.java
1. Öffnen Sie das app Ordner
2. Finden Sie java
3. Finden Sie Ihren MainActivity.java und klicken Sie darauf

Ändern Sie MainActivity.javaBitte fügen Sie folgenden code hinzu

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() {}
}

Speichere das Datei

Verwende Google-Anmeldung in deiner Anwendung
1. Zuerst importiere SocialLogin
```
import { SocialLogin } from '@capgo/capacitor-social-login';
```
2. Rufe initialize. Dies sollte nur einmal aufgerufen werden.
```
// 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. Rufe SocialLogin.login. Create a button and run the following code on click.
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response
console.log(JSON.stringify(res))
```
  If Sie Google initialisieren mit mode: 'offline', SocialLogin.login() returns serverAuthCode für Ihren Backend-Austausch-Flow. Rufen Sie in der App in diesem Modus nicht auf. Austauschen Sie SocialLogin.refresh({ provider: 'google' }) auf Ihrem Backend, speichern Sie den Google-Refresh-Token dort und aktualisieren Sie ihn auf dem Backend. serverAuthCode Konfigurieren Sie den Emulator für die Testung
Gehe in
1. und klicke auf die Plus-Taste Device manager Gerätemanager in Android Studio mit Plus-Taste hervorgehoben
2. Schaltfläche zum Erstellen eines virtuellen Geräts in der virtuellen Geräte-Konfiguration
3. refresh token Play Store icon
  
  Wie Sie sehen können, der pixel 8 die Play Store Dienste
4. Klicken Sie next
5. Stellen Sie sicher, dass das Betriebssystem-Image vom Typ Google Play. MUSSEN muss vom Typ Google Play
6. Klicken Sie auf Nächster Schritt
7. Bestätigen Sie Ihr Gerät. Sie können Ihrem Emulator einen Namen geben, wie Sie möchten
8. Gehe in Device Manager und starte Ihren Simulator
9. Nachdem der Simulator gestartet ist, gehe in seine Einstellungen
10. Gehe in Google Play
1. Klicken Update und warten Sie etwa 60 Sekunden
Testen Sie Ihre Anwendung

Wenn Sie alles richtig gemacht haben, sollten Sie das Google-Login-Flow korrekt funktionieren sehen:

Problembehandlung

Wenn Sie Probleme haben, vergleichen Sie zunächst Ihre App-Konfiguration mit den Werten im Google Cloud Console. Android-Google-Sign-In-Fehler werden normalerweise durch einen Paketnamen, eine SHA-1- oder ein Client-ID-Missmatch verursacht.

Zertifikatsmanager, SHA-1 und Firebase

Bei Android wird dieser Plugin Google-Zertifikatsmanager (androidx.credentials und Anmelden mit Google) verwendet, nicht der legacy GoogleSignInClient API. Logcat-Fehler wie GetCredentialCustomException: [28444] Developer console is not set up correctly kommen aus dieser Stapel.

Filtern Sie Logcat mit GoogleProvider oder CapgoSocialLogin oder webClientId oder

oder

oder	oder	oder
Sie benötigen zwei Arten von OAuth 2.0-Kundenidentitäten in demselben Google Cloud-Projekt:	Server / Zielgruppe für ID-Token	`webClientId` in `SocialLogin.initialize()`
für Android, eine pro Signierungskey	Stellt sicher, dass Ihr APK berechtigt ist, Google zu aufrufen	nur in der Google Cloud Console. Geben Sie diesen ID nicht weiter `webClientId`

Eine häufige Fehlinterpretation ist die Verwendung des Android-Client-IDs webClientId. Der Credential Manager erfordert dort den Web-Client-IDs. Der Android-Client benötigt nur den korrekten Paketnamen und die SHA-1 im Console registriert.

Erstellen Sie einen Android OAuth Client für jede Zertifikat, das Ihre Builds signiert:

Debug: von ./gradlew signingReport für die Debug-Variante.
Release: von dem APK oder AAB, das Sie tatsächlich installieren.
Play App Signing: von der Play Console > App-Integrität > App-Zertifikat für Signierungskey. Dies ist erforderlich für Play Store Builds, auch wenn Ihr Upload-Key SHA-1 bereits registriert ist.

Die applicationId in android/app/build.gradle muss genau dem Android OAuth-Kundenpaketnamen entsprechen, einschließlich jeder .debug Suffix.

Wenn die OAuth-Konsent-Schaltfläche im Testmodus ist, fügen Sie alle Google-Konten hinzu, die Sie unter Benutzergruppe > Testnutzer testen. email und profile Zugriffsrechte. Digitale Asset Links (assetlinks.json) sind für die Anmeldung mit Google über den Credential Manager nicht erforderlich.

Google Cloud-Änderungen können bis zu einige Stunden dauern, um sich zu verbreiten.

Fehler 28444: Entwicklerkonsol ist nicht korrekt eingerichtet

Das bedeutet in der Regel, dass Google die Combination von installiertem APK-Signierungszertifikat, Paketname und webClientId. Arbeiten Sie durch diese Liste:

Bestätigen webClientId ist die Client-ID der Webanwendung und endet mit .apps.googleusercontent.com.
Führen Sie das Programm aus, reproduzieren Sie das Problem und lesen Sie Logcat für GoogleProvider, signingSha1=, und package=.
In Google Cloud Console > Zertifikate, öffnen Sie Ihren Android OAuth-Kunden und überprüfen Sie den genauen Paketnamen und die SHA-1.
Wenn Sie ein Release-Build testen, registrieren Sie die SHA-1 aus diesem Build, nicht nur den Debug-Keystore.
Wenn das Programm über den Play Store verteilt wird, registrieren Sie auch die Play App Signing SHA-1.
Stellen Sie sicher, dass Web- und Android-Clients im gleichen Google Cloud-Projekt leben.
Wenn sich die Einwilligungsschleife im Testmodus befindet, bestätigen Sie, dass die Google-Konto ein Testkonto ist.
Warte und versuche es erneut nach Änderungen im Konsole.

USER_CANCELLED Nachdem du auf einem fehlerhaft konfigurierten Debug-Build ein Konto ausgewählt hast, kann es immer noch zu einem SHA-1- oder Client-ID-Mismatch kommen. Behebe die Konsole-Einstellungen oben zuerst.

Entscheide den SHA-1-Wert aus der installierten Build.

Debug- oder lokale Builds:

cd android && ./gradlew signingReport

Signierter Release-APK:

keytool -printcert -jarfile android/app/release/app-release.apk

Füge den SHA-1-Wert zu einem Android OAuth-Kunden hinzu, der dem entsprechenden Paketnamen entspricht, installiere erneut denselben signierten APK und testiere erneut:

adb install android/app/release/app-release.apk

Token sind untergeordnet unter result:

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

Für Firebase Auth, erstellen Sie mit diesem die Anmeldeinformationen idToken und verwenden Sie den Web-Client-Id als webClientId in initialize.

Wenn Sie das Entwickler-SHA-1-Zertifikat nicht erhalten können, versuchen Sie einen benutzerdefinierten Keystore. Dieser Issue-Kommentar erklärt, wie Sie einen Keystore zu Ihrem Projekt hinzufügen können.

Wenn Sie Google Login auf Android für die Planung der Authentifizierung und der Kontoflows verwenden, verbinden Sie es mit Verwenden Sie @capgo/capacitor-social-login für die native Fähigkeit in Verwenden Sie @capgo/capacitor-social-login Verwenden Sie @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login Verwenden Sie @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey Verwenden Sie @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric und Zweifaktor-Authentifizierung für die Implementierungsdetails in Zweifaktor-Authentifizierung.

Google-Login auf Android

Einführung