Flutter 개발 환경은 SDK만 설치한다고 끝나지 않습니다. 목표 플랫폼의 도구 체인, 실제 기기, 서명 설정과 스토어 요구사항까지 각각 확인해야 합니다. 아래 절차는 먼저 작은 프로젝트를 실행해 환경을 검증한 뒤 배포 설정을 추가하는 순서입니다.
[목차]
1. Stable SDK와 플랫폼 도구 설치
- Flutter 공식 설치 안내에서 운영체제에 맞는 stable SDK를 설치합니다.
- Android 대상이면 Android Studio와 SDK를, iOS 대상이면 macOS에서 Xcode와 CocoaPods 등 요구 도구를 준비합니다.
- Web 대상이면 지원 브라우저를 준비합니다.
flutter --version
flutter doctor -v
flutter devices
flutter doctor -v의 경고를 무조건 무시하지 말고 목표 플랫폼과 관련된 항목을 해결합니다. Android 라이선스가 필요한 환경에서는 flutter doctor --android-licenses를 실행합니다.
2. 프로젝트 생성과 개발 검증
flutter create sample_app
cd sample_app
flutter run
flutter analyze
flutter test
flutter analyze와 테스트를 CI에서도 실행하면 로컬 환경 차이로 생기는 문제를 줄일 수 있습니다. 패키지를 추가할 때는 지원 플랫폼과 최신 유지보수 상태를 확인하고 pubspec.lock 관리 방식을 팀에서 통일합니다.
3. 환경별 설정을 분리합니다
- API 주소와 기능 플래그는 개발·스테이징·운영 환경을 분리합니다.
- 비밀키를 Dart 소스나 Git 저장소에 넣지 않습니다. 앱에 포함된 값은 사용자가 추출할 수 있다고 가정합니다.
- Android 애플리케이션 ID와 iOS Bundle ID를 배포 전에 확정합니다.
- 앱 아이콘, 권한 설명, 개인정보 처리방침 URL을 준비합니다.
4. 릴리스 빌드
# Android App Bundle
flutter build appbundle --release
# iOS archive 준비(macOS와 Xcode 필요)
flutter build ipa --release
# Web
flutter build web --release
Android는 업로드 키와 앱 서명 설정이 필요합니다. 키 저장소 파일과 비밀번호를 저장소에 커밋하지 마세요. iOS는 Apple Developer 계정, 인증서, 프로비저닝과 Xcode의 서명 설정이 필요합니다. Web 빌드는 정적 파일을 서버에 올리는 것 외에도 base URL, 캐시 정책, 라우팅 fallback을 확인해야 합니다.
5. 배포 직전 확인
- 실제 저사양 기기와 느린 네트워크에서 핵심 흐름 시험
- 앱 버전과 빌드 번호 증가
- 디버그 로그와 테스트 서버 주소 제거
- 권한 요청 시점과 거부 시 동작 확인
- 크래시·성능 모니터링과 롤백 계획 준비
스토어 정책과 빌드 요구사항은 바뀔 수 있으므로 배포 시점에는 Flutter 문서뿐 아니라 Google Play Console과 App Store Connect의 현재 안내를 다시 확인합니다.
공식 참고자료
관련 글
내용 검토 및 업데이트: 2026년 8월 27일