iOS 릴리스 빌드 구성 — Swift Package 통합 · 빌드 환경 문서

app/BUILD.md

@@ -60,3 +60,39 @@ apksigner verify --print-certs build/app/outputs/flutter-apk/app-release.apk
 현재 빌드는 **API 24** 로 나간다. 하한을 29 로 올리는 것은 위치 퀘스트의
 `geofence_foreground_service` 인데 아직 넣지 않았다. **6주차 위치 퀘스트 구현 시점에
 29 로 올라간다.** 그때 기준 단말 2종 충족을 다시 확인해 빌드 노트에 적는다.
+
+---
+
+## iOS
+
+**2026-08-31 실증** — `flutter build ios --release --no-codesign` 통과.
+
+| 구성 | 값 |
+|---|---|
+| Xcode | **27.0** (`~/Downloads/Xcode-beta.app`) |
+| CocoaPods | 1.17.0 (`brew install cocoapods`) |
+| 산출물 | `build/ios/iphoneos/Runner.app` · 21.7MB · arm64 |
+| bundle id | `kr.co.sweech.fancake` · 0.1.0(1) · label FANUZU |
+| **MinimumOSVersion** | **15.0** — 문서(별첨 1 · 2주차 선검증)와 **일치** |
+
+`xcode-select --switch` 는 sudo 를 요구하므로 **`DEVELOPER_DIR` 로 우회**한다.
+
+```bash
+export DEVELOPER_DIR=~/Downloads/Xcode-beta.app/Contents/Developer
+fvm flutter build ios --release --no-codesign
+```
+
+**서명은 Apple Developer 계정이 있어야 한다.** 계정 없이 여기까지는 확인되므로,
+TestFlight 제출에 남은 것은 **서명과 업로드뿐**이다.
+
+### 정리해야 할 것 — CocoaPods / SwiftPM 이중 상태
+
+빌드 중 Flutter 가 경고한다.
+
+> All plugins found for ios are Swift Packages, but your project still has CocoaPods
+> integration. … Removing CocoaPods integration will improve the project's build time.
+
+iOS 플러그인이 전부 Swift Package 로 옮겨졌는데 프로젝트에 CocoaPods 통합이 남아 있다.
+동작에는 지장이 없으나 빌드 시간이 늘고 구성이 이중이다. `pod deintegrate` 와
+`Debug.xcconfig` · `Release.xcconfig` 의 Pods include 제거가 필요하다.
+**11주차 최적화 구간에서 정리한다.**