Skip to content

Flutter_6101.iOSIPABuildManual.md

Latest commit

 

History

History
111 lines (67 loc) · 2.44 KB

Flutter_6101.iOSIPABuildManual.md

File metadata and controls

111 lines (67 loc) · 2.44 KB

Flutter-iOS 릴리즈 빌드 및 .ipa 수동 생성 가이드

이 문서는 Flutter 프로젝트에서 iOS용 .ipa 파일을 수동으로 생성하는 절차를 설명합니다.



🎯 목적

Flutter iOS 앱을 실기기 테스트 또는 Apple Configurator 배포를 위해 .ipa 파일로 포장하는 수동 방법을 정리합니다.



🛠️ 전제 조건

  • Flutter 및 fvm 설치 완료
  • iOS 개발 환경 설정 완료 (Xcode, 개발자 계정 등)
  • Runner.xcworkspace 기준 프로젝트
  • 연결된 실기기 혹은 .ipa 파일 설치 툴 (Apple Configurator 등)



🔧 빌드 및 패키징 절차

1. iOS 빌드 종류 및 실행 방법

Flutter에서 iOS 빌드는 주로 Release 모드로 진행되며, 기본 설정도 --release입니다. 필요에 따라 --debug, --profile 옵션도 사용할 수 있습니다.

▸ Release 빌드 (기본)

// 일반
flutter build ios           

// 동일 
flutter build ios --release

// fvm 사용 시
fvm flutter build ios
  • 결과: build/ios/iphoneos/Runner.app 생성
  • 실기기 설치, 배포, TestFlight, App Store 제출용

▸ Debug 빌드

// 일반
flutter build ios --debug

// fvm 사용 시
fvm flutter build ios --debug
  • 결과: build/ios/iphoneos/Runner.app 생성
  • 디버깅 목적용이며 .ipa 패키징이나 배포에는 적합하지 않음

⚠️ 참고: flutter run은 자동으로 debug 모드 빌드를 사용함

2. .ipa 파일 수동 생성

cd build/ios/iphoneos
mkdir Payload
cp -r Runner.app Payload/
zip -r Runner.ipa Payload
  • Payload/Runner.app 구조는 Apple이 요구하는 .ipa 포맷
  • 압축 결과물인 Runner.ipa 파일이 실기기 설치용으로 사용됨



📱 설치 방법 예시

▸ Apple Configurator 사용

  1. .ipa 파일을 Apple Configurator로 열기
  2. USB로 연결된 iPhone에 드래그 앤 드롭

▸ Xcode > Devices and Simulators

  • .ipa 파일을 기기 이름 위에 드래그하여 설치 가능



⚠️ 유의사항

  • Runner.app에 서명 포함 여부 확인
    • embedded.mobileprovision 파일 포함 필수
  • 서명되지 않았거나, UDID가 provisioning profile에 포함되지 않으면 설치 불가
  • 테스트 기기에서 “신뢰되지 않은 개발자” 경고 발생 시 설정에서 수동 승인 필요



HISTORY

  • 260623: 초안작성