Google-Anmelden auf Android

Ein Setup-Prompt mit den Installations-Schritten und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

Einführung

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

In diesem Teil lernen Sie, wie Sie Google-Anmeldung in Android einrichten können.

Das Android-SHA1-Zertifikat ist sehr mühsam und ich möchte es niemandem zumuten, dies aufzustellen. Die folgenden Schritte gehen davon aus, dass sich die App nicht im Google Play Store befindet und nur auf dem lokalen Simulator oder dem Entwicklungshardwaregerät verwendet wird. Wenn Sie Ihre App im Google Play Store veröffentlicht haben,

Vorsicht MUSSEN Sie einen zusätzlichen Android-Kunden ID hinzufügen, der den SHA1 aus dem Google Play-Konsolen für Produktionsausgaben enthält. Sie können den SHA1-Hash finden, den Google Play verwendet, um Ihre Release-Paket zu signieren unter Schließlich ist es 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 mit der Einrichtung kämpfen, schauen Sie bitte auf die Test and release > Setup > App Signing.

__CAPGO_KEEP_0__ Probleme Github issues.

Google Login-Einrichtung für Android für weitere Informationen. Hinweis

Klicken Sie auf die Suchleiste
1. Klicken Sie auf die Suchleiste
2. Suchen Sie nach credentials und klicken Sie auf das APIs and Services das eine (Nummer 2 auf dem Screenshot)
3. Klicken Sie auf das create credentials
4. Wählen Sie OAuth client ID
5. Wählen Sie die Android Anwendungstyp
6. Open Android Studio
7. Am unteren Ende des Navigators finden Sie die Gradle Scripts
8. Finden build.gradle für das Modul app
9. Kopieren Sie die android.defaultConfig.applicationIdDies wird Ihre package name im Google-Konsolen
10. Now, öffnen Sie die Terminal-Anwendung. Stellen Sie sicher, dass Sie sich im android Ordner Ihres Apps befinden und das Kommando ausführen ./gradlew signInReport
1. Scrollen Sie zur Anfangszeile dieses Befehls. Sie sollten Folgendes sehen. Kopieren Sie SHA1.
1. Gehe nun zurück zur Google-Konsole. Geben Sie Ihren applicationId als Package Name und Ihren SHA1 in das Zertifikatsfeld ein und klicken Sie create
Erstelle einen Web-Client (dies ist erforderlich für Android)
1. Gehe zur Create credentials Seite in der Google-Konsole
2. Setze Anwendungstyp auf Web
3. Klicken Sie Create
4. Die Client-ID kopieren, Sie verwenden diese als webClientId in Ihrem JS/TS code

Anpassen Sie Ihr MainActivity

Bitte öffnen Sie Ihr App-Projekt in Android Studio. Sie können es cap open android
Finden MainActivity.java
1. Öffnen Sie das app Ordner
2. Finden java
3. Finden Sie Ihren MainActivity.java und klicken Sie darauf

Ändern Sie MainActivity.java. Bitte fügen Sie den 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() {}
}

Speichern Sie die Datei

Verwenden Sie Google-Login in Ihrer Anwendung
1. Zuerst importieren Sie SocialLogin
```
import { SocialLogin } from '@capgo/capacitor-social-login';
```
2. Rufen Sie initialize auf. 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. Aufrufen SocialLogin.login. Erstelle einen Button und führe folgenden code bei Klick aus.
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response
console.log(JSON.stringify(res))
```
  Wenn Sie Google mit mode: 'offline', SocialLogin.login() returns serverAuthCode für Ihren Backend-Austauschfluss. Rufen Sie nicht SocialLogin.refresh({ provider: 'google' }) in der App in diesem Modus auf. Austauschen serverAuthCode auf Ihrem Backend, speichern Sie den Google-Refresh-Token dort und aktualisieren Sie ihn auf dem Backend.
Konfigurieren Sie den Emulator für die Testung
1. Gehe in und klicke auf die Plus-Taste Device manager und klicke auf die Plus-Taste
2. Erstelle einen virtuellen Gerät
3. Wähle jedes Gerät mit einem Play Store Icon
  
  Wie du siehst, unterstützt das pixel 8 die Play Store Dienste
4. Klicke next
5. Stellen Sie sicher, dass das Betriebssystem-Image vom Typ Google Play. MUSSEN von Typ Google Play
6. Klicken Sie auf Weiter
7. Bestätigen Sie Ihr Gerät. Sie können Ihrem Emulator einen Namen geben, wie Sie ihn bevorzugen
8. Gehe in Device Manager und starte Ihr Simulator
9. Nachdem sich der Simulator gestartet hat, gehen Sie in seine Einstellungen
10. Gehen Sie in Google Play
1. Klicken Sie Update und warten Sie etwa 60 Sekunden
Testen Sie Ihre Anwendung

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

Fehlerbehebung

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

Zugriffsmanager, SHA-1 und Firebase

Bei Android verwendet dieses Plugin den Google-Zugriffsmanager (androidx.credentials und Anmelden mit Google), nicht das veraltete GoogleSignInClient API. Logcat-Fehler wie GetCredentialCustomException: [28444] Developer console is not set up correctly kommen von diesem Stapel.

Filtern Sie Logcat mit GoogleProvider oder CapgoSocialLogin nach einem fehlgeschlagenen Login. Das Plugin loggt Ihren Paketnamen, Ihre Signierungs-SHA-1 und eine maskierte webClientId damit Sie sie gegen die Werte im Google Cloud Console vergleichen können.

Benötigte Google-Cloud-Einrichtung

Sie benötigen zwei Arten von OAuth 2.0-Kundenidentitäten in demselben Google Cloud-Projekt:

Client-Typ	Wird verwendet	Wo es hingeht
Webanwendung	Server / Zielgruppe für ID-Token	`webClientId` in `SocialLogin.initialize()`
Bei Android, eine pro Signierungskey	Beweist, dass Ihr APK berechtigt ist, Google zu rufen	Nur in der Google Cloud Console. Passen Sie diesen ID nicht an `webClientId`

Ein häufiger Fehler ist die Verwendung des Android-Kundenidentitäts als webClientIdDer Credential Manager erfordert den Webclient-Id dort.

Erstellen Sie einen Android OAuth-Kunden für jede Zertifikat, das Builds testet:

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

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

Wenn die OAuth-Zustimmungsanzeige in der Testmodus ist, fügen Sie jeden Google-Konto hinzu, das Sie testen, unter Zielgruppe > Testnutzer. Die Veröffentlichung der App in die Produktion ist nicht erforderlich für email und profile scopes. Digitale Asset Links (assetlinks.json) sind nicht erforderlich für das Anmelden mit Google über den Credential Manager.

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

Fehler 28444: Entwickler-Konsol ist nicht korrekt eingerichtet

Das bedeutet in der Regel, dass Google die Combination des installierten APK-Signierungszertifikats, des Paketnamens und webClientIdArbeiten Sie durch diese Liste ab:

Bestätigen webClientId ist die Webanwendungsklienten-ID und endet mit .apps.googleusercontent.com.
Führen Sie das App, reproduzieren Sie das Versagen und lesen Sie Logcat für GoogleProvider, signingSha1=, und package=.
In Google Cloud Console > Zertifikate, öffnen Sie Ihren Android-OAuth-Klienten und überprüfen Sie die genaue Paketname und SHA-1.
Wenn Sie ein Release-Build testen, registrieren Sie den SHA-1 von diesem Build, nicht nur den Debug-Keystore.
Wenn die App über den Play Store verteilt wird, registrieren Sie auch den Play App Signing SHA-1.
Stellen Sie sicher, dass Web- und Android-Klienten sich im gleichen Google Cloud-Projekt befinden.
Wenn die Einwilligungsschleife auf Testing steht, bestätigen Sie, dass die Google-Konto ein Testkonto ist.
Warten und nach Änderungen im Konsole erneut versuchen.

USER_CANCELLED Nachdem Sie auf einem fehlerhaft konfigurierten Debug-Build eine Konto ausgewählt haben, kann es immer noch ein SHA-1- oder Client-ID-Mismatch geben. Beheben Sie die Konsole-Einstellungen oben zuerst.

SHA-1 aus dem installierten Build extrahieren

Debug- oder lokale Builds:

cd android && ./gradlew signingReport

Signiertes Release-APK:

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

Fügen Sie die SHA-1 an einem Android OAuth-Klienten mit dem entsprechenden Paketnamen hinzu, installieren Sie das gleiche signierte APK erneut und testen Sie es erneut:

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

Token sind 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-Kunden-ID als webClientId in initialize.

Wenn Sie das Entwicklungs-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 zum Planen der Authentifizierung und der Kontoflows verwenden, verbinden Sie es mit Mit @capgo/capacitor-social-login für die native Fähigkeit in Mit @capgo/capacitor-social-login, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails in Zwei-Faktor-Authentifizierung.