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 클라이언트가 있습니다.'라는 오류를 어떻게 해결하나요?

이 오류는 지정된 패키지 이름과 SHA-1의 OAuth 2.0 클라이언트 ID가 다른 Firebase 또는 Google Cloud 프로젝트에 포함된 사실이 감지되면 발생합니다. 이 오류를 해결하는 방법을 알아보세요.

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 Console의 프로젝트 일반 설정에 추가했습니다.
• 출시 버전/프로덕션 키 저장소에 있는 SHA-1 인증서 지문을 Firebase Console의 Firebase Android 앱에 추가했습니다( 프로젝트 설정으로 이동하여 내 앱까지 아래로 스크롤한 후 Android 앱 선택).
• Google Play Console에 있는 SHA-1 인증서 지문을 Firebase Console의 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.1.1	com.google.firebase.appdistribution
Crashlytics 플러그인	com.google.firebase:firebase-crashlytics-gradle	3.0.3	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'
       ...
   }