Android와 Firebase의 문제 해결 및 FAQ

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

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

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

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

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

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

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

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

이 오류는 일반적으로 앱에 Google Maven 저장소에 대한 참조가 하나 이상 누락되었음을 의미합니다. 프로젝트 수준 build.gradle 파일에서 buildscript 및 allprojects 섹션에 Google의 Maven 저장소(google())가 포함되어야 합니다.

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 파일에 추가합니다.
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 앱 선택).