AndroidでのGoogle Login
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
はじめに
セクション「はじめに」このガイドでは、Android向けの Capgo Social Loginを使ってGoogle Loginをセットアップする方法を説明します。 すでに以下を読んでいることを前提としています。 一般的なセットアップガイド.
AndroidでGoogleログインを使う
「AndroidでのGoogle Loginの使用」というセクションこのパートでは、AndroidでGoogle Loginをセットアップする方法を説明します。
-
Android クライアント ID を作成する
-
検索バーをクリックします
-
を検索し、
credentials次をクリックします:APIs and Services該当の項目(スクリーンショットの番号2)
-
次の
create credentials
-
選択します
OAuth client ID
-
次の
Androidアプリケーションの種類
-
Android Studio を開く
-
ナビゲーターの最下部で、以下を見つけてください
Gradle Scripts
-
次を探して、
build.gradleモジュール用のapp
-
以下をコピー
android.defaultConfig.applicationId. これがあなたのpackage nameGoogle コンソールで
-
次に、ターミナルを開いてください。次のディレクトリにいることを確認してください:
androidアプリのフォルダに移動して実行します./gradlew signInReport
- このコマンドの先頭までスクロールしてください。次のように表示されるはずです。これをコピーして
SHA1.
- 次に、Google Console に戻ります。以下を入力してください
applicationIdをPackage Nameとして入力し、SHA1 も証明書フィールドに入力してクリックしますcreate
-
-
Web クライアントを作成する(Android にはこれが必要です)
-
以下にアクセスしてください:
Create credentialsGoogle Console のページ -
アプリケーションの種類を以下に設定
Web
-
クリック
Create
-
クライアントIDをコピーします。これを
webClientIdJS/TS の code 内で
-
-
以下の内容を含めるように
MainActivity-
Android Studio でアプリを開いてください。実行できます
cap open android -
次を探して、
MainActivity.java-
次を開きます:
appフォルダ
-
次を探して、
java
-
次を探します
MainActivity.javaをクリックします
-
-
変更
MainActivity.java。以下を code に追加してください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 {@Overridepublic 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@Overridepublic void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}} -
ファイルを保存してください
-
-
アプリケーションで Google Login を使用する
-
まず、インポートします
SocialLoginimport { SocialLogin } from '@capgo/capacitor-social-login'; -
initialize を呼び出します。一度だけ呼び出す必要があります。
// 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',}})}) -
呼び出す
SocialLogin.login。ボタンを作成し、クリック時に以下の code を実行します。const res = await SocialLogin.login({provider: 'google',options: {}})// handle the responseconsole.log(JSON.stringify(res))
-
-
テスト用にエミュレータを設定
-
〜を開きます
Device managerプラスボタンをクリック
-
仮想デバイスを作成
-
アイコンが付いた任意のデバイスを選択
Play Storeアイコン
ご覧のとおり、
pixel 8をサポートしますPlay Storeサービス -
クリック
next
-
OSイメージのタイプが
Google Play. 必ず タイプGoogle Play
-
次へをクリック
-
デバイスを確認してください。エミュレータの名前は任意で設定できます
-
〜を開きます
Device Managerシミュレータを起動してください
-
シミュレーターが起動したら、設定を開きます
-
〜を開きます
Google Play
- クリック
Updateそのまま60秒ほど待ちます
-
-
アプリケーションのテスト
手順通りに進めれば、Googleログインフローが正常に動作します:
トラブルシューティング
「トラブルシューティング」セクション問題が発生した場合は、まずアプリの設定と Google Cloud Console の値を比較してください。Android の Google サインイン失敗は、通常、パッケージ名、SHA-1、またはクライアント ID の不一致が原因です。
Credential Manager、SHA-1、Firebase
セクション「Credential Manager、SHA-1、および Firebase」Android では、このプラグインは Google Credential Manager (androidx.credentials および Sign in with Google) を使用しており、レガシーな GoogleSignInClient API ではありません。Logcat のエラーは GetCredentialCustomException: [28444] Developer console is not set up correctly など、そのスタックから発生します。
Logcat を以下でフィルタリングしてください GoogleProvider または CapgoSocialLogin ログイン失敗後に表示されます。プラグインはパッケージ名、署名 SHA-1、マスクされた webClientId Google Cloud Console と照合できるようにするためです。
Google Cloud の必須設定
「Google Cloud の必須設定」というセクション同じ Google Cloud プロジェクト内に、2種類の OAuth 2.0 クライアント ID が必要です:
| クライアントタイプ | 用途 | 設定先 |
|---|---|---|
| Web アプリケーション | サーバー / ID トークンのオーディエンス | webClientId における SocialLogin.initialize() |
| Android(署名キーごとに1つ) | APK が Google を呼び出せることを証明します | Google Cloud Console のみ。この ID を以下には渡さないでください: webClientId |
よくある間違いは、Android クライアント ID を webClientIdとして使用することです。Credential Manager には Web クライアント ID が必要です。Android クライアントには、コンソールに正しいパッケージ名と SHA-1 が登録されていることのみが必要です。
テストするビルドに署名する各証明書ごとに、1 つの Android OAuth クライアントを作成します:
- Debug:
./gradlew signingReportの debug バリアントから取得します。 - Release: 実際にインストールする APK または AAB から取得します。
- Play App Signing: Play Console > App integrity > App signing key certificate から取得します。アップロードキーの SHA-1 が登録済みであっても、Play Store 向けビルドには必須です。
この applicationId における android/app/build.gradle は、Android OAuth クライアントのパッケージ名と完全に一致する必要があります。 .debug サフィックスを含む。
OAuth 同意画面がテストモードの場合は、Audience > Test users にテストで使用するすべての Google アカウントを追加してください。本番環境への公開は不要です。 email と profile スコープ。Digital Asset Links (assetlinks.json) は、Credential Manager 経由の Sign in with Google では不要です。
Google Cloud の変更が反映されるまで、最大で数時間かかる場合があります。
エラー 28444: デベロッパーコンソールが正しく設定されていません
セクション「Error 28444: Developer console is not set up correctly」これはほぼ常に、Google が次の組み合わせを拒否したことを意味します:インストール済み APK の署名証明書、パッケージ名、および webClientId。以下のチェックリストを確認してください:
- 確認
webClientIdは Web アプリケーションのクライアント ID で、末尾が.apps.googleusercontent.com. - アプリを実行して失敗を再現し、Logcat で以下を確認してください:
GoogleProvider,signingSha1=やpackage=. - では Google Cloud Console > 認証情報、Android OAuthクライアントを開き、正確なパッケージ名とSHA-1を確認してください。
- リリースビルドをテストする場合は、デバッグ用keystoreだけでなく、そのビルドのSHA-1を登録してください。
- アプリがPlay Store経由で配布される場合、Play App SigningのSHA-1も登録してください。
- WebクライアントとAndroidクライアントが同じGoogle Cloudプロジェクトにあることを確認してください。
- 同意画面が「テスト」モードの場合は、Googleアカウントがテストユーザーであることを確認してください。
- コンソールを変更した後は、しばらく待ってから再試行してください。
USER_CANCELLED 設定が誤っているデバッグビルドでアカウントを選択した後のエラーは、依然としてSHA-1またはクライアントIDの不一致である可能性があります。まず上記のコンソール設定を修正してください。
インストールしたビルドからSHA-1を抽出する
「インストールするビルドからSHA-1を抽出する」セクションデバッグまたはローカルビルド:
cd android && ./gradlew signingReport署名済みリリース APK:
keytool -printcert -jarfile android/app/release/app-release.apkその SHA-1 を、対応するパッケージ名を持つ Android OAuth クライアントに追加し、同じ署名済み APK を再インストールして、もう一度テストしてください:
adb install android/app/release/app-release.apkログイン結果の読み取り
「ログイン結果の読み取り」セクショントークンは以下にネストされています result:
const login = await SocialLogin.login({ provider: 'google' });const idToken = login.result?.idToken;Firebase Authの場合は、それを使って認証情報を作成し、 idToken WebクライアントIDを次のように使用します。 webClientId における initialize.
開発用のSHA-1証明書が取得できない場合は、カスタムキーストアを試してください。 こちらのIssueのコメントでは、 プロジェクトにキーストアを追加する方法について説明しています。
AndroidでのGoogle Loginの続きから進める
「AndroidでのGoogle Loginの続きから進める」セクション使用している場合 AndroidでのGoogle Login 認証とアカウントフローを計画するには、これを次と連携させてください @capgo/capacitor-social-login の使用 「@capgo/capacitor-social-login の使用」のネイティブ機能のために、 @capgo/capacitor-social-login @capgo/capacitor-social-login の実装の詳細については、 @capgo/capacitor-passkey @capgo/capacitor-passkey の実装詳細については、 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric の実装の詳細、および 2要素認証 二要素認証の実装の詳細については。