Android에서 Firebase Google Login

소개

이 가이드는 Android에서 Firebase Authentication을 사용하여 Google Sign-In을 통합하는 방법을 안내합니다. 다음 단계를 이미 완료했다고 가정합니다. Firebase Google 일반 설정

참고

아직 Firebase Console에서 Android 앱을 생성하지 않았다고 가정합니다. 이미 생성했다면 단계가 약간 다를 수 있습니다.

설정 단계

1. 다음 페이지에서 프로젝트 개요로 이동하세요: console.cloud.google.com

   

2. 다음을 클릭하세요: Add app 버튼을 클릭하세요

   

   참고

   Firebase Console에 이미 다른 앱을 생성한 경우, 이 버튼을 여기서 찾아야 할 수도 있습니다.

   

3. 선택 Android

   

4. 양식의 첫 번째 항목을 입력하세요

   1. 다음 항목을 입력하세요 Android package name
      1. 다음 명령어로 앱의 Android Studio를 여세요 npx cap open android
      2. 네비게이터 맨 아래에서 다음 항목을 찾으세요: Gradle Scripts
      3. 다음 항목을 찾아 build.gradle 모듈의 app
      4. 다음을 복사하세요 android.defaultConfig.applicationId. 이것이 package name Firebase 콘솔에서

      참고

      여기에 표시된 ID는 이 가이드의 나머지 부분에서 사용할 ID와 다릅니다. 저는 app.capgo.plugin.SocialLogin 가이드의 나머지 부분에서 사용하겠습니다.

      5. Firebase 콘솔에 붙여넣으세요
   2. 다음을 클릭하세요: Register app 버튼을 클릭하세요

5. 다음 단계를 Download and then add config file 건너뛰기

   

6. 다음 단계를 Add firebase SDK 건너뛰기

   

7. 다음을 클릭하세요: Continue to console 버튼을 클릭하세요

   

8. 자동 인증이 되지 않는 경우, settings -> general -> your apps -> Android 앱을 찾아 클릭하세요

   

9. SHA1 지문 가져오기

   다음 가이드의 10-11단계를 Google Login Android 설정 가이드에서:

   1. 이제 터미널을 여세요. 다음 경로에 있는지 확인하세요: android 앱 폴더로 이동하여 다음 명령어를 실행하세요 ./gradlew signInReport

      

   2. 명령어 결과의 맨 위로 스크롤하세요. 다음과 같은 내용이 보일 것입니다. 다음을 복사하세요: SHA1.

      

   참고

   기존 Google login android setup 가이드를 작성한 이후 컴퓨터가 바뀌었기 때문에, 이 가이드에서는 약간 다른 SHA1을 예시로 사용하겠습니다.

   주의

   SHA1 값을 정확하게 입력하는 것이 매우 중요합니다. 잘못 입력하면 인증 과정에서 예상치 못한 오류가 발생할 수 있습니다. GOOGLE LOGIN ANDROID SETUP GUIDE를 참고하여 정확히 설정하세요.

10. Firebase 프로젝트에 SHA1 추가

    1. 다음을 클릭하세요: Add fingerprint 버튼을 클릭하세요
    2. 이전 단계에서 복사한 SHA1을 붙여넣으세요
    3. 다음을 클릭하세요: Save 버튼을 클릭하세요

11. 웹 클라이언트 ID 가져오기

    1. 다음으로 이동: Build -> Authentication
    2. 다음을 클릭하세요: Sign-in method 버튼을 클릭하세요
    3. 다음을 클릭하세요: Google 프로바이더
    4. 다음을 클릭하세요: Web SDK configuration 버튼을 클릭하세요
    5. 다음을 복사하세요 Web client ID. 이것이 webClientId 플러그인의 initialize 메서드에서 사용할 값입니다.
    

12. JS에서 web client ID를 사용하세요.

    참고

    사용을 권장합니다: authenticateWithGoogle 사용 가능한 helper 함수: authUtils.ts 예제 앱 파일입니다.

이제 여러분은 기술적으로 Android에서 Firebase Authentication을 통한 Google Sign-In을 사용할 준비가 되었습니다. 하지만 다음 단계에서 설명할 Google Cloud console 설정을 다시 한번 확인하는 것을 권장합니다.

Google Cloud console 설정 재확인

설정이 올바른지 확인하려면 Google Cloud console 설정을 다시 한번 점검해야 합니다.

1. 다음으로 이동: console.cloud.google.com

2. 프로젝트 찾기

   1. 프로젝트 선택기 클릭
   2. Firebase 프로젝트의 정확한 이름으로 검색한 뒤 클릭하세요. 제 경우에는 sociallogin-tutorial-app.

3. 검색창을 열고 다음을 여세요 credentials

   1. 검색창 열기
   2. 검색: credentials 를 클릭하세요 APIs and Services 해당 항목(스크린샷의 2번)

4. 목록에 Android와 Web 클라이언트 ID가 모두 표시되는지 확인하세요.

   

   주의

   목록에 Android와 Web 클라이언트 ID가 모두 보이지 않는다면 설정 과정에 오류가 있는 것입니다. 이전 단계로 돌아가 설정을 다시 확인해 주세요.

   이미 다른 프로젝트에서 동일한 앱 ID로 Android SHA1 해시를 추가했을 가능성도 있습니다(저도 경험한 적이 있습니다). 이 경우 Firebase에서 Android 클라이언트 ID를 생성할 수 없습니다. 이럴 때는 다른 프로젝트와 Firebase(Firebase 콘솔에서 Android 앱 삭제) 모두에서 SHA1을 제거한 후 Firebase에서 다시 생성해야 합니다.

5. Firebase 콘솔에 Android 클라이언트 ID가 올바르게 설정되었는지 확인하세요.

   1. 다음을 클릭하세요: Android 앱
   2. SHA1 해시가 올바르게 설정되었는지, 그리고 이전 단계에서 복사한 값과 일치하는지 확인하세요.

6. Firebase 콘솔에 Web 클라이언트 ID가 올바르게 설정되었는지 확인하세요.

   1. 다음을 클릭하세요: Web 앱
   2. 클라이언트 ID가 이전 단계에서 복사한 것과 일치하는지 확인하세요.

   참고

   웹 클라이언트의 나머지 설정은 무시해도 됩니다. 자세한 내용은 다음에서 다룹니다: 웹 설정 가이드.

완료되었습니다! 이제 Android에서 Firebase Authentication을 통한 Google Sign-In을 사용할 준비가 되었습니다.

문제 해결

인증이 멈추거나 실패하는 경우:

• 다음을 확인하세요: idToken 사용자 대상이 Firebase 웹 클라이언트 ID와 일치합니다
• Firebase Console에서 Google Sign-In이 활성화되어 있는지 확인하세요
• SHA-1 지문이 올바르게 설정되었는지 확인하세요
• 다음을 참고하세요: 예제 앱 code 참고용

Android용 Firebase Google Login 설정 계속하기

사용 중이라면 Android에서 Firebase 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단계 인증 2단계 인증의 구현 세부 사항에 대해서는