안드로이드에서 Google 로그인

소개

In this guide, you will learn how to setup Google Login with Capgo Social Login for Android. I assume that you have already read the 일반 설정 가이드를 이미 읽었다고 가정합니다..

Android에서 Google 로그인을 사용하는 방법

이 부분에서 Android에서 Google 로그인을 설정하는 방법을 배울 것입니다.

주의

안드로이드 SHA1 인증서는 매우 번거롭고, 누구에게도 이를 설정하도록 원치 않는다. 다음 단계는 앱이 Google Play Store에 배포되지 않았으며, 로컬 시뮬레이터 또는 개발 장치만 사용하는 가장 단순한 시나리오를 가정한다.

Google Play Store에 앱을 배포한 경우 반드시 추가 안드로이드 클라이언트 ID를 추가해야 하며, 이 ID에는 Google Play 콘솔에서 얻은 SHA1이 포함되어야 한다. Google Play 콘솔에서 릴리스 번들을 서명하는 SHA1 해시를 찾을 수 있다. Test and release > Setup > App Signing.

마지막으로, 설정을 잘못하면 오류가 명확하지 않다. 오류를 디버깅하는 것이 매우 어렵다. 설정이 어려우면 __CAPGO_KEEP_0__ 이슈를 참조하거나 Github issues.

Google Login 설정을 참조하거나 Google Login 설정을 참조하거나 Google Login 설정을 참조하거나

Note

Android 클라이언트 ID를 여러 개 만들 수 있습니다. 여러 개의 SHA1 인증서가 있는 경우 필수입니다.

1. Android 클라이언트 ID 만들기

   1. 검색 바 클릭

      

   2. 검색 credentials 그리고 APIs and Services 스크린샷의 2번에 해당하는

      

   3. 자격 증명 옵션에 클릭 create credentials

      

   4. APIs and Services에서 자격 증명 선택 OAuth client ID

      

   5. Select the Android 응용 프로그램 유형

      

   6. Open Android Studio

   7. Android Studio 프로젝트 탐색기에서 가장 아래쪽에 Gradle Scripts

      

   8. Find build.gradle 모듈 app

      

   9. build.gradle (Module: app) file in Gradle Scripts section android.defaultConfig.applicationIdCopy the package name In Google 콘솔

      

   10. Now, 터미널을 열어보세요. 당신이 앱 폴더에 있는지 확인하세요. android 터미널에서 gradlew signInReport 명령어를 실행하세요. ./gradlew signInReport

   
   11. SHA1 인증서 지문이 출력된 터미널 SHA1.
   
   12. Android 클라이언트 생성 폼에 패키지 이름과 SHA1을 입력한 상태 applicationId Android용 웹 클라이언트를 생성하세요. (Android용은 필수입니다.) Package Name Android용 웹 클라이언트를 생성하세요. (Android용은 필수입니다.) create
   

2. Android용 웹 클라이언트를 생성하세요. (Android용은 필수입니다.)

   1. Go to the Create credentials Google Console 페이지로 이동하세요.

   2. Set application type to Web

      

   3. Click Create

      

   4. Copy the client ID, you’ll use this as the webClientId code에 사용할 클라이언트 ID를 복사하세요.

      

3. Modify your MainActivity

   1. Android Studio에서 앱을 열어 주세요. 앱을 실행할 수 있습니다. cap open android

   2. Find MainActivity.java

      1. Open the app 폴더

         

      2. Find java

         

      3. Find your MainActivity.java 그리고 클릭하여

         

   3. Modify 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. Use Google Login in your application

   1. First, import SocialLogin

      import { SocialLogin } from '@capgo/capacitor-social-login';

   2. Call initialize. This should be called only once.

      // 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. Call 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))

      주의

      Google과 초기화 할 때 mode: 'offline', SocialLogin.login() returns serverAuthCode 백엔드 데이터 교환 흐름을 위해 사용하세요. 호출하지 마세요. SocialLogin.refresh({ provider: 'google' }) 앱 내에서 그 모드에서 호출하지 마세요. serverAuthCode 백엔드에서 Google 리프레시 토큰을 저장하고, 백엔드에서 리프레시하세요.

5. 테스트를 위해 에뮬레이터를 구성하세요.

   1. 그리고 플러스 버튼을 클릭하세요. Device manager 플러스 버튼이 강조된 Android Studio의 디바이스 매니저로 들어가세요.

      

   2. 가상 디바이스 구성에서 가상 디바이스 생성 버튼을 클릭하세요.

      

   3. 디바이스 아이콘 Play Store 플레이 스토어 지원을 하는 디바이스 목록

      

      As you can see, the pixel 8 supports the Play Store services

   4. Click next

      

   5. Make sure that the OS image is of type Google Play. IT MUST be of type Google Play

      

   6. Click next

      

   7. Confirm your device. You can name your emulator as you prefer

      

   8. __CAPGO_KEEP_0__에 Device Manager 시뮬레이터를 부팅하세요.

      

   9. 시뮬레이터가 부팅되면 설정으로 이동하세요.

      

   10. __CAPGO_KEEP_0__ 설정 화면에 Google Play 옵션이 있습니다. Google Play

   
   11. Google Play 업데이트 화면에 업데이트 버튼이 있습니다. Update __CAPGO_KEEP_2__을 테스트하세요.
   

6. __CAPGO_KEEP_0__

   If you did everything correctly, you should see the Google login flow working properly:

   

문제 해결

이러한 문제가 발생하면, Google Cloud Console의 앱 설정과 일치하는지 확인하세요. Android Google Sign-In 오류는 일반적으로 패키지 이름, SHA-1, 또는 클라이언트 ID의 불일치로 인해 발생합니다.

인증 관리자, SHA-1, 및 Firebase

Android에서 이 플러그인은 Google Credential Manager (androidx.credentials 와 Sign in with Google), legacy 버전이 아닌 GoogleSignInClient API. Logcat 오류, 예를 들어 GetCredentialCustomException: [28444] Developer console is not set up correctly 는 해당 스택에서 발생합니다.

Logcat을 필터링하세요. GoogleProvider 또는 CapgoSocialLogin 로그인 실패 후에도. webClientId 플러그인은 패키지 이름, 서명 SHA-1, 그리고 가려진

이를 Google Cloud Console에서 비교할 수 있도록.

제목 ‘Google Cloud 설정이 필요합니다.’

Google Cloud 프로젝트에 두 가지 종류의 OAuth 2.0 클라이언트 ID가 필요합니다.	클라이언트 유형	사용 목적
위치	웹 애플리케이션	webClientId 서버 / ID 토큰 대상 SocialLogin.initialize()
Android, 하나의 서명 키당	Google Cloud Console에서만 사용하세요. 이 ID를	A common mistake는 Android client ID를 사용하는 것입니다. webClientId

Credential Manager는 Web client ID를 필요로 합니다. Android client ID는 단지 올바른 패키지 이름과 SHA-1만 등록하면 됩니다. webClientIdCreate one Android OAuth client for each certificate that signs builds you test:

Debug:

• for the debug variant. ./gradlew signingReport Release:
• Play App Signing: Play Console > App integrity > App signing key certificate에서 찾습니다. Play Store 빌드에 대해 필요합니다.
• The

in applicationId __CAPGO_KEEP_0__ android/app/build.gradle Android OAuth 클라이언트 패키지 이름이 정확히 일치해야 합니다. 포함된任何 접미사. .debug OAuth 동의 화면이 테스트 모드일 경우, 사용자 > 테스트 사용자에서 테스트하는 모든 Google 계정을 추가하세요. 앱을 프로덕션으로 출시하는 것은 필요하지 않습니다.

scopes. email 디지털 자산 링크 ( profile )는 Credential Manager를 통해 Google과 함께 로그인하는 경우 필요하지 않습니다.assetlinks.jsonGoogle Cloud의 변경 사항은 몇 시간 동안 전파될 수 있습니다.

오류 28444: 개발자 콘솔이 올바르게 설정되지 않았습니다.

제목이 '오류 28444: 개발자 콘솔이 올바르게 설정되지 않았습니다.'인 섹션

을 combination으로 거부했을 때 발생합니다. 다음 체크리스트를 통해 작업하세요: webClientId확인

1. Confirm webClientId __CAPGO_KEEP_0__은 웹 애플리케이션 클라이언트 ID로 끝나며 .apps.googleusercontent.com.
2. 앱을 실행하고 실패를 재현한 후 Logcat을 읽어보세요. GoogleProvider, signingSha1=Android 및 package=.
3. In Google Cloud Console > Credentials에서, Android OAuth 클라이언트를 열고 정확한 패키지 이름 및 SHA-1을 확인하세요.
4. 릴리즈 빌드 테스트 중인 경우, 디버그 키 스토어의 SHA-1만 등록하지 마세요.
5. 앱이 Play Store를 통해 배포되는 경우, 또한 Play App Signing SHA-1을 등록하세요.
6. 웹 및 Android 클라이언트가 동일한 Google Cloud 프로젝트에 존재해야 합니다.
7. consent 화면이 테스트 중인 경우, Google 계정이 테스트 사용자인지 확인하세요.
8. 콘솔 변경 후 기다리며 다시 시도하세요.

USER_CANCELLED 디버그 빌드의 계정 선택 후에도 SHA-1 또는 클라이언트 ID 불일치가 발생할 수 있습니다. 콘솔 설정을 위에서부터 수정하세요.

__CAPGO_KEEP_0__ SHA-1을 설치한 빌드에서 추출하세요

debug 또는 local 빌드:

cd android && ./gradlew signingReport

서명된 릴리스 APK:

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

해당 패키지 이름이 일치하는 Android OAuth 클라이언트에 SHA-1을 추가하고 동일한 서명된 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 인증서를 얻을 수 없다면, 커스텀 키스토어를 사용해 보세요. 이ssue 댓글 프로젝트에 키스토어를 추가하는 방법을 설명합니다.

Google Login on Android에서 계속

이미 사용 중입니다. Google Android 로그인 인증 및 계정 흐름을 계획하고 연결하려면 @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의 구현 세부 정보를 사용하여 두 단계 인증 두 단계 인증의 구현 세부 정보를 사용하여