이 페이지에서는 Firebase 사용 시 발생할 수 있는 Android 관련 문제 해결 방법과 팁을 제공합니다.
아래에서 찾을 수 없는 다른 문제나 어려운 점이 있으신가요? Firebase 전체 FAQ 또는 제품별 FAQ를 살펴보려면 기본 Firebase FAQ를 확인하세요.
Firebase Android SDK GitHub 저장소에서 보고된 문제 및 문제 해결의 최신 목록을 확인할 수도 있습니다. 자신이 경험한 Firebase Android SDK 관련 문제도 이 저장소에 보고하는 것이 좋습니다.
'다른 프로젝트에 이미 패키지 이름과 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인지 확인하세요.
buildscript 구문을 사용하여 Android 프로젝트에 Firebase 플러그인을 추가하는 방법
Firebase에는 다음과 같은 Gradle 플러그인이 있습니다.
| 플러그인 이름 |
Maven 좌표 |
최신 버전 |
플러그인 ID |
| Google Play 서비스 플러그인 |
com.google.gms:google-services |
4.3.15 |
com.google.gms.google-services |
| 앱 배포 플러그인 |
com.google.firebase:firebase-appdistribution-gradle |
4.0.0 |
com.google.firebase.appdistribution |
| Crashlytics 플러그인 |
com.google.firebase:firebase-crashlytics-gradle |
2.9.9 |
com.google.firebase.crashlytics |
| Performance Monitoring 플러그인 |
com.google.firebase:perf-plugin |
1.4.2 |
com.google.firebase.firebase-perf |
buildscript 구문을 계속 사용하는 Android 프로젝트에 Firebase 플러그인을 추가하는 방법은 다음과 같습니다.
루트 수준(프로젝트 수준) 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
}
}
모듈(앱 수준) 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'
...
}
