로컬에서 만든 release.apk는 로그인되는데 Google Play에서 설치한 앱만 PlatformException(sign_in_failed, ApiException: 10)을 내면, Flutter 코드보다 서명 인증서부터 확인하는 편이 빠르다. 직접 설치한 APK는 내 upload keystore로 서명하지만 Play가 배포하는 APK는 Play App Signing 키로 다시 서명하기 때문이다. Play 출시 앱을 테스트하는 경우에만 해당하며, 사내 APK만 배포한다면 Play 인증서 등록은 필요하지 않다.
왜 APK와 Play 앱의 결과가 다른가
Android 출시에는 두 인증서가 있다. Flutter 공식 문서도 업로드 키와 최종 사용자에게 전달되는 app signing 키를 구분한다.
| 테스트 대상 | 실제 서명 주체 | Firebase에 필요한 지문 |
|---|---|---|
flutter run |
debug keystore | debug SHA-1, 필요하면 SHA-256 |
로컬 flutter build apk --release |
upload/release keystore | release SHA-1, SHA-256 |
| Google Play 설치본 | Play App Signing key | Play Console의 SHA-1, SHA-256 |
따라서 release keystore 지문만 Firebase에 넣으면 로컬 APK는 성공하고 Play 버전은 실패할 수 있다. ApiException: 10은 대개 패키지명·인증서·OAuth 클라이언트 조합이 맞지 않는 DEVELOPER_ERROR다.
Play 인증서를 먼저 등록한다
Play Console에서 Test and release → App integrity → App signing으로 이동해 App signing key certificate의 SHA-1과 SHA-256을 복사한다. Upload key certificate와 혼동하지 않아야 한다. Firebase 공식 FAQ도 Google Sign-In에는 release 지문과 Google Play Console 지문을 각각 등록하라고 안내한다.
Firebase Console의 Project settings → Your apps → Android 앱 → SHA certificate fingerprints에 두 값을 추가한다. 저장 뒤에는 새 google-services.json을 내려받아 android/app/google-services.json을 교체한다.
# 로컬 release/upload 키가 무엇인지 확인한다.
cd android
./gradlew signingReport
# Play Console에서 받은 인증서 파일도 직접 확인할 수 있다.
keytool -printcert -file deployment_cert.der | grep -E 'SHA1|SHA256'
위 명령의 값과 Play Console의 값이 다르면 정상일 수 있다. 전자는 업로드 키, 후자는 Play가 사용자에게 배포할 때 사용하는 키다. Play Console의 App signing key를 Firebase에 추가하는 것이 핵심이다.
OAuth 설정과 앱 번들을 함께 확인한다
Firebase에서 Authentication → Sign-in method → Google이 활성화되어 있는지 확인한다. Google Cloud Console의 OAuth 2.0 클라이언트에도 Android 앱의 package name과 Play App Signing SHA-1 조합이 존재해야 한다. Firebase 문서가 안내하는 것처럼 서버용 Web client ID와 Android client ID를 서로 바꿔 넣지 않는다.
| 확인 지점 | 실패하기 쉬운 값 | 조치 |
|---|---|---|
| Android 앱 ID | applicationId와 Firebase 앱의 패키지명이 다름 |
Gradle·Firebase 패키지명을 동일하게 맞춘다 |
| 인증서 | upload SHA만 등록 | Play App signing SHA-1과 SHA-256을 추가한다 |
| 설정 파일 | 예전 google-services.json |
지문 추가 후 다시 다운로드한다 |
| OAuth | Web client ID를 Android ID 자리에 사용 | SDK 문서의 용도에 맞는 ID를 사용한다 |
수정 뒤 flutter clean만 반복하는 것으로는 Play에 이미 올라간 AAB가 바뀌지 않는다. 새 versionCode로 AAB를 만들어 내부 테스트 트랙에 올리고, Play에서 내려받은 설치본으로 확인해야 한다.
flutter clean
flutter pub get
flutter build appbundle --release --build-number=42
Play Console의 내부 테스트는 실제 Play 배포 서명을 검증하는 경로다. 더 빠른 확인이 필요하면 App bundle explorer에서 생성된 기기별 APK를 내려받아 설치한다. 로컬 APK와 Play APK의 서명도 비교할 수 있다.
apksigner verify --print-certs app-release.apk
apksigner verify --print-certs downloaded-from-play.apk
출시 전 체크리스트
- debug, release/upload, Play App signing 지문을 따로 기록했다.
- Firebase Android 앱에 Play SHA-1과 SHA-256을 추가했다.
- 변경 후
google-services.json을 다시 받았다. - Android
applicationId와 Firebase 패키지명이 같다. - Google Cloud OAuth 클라이언트에 Play 서명 조합이 있다.
- 로컬 APK가 아니라 내부 테스트의 Play 설치본에서 로그인했다.
- 실패가 계속되면 Google Play 서비스 계정 선택 화면 뒤의 logcat 원문을 저장했다.
핵심은 flutter clean이 아니라 실제 사용자에게 전달된 APK의 서명 지문이다. Play 설치본에서만 Google Sign-In이 실패한다면 upload 키를 다시 만드는 데 시간을 쓰지 말고, Play App Signing 인증서를 Firebase와 OAuth 설정에 등록했는지부터 확인하면 된다.
참고 문서: Flutter Android 배포와 서명, Firebase Android Google 로그인, Firebase Android 문제 해결 FAQ, Google Play App Signing