Flutter 앱을 Play Console에 배포할 때 확인할 것

Play Console 업로드 전 점검

Flutter 앱을 Play Console에 올리기 전에 다음을 확인한다:

# 1. 버전 코드와 버전명 확인
grep -E 'versionCode|versionName' android/app/build.gradle

# 2. 빌드 확인
flutter build apk --release
flutter build appbundle --release  # 권장

# 3. 서명 확인
# Play Console에 업로드할 때 자동으로 재서명됨

버전 코드는 매번 증가해야 하고, 이전에 업로드한 버전보다 커야 한다.

권한과 메니페스트 확인

AndroidManifest.xml에서 다음을 확인한다:

<!-- 필요한 권한이 정의되어 있는가? -->
<uses-permission android:name="android.permission.INTERNET" />

<!-- API 레벨이 맞는가? -->
<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />

API 레벨이 너무 낮으면 Google Play에서 거부할 수 있다. 최신 기기를 타겟하려면 높은 API 레벨을 설정해야 한다.

빌드 모드 확인

# Debug 빌드로 실행 (개발 중)
flutter run

# Release 빌드 (실제 기기에서 테스트)
flutter run --release

# 상세 로그로 확인
flutter run --verbose

Debug와 Release 모드는 성능이 크게 다르다. Play Console에 올리기 전에 Release 모드에서 실제 기기로 테스트하는 게 중요하다.

API 응답과 로그 확인

Flutter 앱이 API와 통신하면:

# 로그캣으로 에러 확인
adb logcat | grep Flutter

# 네트워크 요청 확인
# Fiddler나 Charles를 사용해서 HTTPS 트래픽 모니터링

특히 HTTPS 인증서 문제나 API 인증 토큰 문제가 배포 후에 나타날 수 있다.

실기기에서 마지막 확인

배포 전에 실제 Play Console 환경과 유사하게 테스트한다:

• 최신 기기와 구형 기기에서 모두 테스트
• 다양한 네트워크 상황 (WiFi, 3G, 4G)
• 앱 재시작 후에도 정상 동작하는가

문제를 발견했을 때는 즉시 기록한다:

• 어떤 기기/OS에서 문제가 나타났는가
• 어떤 API 응답이 실패했는가
• 로그에 어떤 에러가 남았는가

이런 기록이 다음 배포를 안전하게 만든다.