Flutter 빌드 명령어 완벽 가이드

📋 기본 원칙

🔄 빌드 전 필수 명령어

flutter clean          # 이전 빌드 캐시 삭제
flutter pub get        # 의존성 패키지 다운로드

⚠️ 릴리즈 모드 주의사항

• 광고가 포함된 앱: 개발 중에는 릴리즈 모드를 자주 사용하지 말 것
• 이유: 실제 광고가 노출되어 개발자 계정에 영향을 줄 수 있음
• 개발 시 권장: 디버그 모드 또는 프로필 모드 사용

---

🚀 개발 및 테스트용 명령어

일반 개발 (디버그 모드)

flutter run

• 기본 디버그 모드로 실행
• 핫 리로드 지원
• 개발 중 가장 많이 사용

성능 테스트용 (프로필 모드)

flutter run --profile

• 성능 분석이 필요할 때
• 디버그 정보 + 최적화된 성능

최종 테스트용 (릴리즈 모드)

flutter clean
flutter pub get
flutter run --release

• 실제 배포 전 최종 테스트
• 광고 앱은 신중하게 사용

---

📱 Android 빌드

APK 파일 생성

flutter clean
flutter pub get
flutter build apk --release

• 테스트용 APK 파일 생성
• 위치: build/app/outputs/flutter-apk/app-release.apk

Google Play Store용 AAB 파일

flutter clean
flutter pub get
flutter build appbundle --release

• Play Store 업로드용
• 위치: build/app/outputs/bundle/release/app-release.aab
• 권장: Play Store는 AAB 형식 사용

디버그 APK (개발용)

flutter build apk --debug

• 개발 중간 테스트용
• 광고 앱에서 안전하게 사용 가능

---

🍎 iOS 빌드

기본 iOS 빌드

flutter clean
flutter pub get
cd ios
pod install
cd ..
flutter build ios --release --no-codesign

단계별 설명

1. flutter clean: 이전 빌드 파일 정리
2. flutter pub get: 의존성 업데이트
3. cd ios && pod install: iOS 네이티브 의존성 설치
4. flutter build ios --release --no-codesign: 코드사인 없이 빌드

Xcode에서 빌드/배포하는 경우

flutter clean
flutter pub get
cd ios
pod install
cd ..
flutter build ios --release

• 이후 Xcode에서 Archive 및 배포 진행

---

🌍 다국어 지원 앱

다국어 리소스 생성 후 빌드

flutter clean
flutter pub get
flutter gen-l10n
flutter run --release

다국어 파일만 업데이트

flutter gen-l10n
flutter run

---

📂 플랫폼별 빌드 파일 위치

Android

• APK: build/app/outputs/flutter-apk/
• AAB: build/app/outputs/bundle/release/

iOS

• IPA: Xcode Archive 후 생성
• 앱 번들: build/ios/Release-iphoneos/

---

🔧 문제 해결 팁

빌드 오류 시 체크리스트

1. flutter clean 실행했는지 확인
2. flutter pub get 최신 상태인지 확인
3. iOS의 경우 pod install 실행했는지 확인
4. Flutter 및 Dart SDK 버전 호환성 확인

캐시 완전 삭제

flutter clean
flutter pub cache repair
flutter pub get

iOS 특별 케이스

cd ios
rm -rf Pods
rm Podfile.lock
pod install
cd ..
flutter clean
flutter pub get

---

🎯 상황별 추천 명령어

상황	명령어	비고
일반 개발	flutter run	가장 기본
성능 확인	flutter run --profile	성능 분석 시
최종 테스트	flutter run --release	⚠️ 광고 앱 주의
Android 테스트 배포	flutter build apk --release	APK 파일 생성
Play Store 업로드	flutter build appbundle --release	AAB 권장
iOS 테스트	flutter build ios --release --no-codesign	코드사인 없음
앱스토어 배포	Xcode Archive 사용	iOS 정식 배포

---

💡 개발 효율성 팁

빌드 시간 단축

• 불필요한 flutter clean은 피하기
• 의존성 변경이 없다면 flutter pub get 생략 가능
• iOS: 의존성 변경이 없다면 pod install 생략 가능

안전한 테스트

• 광고 앱: 개발 중에는 flutter run (디버그 모드) 사용
• 릴리즈 모드: 최종 배포 전에만 제한적으로 사용
• 테스트 기기: 별도 테스트 계정 사용 권장

자동화 스크립트 예시

#!/bin/bash
# build_android.sh
flutter clean
flutter pub get
flutter gen-l10n  # 다국어 앱인 경우
flutter build appbundle --release
echo "Android AAB 빌드 완료!"

---

📝 빠른 참조

자주 사용하는 조합

# 개발 시작 시
flutter pub get && flutter run

# Android 배포 준비
flutter clean && flutter pub get && flutter build appbundle --release

# iOS 배포 준비  
flutter clean && flutter pub get && cd ios && pod install && cd .. && flutter build ios --release

# 다국어 앱 테스트
flutter gen-l10n && flutter run

이 가이드를 북마크해두고 필요할 때마다 참조하시면 됩니다! 🚀