Android와 Firebase의 문제 해결 및 FAQ

이 페이지에서는 Firebase 사용 시 발생할 수 있는 Android 관련 문제 해결 방법과 팁을 제공합니다.

아래에서 찾을 수 없는 다른 문제나 어려운 점이 있으신가요? Firebase 전체 FAQ 또는 제품별 FAQ를 살펴보려면 기본 Firebase FAQ를 확인하세요.

Firebase Android SDK GitHub 저장소에서 보고된 문제 및 문제 해결의 최신 목록을 확인할 수도 있습니다. 자신이 경험한 Firebase Android SDK 관련 문제도 이 저장소에 보고하는 것이 좋습니다.

Firebase 프로젝트에 Android 앱을 추가할 때 SHA-1을 제공해야 하나요?

SHA-1 정보 는 Firebase Authentication에 필요합니다( Google 로그인 또는 전화번호 로그인) 및 Firebase Dynamic Links 이러한 기능을 사용하지 않는 경우 SHA-1을 제공할 필요가 없습니다.

'다른 프로젝트에 이미 패키지 이름과 SHA-1이 동일한 OAuth2 클라이언트가 있습니다.'라는 오류를 어떻게 해결하나요?

이 오류는 다른 Firebase 또는 Google Cloud이 프로젝트에 패키지 이름과 함께 OAuth 2.0 클라이언트 ID가 포함되어 있습니다. 지정한 SHA-1이 포함됩니다. 자세히 알아보기 해결 방법을 알아보세요.

Firebase를 Android 프로젝트에 추가하면 '찾을 수 없음' 오류가 발생합니다.

이 오류는 일반적으로 앱에 Google Maven 저장소에 대한 참조가 하나 이상 누락되었음을 의미합니다. Gradle 구성 파일에 Google의 Maven 저장소(google())를 포함해야 합니다.

• 프로젝트에서 plugins 구문을 사용하는 경우 settings.gradle.kts 또는 settings.gradle 파일의 plugins 섹션에 이 구문을 포함합니다.
• 프로젝트에서 buildscript 구문을 사용하는 경우 프로젝트 수준 build.gradle.kts 또는 build.gradle 파일의 buildscript 및 allprojects 섹션 모두에 구문을 포함합니다.

Firebase SDK를 Android 프로젝트에 추가하면 커스텀 지원 호출 및 디슈가링 사용 설정과 관련된 오류가 발생합니다.

2021년 5월 (Firebase BoM v28.0.0)에는 Firebase에서 모든 Android 라이브러리 (출시 노트 참조).

이러한 변경으로 인해 Android Gradle 플러그인(AGP) v4.2 이하를 사용하는 Gradle 빌드에서는 자바 8 지원을 사용 설정해야 합니다. 그렇지 않으면 Firebase SDK를 추가할 때 이러한 Android 프로젝트에 다음과 같은 빌드 실패가 발생합니다.

D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.

빌드 실패를 해결하려면 다음 두 가지 옵션 중 하나를 수행하면 됩니다.

• 오류 메시지에 나열된 compileOptions를 앱 수준 build.gradle.kts 또는 build.gradle 파일에 추가합니다.
• Android 프로젝트의 minSdkVersion을 26 이상으로 높입니다.

앱을 출시한 후 Google 로그인에 '12500:' 오류가 표시됩니다. 어떻게 해결해야 하나요?

이런 상황이 발생하는 2가지 이유는 지원 이메일을 제공하지 않았거나 SHA 키가 없는 경우입니다. 이 오류를 해결하려면 다음 조건이 모두 true인지 확인하세요.

• 지원 이메일을 프로젝트의 일반 설정 (Firebase 콘솔에서 확인)
• 다음을 추가했습니다. 출시/프로덕션 키 저장소의 SHA-1 인증서 지문 Firebase 콘솔에서 Firebase Android 앱( 프로젝트 설정에서 아래로 스크롤하여 내 앱을 클릭한 다음 Android 앱을 선택합니다.
• 다음을 추가했습니다. Google Play 콘솔의 SHA-1 인증서 지문 Firebase 콘솔에서 Firebase Android 앱으로 이동합니다( 프로젝트 설정에서 아래로 스크롤하여 내 앱을 클릭한 다음 Android 앱을 선택합니다.

buildscript 구문을 사용하여 Android 프로젝트에 Firebase 플러그인을 추가하는 방법

팁: buildscript 구문에서 plugin 구문으로 이전하는 것이 좋습니다. 이렇게 하면 Android 스튜디오에서 코드 완성을 수행하고 다른 유용한 추천을 제공할 수 있습니다.

Firebase에는 다음과 같은 Gradle 플러그인이 있습니다.

플러그인 이름	Maven 좌표	최신 버전	플러그인 ID
Google Play 서비스 플러그인	com.google.gms:google-services	4.4.2	com.google.gms.google-services
App Distribution 플러그인	com.google.firebase:firebase-appdistribution-gradle	5.0.0	com.google.firebase.appdistribution
Crashlytics 플러그인	com.google.firebase:firebase-crashlytics-gradle	3.0.2	com.google.firebase.crashlytics
Performance Monitoring 플러그인	com.google.firebase:perf-plugin	1.4.2	com.google.firebase.firebase-perf

buildscript 구문을 계속 사용하는 Android 프로젝트에 Firebase 플러그인을 추가하는 방법은 다음과 같습니다.

1. 루트 수준(프로젝트 수준) Gradle 파일(<project>/build.gradle.kts 또는 <project>/build.gradle)에서 Maven 좌표를 사용하여 플러그인을 종속 항목으로 추가합니다.

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

2. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 플러그인 ID를 사용하여 플러그인을 추가합니다.

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }