이전 목록으로
#Flutter#iOS

Flutter iOS 사내 테스트 배포: UDID부터 IPA까지

Flutter iOS 앱을 Ad Hoc 방식으로 내부 테스터에게 배포할 때 필요한 인증서, UDID, Provisioning Profile, Archive와 ExportOptions.plist의 관계를 설명한다.

iOS 사내 테스트 배포의 핵심은 “누가 만든 앱을 어떤 앱 ID로 어느 기기에 설치할 수 있는가”를 서명 정보로 증명하는 것이다.

flowchart TD
    A[테스터 UDID 수집] --> B[Apple Developer에 Device 등록]
    B --> C[App ID 확인]
    C --> D[Distribution 인증서 확인]
    D --> E[Ad Hoc Profile 생성]
    E --> F[Xcode Archive]
    F --> G[IPA Export]
    G --> H[테스터 배포]

구성 요소

항목 의미
Bundle ID 앱의 고유 식별자
Certificate 앱을 서명한 개발자·조직 증명
UDID 설치 허용 기기 식별자
Provisioning Profile App ID·Certificate·Device의 조합
ExportOptions.plist IPA를 어떤 방식으로 내보낼지 정의

Flutter 사전 점검

flutter doctor -v
flutter clean
flutter pub get
flutter build ipa --release

Flavor가 있다면 Scheme과 Bundle ID가 올바른지 확인한다.

flutter build ipa \
  --flavor stage \
  -t lib/main_stage.dart \
  --release

ExportOptions.plist 예시

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>method</key>
  <string>ad-hoc</string>
  <key>signingStyle</key>
  <string>manual</string>
  <key>teamID</key>
  <string>YOUR_TEAM_ID</string>
  <key>provisioningProfiles</key>
  <dict>
    <key>com.example.app.stage</key>
    <string>Your Ad Hoc Profile Name</string>
  </dict>
</dict>
</plist>

자주 발생하는 오류

requires a provisioning profile

  • Bundle ID와 Profile의 App ID가 다르다.
  • 새 UDID 추가 후 Profile을 다시 생성·다운로드하지 않았다.
  • Xcode가 이전 Profile을 선택하고 있다.

No signing certificate found

인증서 파일만 있고 Private Key가 Keychain에 없을 수 있다. 인증서를 만든 Mac에서 .p12로 내보내 안전하게 CI나 배포 Mac에 설치해야 한다.

Module not found

Pod와 Xcode Configuration 매핑을 확인한다.

cd ios
pod install --repo-update

Debug-stage, Profile-stage, Release-stage 같은 사용자 Configuration이 Podfile에 올바르게 매핑되어야 한다.

운영 팁

  • 인증서·Profile 만료일을 기록한다.
  • 개인 계정이 아니라 조직 소유 배포 체계를 사용한다.
  • Stage와 Prod Bundle ID를 분리한다.
  • Archive에 사용한 Xcode 버전을 기록한다.
  • .p12, 비밀번호와 API Key는 Secret 저장소에 보관한다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.