メインコンテンツへスキップ

AndroidでのGoogle Login

GitHub

このガイドでは、Android向けの Capgo Social Loginを使ってGoogle Loginをセットアップする方法を説明します。 すでに以下を読んでいることを前提としています。 一般的なセットアップガイド.

このパートでは、AndroidでGoogle Loginをセットアップする方法を説明します。

  1. Android クライアント ID を作成する

    1. 検索バーをクリックします

      Google Consoleの検索バー
    2. を検索し、 credentials 次をクリックします: APIs and Services 該当の項目(スクリーンショットの番号2)

      APIs & Servicesがハイライトされた認証情報オプションの検索結果
    3. 次の create credentials

      Google Consoleの「認証情報を作成」ボタン
    4. 選択します OAuth client ID

      認証情報作成メニューの「OAuth クライアント ID」オプション
    5. 次の Android アプリケーションの種類

      Android オプションがハイライトされたアプリケーションタイプの選択
    6. Android Studio を開く

    7. ナビゲーターの最下部で、以下を見つけてください Gradle Scripts

      Android Studio プロジェクトナビゲーターの Gradle Scripts セクション
    8. 次を探して、 build.gradle モジュール用の app

      Gradle Scripts セクションの build.gradle (Module: app) ファイル
    9. 以下をコピー android.defaultConfig.applicationId. これがあなたの package name Google コンソールで

      applicationId の設定を示す Build.gradle ファイル
    10. 次に、ターミナルを開いてください。次のディレクトリにいることを確認してください: android アプリのフォルダに移動して実行します ./gradlew signInReport

    gradlew signInReport コマンドを表示しているターミナル
    1. このコマンドの先頭までスクロールしてください。次のように表示されるはずです。これをコピーして SHA1.
    SHA1 証明書のフィンガープリントが表示されたターミナルの出力
    1. 次に、Google Console に戻ります。以下を入力してください applicationId を Package Name として入力し、SHA1 も証明書フィールドに入力してクリックします create
    パッケージ名と SHA1 が入力された Android クライアント作成フォーム
  2. Web クライアントを作成する(Android にはこれが必要です)

    1. 以下にアクセスしてください: Create credentials Google Console のページ

    2. アプリケーションの種類を以下に設定 Web

      Webオプションがハイライトされたアプリケーションタイプ選択
    3. クリック Create

      下部に「作成」ボタンがある Web クライアント作成フォーム
    4. クライアントIDをコピーします。これを webClientId JS/TS の code 内で

      コピーするWebクライアントIDが表示されたクライアントID詳細
  3. 以下の内容を含めるように MainActivity

    1. Android Studio でアプリを開いてください。実行できます cap open android

    2. 次を探して、 MainActivity.java

      1. 次を開きます: app フォルダ

        Android Studio プロジェクトナビゲーターの App フォルダ
      2. 次を探して、 java

        Android Studio プロジェクト構造内の Java フォルダ
      3. 次を探します MainActivity.java をクリックします

        パッケージ構造内の MainActivity.java ファイル
    3. 変更 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 {
      @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. ファイルを保存してください

  4. アプリケーションで Google Login を使用する

    1. まず、インポートします SocialLogin

      import { SocialLogin } from '@capgo/capacitor-social-login';
    2. 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',
      }
      })
      })
    3. 呼び出す SocialLogin.login。ボタンを作成し、クリック時に以下の code を実行します。

      const res = await SocialLogin.login({
      provider: 'google',
      options: {}
      })
      // handle the response
      console.log(JSON.stringify(res))
  5. テスト用にエミュレータを設定

    1. 〜を開きます Device manager プラスボタンをクリック

      Android Studio の Device Manager(プラスボタンがハイライト表示)
    2. 仮想デバイスを作成

      Virtual Device Configuration の [Create Virtual Device] ボタン
    3. アイコンが付いた任意のデバイスを選択 Play Store アイコン

      Play Store 対応デバイスが表示されたハードウェア選択画面

      ご覧のとおり、 pixel 8 をサポートします Play Store サービス

    4. クリック next

      次へ
    5. OSイメージのタイプが Google Play. 必ず タイプ Google Play

      Google Playタイプのイメージを表示するシステムイメージ選択
    6. 次へをクリック

      次へ
    7. デバイスを確認してください。エミュレータの名前は任意で設定できます

      完了ボタン付きのデバイス設定確認画面
    8. 〜を開きます Device Manager シミュレータを起動してください

      仮想デバイスが一覧表示されたDevice Managerと再生ボタン
    9. シミュレーターが起動したら、設定を開きます

      設定アプリが表示されているAndroidエミュレーター
    10. 〜を開きます Google Play

    Google Playのオプションがある設定画面
    1. クリック Update そのまま60秒ほど待ちます
    更新ボタンが表示されたGoogle Playの更新画面
  6. アプリケーションのテスト

    手順通りに進めれば、Googleログインフローが正常に動作します:

    AndroidでのGoogleログインフローのデモ(サインインから認証成功まで)

問題が発生した場合は、まずアプリの設定と Google Cloud Console の値を比較してください。Android の Google サインイン失敗は、通常、パッケージ名、SHA-1、またはクライアント ID の不一致が原因です。

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 プロジェクト内に、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。以下のチェックリストを確認してください:

  1. 確認 webClientId は Web アプリケーションのクライアント ID で、末尾が .apps.googleusercontent.com.
  2. アプリを実行して失敗を再現し、Logcat で以下を確認してください: GoogleProvider, signingSha1=や package=.
  3. では Google Cloud Console > 認証情報、Android OAuthクライアントを開き、正確なパッケージ名とSHA-1を確認してください。
  4. リリースビルドをテストする場合は、デバッグ用keystoreだけでなく、そのビルドのSHA-1を登録してください。
  5. アプリがPlay Store経由で配布される場合、Play App SigningのSHA-1も登録してください。
  6. WebクライアントとAndroidクライアントが同じGoogle Cloudプロジェクトにあることを確認してください。
  7. 同意画面が「テスト」モードの場合は、Googleアカウントがテストユーザーであることを確認してください。
  8. コンソールを変更した後は、しばらく待ってから再試行してください。

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要素認証 二要素認証の実装の詳細については。