App Release Guide (Flutter)

이 문서는 Flutter 앱의 .aab 파일(Android) 및 .ipa/Archive(iOS)를 생성하는 방법을 설명합니다.
Android Studio와 Xcode 기반으로 작업하며, OS별로 나누어 설명합니다.

---

📝 읽기 전 참고!

• Android: .aab로 배포하는 방법만 기재하였습니다. (Google Play 기준)
• iOS: .ipa 직접 추출은 하지 않습니다. Xcode Organizer에서 처리하는 방법입니다.
• 빌드 전에 항상 flutter clean && flutter pub get 하면 죠습니다.

---

🟢 Android (Google Play 배포용 .aab 파일)

✅ 전제 조건

• Flutter SDK 설치
• Android Studio 설치
• Android Emulator or Device 연결 가능
• keystore 설정 완료 (Google Play에 업로드하려면 서명 필요)

📦 AAB 파일 생성 과정

1. pubspec.yaml에서 버전 확인

   version: 1.0.10+10

2. 터미널에서 Flutter build 명령어 실행:

   flutter build appbundle

3. 빌드 완료 후 .aab 파일 위치:

   build/app/outputs/bundle/release/app-release.aab

4. Google Play Console → "릴리스 만들기"에서 .aab 업로드

---

🍎 iOS (App Store / TestFlight용)

✅ 전제 조건

• macOS
• Xcode 설치 (최신 버전)
• Flutter 설치
• Apple Developer 계정 및 App ID, Provisioning Profile 설정 완료

---

🧰 iOS Pod 설치 및 초기화 (CocoaPods)

만약 pod 설치 및 과정을 이미 했거나 건너뛰고 싶다면 아래🧰 iOS용 Archive 만들기로!

📦 Pod 설치가 필요한 이유

Flutter에서 iOS native 코드를 다루는 plugin들을 사용할 때,
Xcode가 해당 라이브러리들을 읽을 수 있도록 CocoaPods를 통해 관리합니다.

---

✅ 기본 설치 명령어

1. ios/ 폴더로 이동:

   cd ios

2. Pod 초기화 및 설치:

   pod install

3. 만약 이미 Podfile이 있는데 오류가 난다면:

   pod deintegrate
   pod install

4. 깨끗하게 처음부터 하고 싶다면:

   rm -rf Podfile.lock Pods
   pod install
   cd ..

---

🛠️ 에러 자주 나는 부분

• macOS에 cocoapods가 없을 경우:

  sudo gem install cocoapods

• M1, M2 맥인 경우:

  sudo arch -x86_64 gem install ffi
  arch -x86_64 pod install

Apple 실리콘은 그냥 복불복이니까 정신무장을 해두는 게 낫습니다.

---

🧰 iOS용 Archive 만들기

방법 1: Android Studio 사용

1. Android Studio에서 Runner 열기
2. Device를 "Any iOS Device (arm64)" 로 선택
3. 상단 메뉴 → Build > Flutter > Build iOS
4. Xcode 열기: ios/Runner.xcworkspace 파일을 직접 Xcode에서 엶
5. Xcode에서 Product > Archive 선택
6. Archive가 생성되면, Organizer 창에서 App Store Connect or TestFlight로 업로드 가능

방법 2: CLI 사용

# 프로젝트 경로에서
flutter build ios --release

⚠️ 빌드만 되고 Archive는 안 됨. .xcarchive는 Xcode로 직접 Archive 해야 함.
1. Xcode 열기: ios/Runner.xcworkspace 파일을 직접 Xcode에서 엶
2. Xcode에서 Product > Archive 선택
3. Archive가 생성되면, Organizer 창에서 App Store Connect or TestFlight로 업로드 가능

---

📍 추가 설정 체크리스트

• ios/Runner/Info.plist: 버전 번호 확인
• Signing & Capabilities: Team, Provisioning, Bundle ID 올바르게 설정
• iCloud, Background Modes 등 필요 설정 확인

---

🧠 Tips

• Android는 릴리스 키 사인 확인
• iOS는 Code Signing 오류 잘 뜨니까 정신 단단히 챙기기

---