CI/CD

Flutter 3.47 iOS 패키징: 2026년 원격 빌드 방안

윈도우나 리눅스에서 빌드는 끝났지만 iOS 보관 파일과 서명 단계에서 멈춥니다.

가장 빠른 해법은 Dart 개발은 기존 컴퓨터에 남기고, 지원되는 Xcode가 설치된 실제 맥으로 iOS 보관, 서명, 업로드를 분리하는 것입니다. Flutter 3.47의 저빈도 배포에는 임시 원격 맥이 적합하고, 여러 명이 자주 배포한다면 재현 가능한 장기 빌드 노드를 선택해야 합니다. Flutter의 iOS 설정 및 배포 안내도 iOS 빌드와 배포에 macOS 장치 및 Xcode가 필요하다고 설명합니다.

이 글은 윈도우 또는 리눅스에서 Flutter를 개발하다가 처음 iOS 앱을 출시하려는 독립 개발자를 위한 내용입니다.
개인 컴퓨터에서 iOS 빌드를 안정적인 환경으로 옮기려는 모바일 팀과 서명 자격 증명, 테스트플라이트 업로드, CI를 관리하는 엔지니어도 대상입니다.

마지막 업데이트: 2026년 8월 23일. Flutter 3.47 공개 상태는 공식 출시 안내, Xcode 지원 범위는 애플의 시스템 요구 사항, 업로드 조건은 앱 스토어 커넥트 공식 문서를 기준으로 확인했습니다.

개발 환경과 iOS 환경의 책임을 나눕니다

윈도우나 리눅스에서는 Dart 코드 작성, 일반적인 정적 검사, 플랫폼에 종속되지 않는 테스트를 계속 진행할 수 있습니다. 반면 Xcode 초기화, iOS 시뮬레이터 점검, 보관 파일 생성, 코드 서명, 앱 스토어 업로드는 macOS에서 수행해야 합니다.

작업 윈도우 또는 리눅스 원격 맥
Dart 코드 작성 적합 가능
일반 단위 테스트와 정적 검사 적합 가능
iOS 시뮬레이터 확인 제한됨 필요
Xcode 프로젝트 초기화 불가 필요
보관 파일과 IPA 생성 불가 필요
인증서, 개인 키, 프로비저닝 프로필 적용 불가 필요
테스트플라이트와 앱 스토어 업로드 불가 필요

윈도우에서 작성한 Flutter 프로젝트는 어떻게 iOS로 패키징합니까?
저장소를 원격 맥에서 안전하게 내려받은 뒤, 그곳에서 Flutter 진단, 의존성 설치, Xcode 빌드, 보관 파일 생성, 서명 검증을 실행합니다. 로컬에서 명령이 성공했다는 사실보다 원격 맥에서 생성된 IPA의 식별자와 서명 상태가 더 중요한 증거입니다.

소스 코드는 Git으로 가져오되, 생성 파일과 비밀 자료는 같은 방식으로 동기화하면 안 됩니다. build, Pods 같은 생성 결과는 무조건 복사하지 말고 원격 환경에서 다시 만들 수 있어야 합니다. 인증서 개인 키, API 키, 프로비저닝 프로필은 저장소와 일반 로그에서 제외하고 별도 권한 저장소나 일회성 주입 방식으로 관리해야 합니다.

첫 원격 빌드에서 환경을 먼저 고정합니다

Flutter 3.47을 설치했다고 바로 빌드하지 말고 Flutter 버전, macOS 범위, 정식 Xcode 버전, 명령줄 도구, iOS 플랫폼 구성 요소를 함께 확인해야 합니다. 정확한 조합은 Xcode 지원표와 Flutter 3.47 출시 기록을 대조해 결정합니다. 시험판 Xcode를 정식 배포 환경의 필수 조건으로 간주해서는 안 됩니다.

확인 대상 확인 방법 통과 증거
Flutter 버전 flutter --version 저장된 버전 출력
Flutter 진단 flutter doctor -v iOS 도구 관련 오류 없음
Xcode 선택 상태 xcode-select -p 의도한 개발자 도구 경로
Xcode 초기화 sudo xcodebuild -license 등 라이선스와 구성 완료
iOS 플랫폼 구성 요소 Xcode 설정과 시뮬레이터 목록 대상 플랫폼 확인
프로젝트 의존성 flutter pub get과 네이티브 의존성 설치 잠금 파일과 설치 로그
빌드 산출물 보관 파일과 IPA 경로 확인 파일 해시와 종료 상태

최소 폐쇄 루프는 다음과 같습니다.

  1. 원격 맥에 제한된 저장소 접근 권한으로 프로젝트를 내려받습니다.
  2. 지정된 Flutter 채널과 버전을 확인하고 flutter doctor -v 결과를 저장합니다.
  3. flutter pub get을 실행한 뒤, 프로젝트가 사용하는 CocoaPods 또는 Swift Package Manager 의존성을 준비합니다.
  4. 먼저 서명하지 않는 검증 빌드로 코드와 네이티브 설정 오류를 분리합니다.
  5. 배포용 설정으로 flutter build ipa를 실행하고 보관 파일, IPA 경로, 종료 상태를 기록합니다.
  6. Xcode에서 보관 파일의 앱 식별자, 버전, 서명, 권한 항목을 확인합니다.
  7. 업로드 전 검증을 마친 뒤에만 테스트플라이트로 전송하고 업로드 상태를 저장합니다.

명령 실행이 끝났다는 문구만으로 출시 가능성을 판단하면 안 됩니다. 종료 상태가 성공이어도 잘못된 번들 식별자, 누락된 권한, 개발용 서명, 예상과 다른 버전 번호가 남을 수 있습니다.

주의: 인증서 오류가 발생했을 때 모든 인증서를 먼저 폐기하고 다시 만드는 방식은 원인 추적을 어렵게 합니다. 서명 로그, 번들 식별자, 권한 항목, 보관 파일의 빌드 메타데이터를 순서대로 확인한 뒤 필요한 자료만 교체해야 합니다.

플러그인과 네이티브 의존성에 따라 분기합니다

순수 Dart 프로젝트는 의존성 확인 뒤 비교적 단순하게 iOS 빌드로 넘어갈 수 있습니다. iOS 플러그인이 포함된 프로젝트는 CocoaPods, Swift 코드, 배포 대상 버전, 네이티브 빌드 스크립트가 추가로 개입합니다. Add-to-App 프로젝트는 기존 iOS 호스트 앱의 설정이 기준이 되므로 Flutter 프로젝트만 점검해서는 부족합니다.

Flutter의 Swift Package Manager 개발자 안내를 참고해 패키지 관리 방식을 확인하고, 잠금 파일을 검토합니다. 네이티브 의존성이 바뀐 뒤에는 캐시가 이전 결과를 재사용하지 않는지 확인해야 합니다.

프로젝트 유형 원격 맥에서 준비할 항목 재빌드 뒤 확인할 증거
순수 Dart 중심 Flutter 패키지 잠금 상태 동일한 패키지 해석 결과
iOS 플러그인 포함 CocoaPods 또는 Swift Package Manager, 배포 대상 의존성 설치 로그와 링크 결과
Add-to-App 호스트 앱의 Xcode 설정과 구성 호스트 번들 식별자와 Flutter 모듈 연결
네이티브 스크립트 포함 실행 권한, 셸 경로, 환경 변수 스크립트 출력과 종료 상태

안드로이드 빌드가 성공했다고 iOS도 준비된 것은 아닙니다. 다음 항목을 캐시 정리 뒤 다시 확인해야 합니다.

  • [ ] pubspec.lock과 네이티브 의존성 잠금 파일이 검토되었습니다.
  • [ ] 배포 대상 버전이 사용하는 플러그인 요구 사항과 맞습니다.
  • [ ] CocoaPods 또는 Swift Package Manager 설치 결과가 로그에 남았습니다.
  • [ ] 네이티브 스크립트가 원격 맥의 셸과 경로에서 실행되었습니다.
  • [ ] 캐시를 정리한 뒤 동일 커밋으로 다시 빌드했습니다.
  • [ ] 생성된 IPA와 보관 파일의 해시, 크기, 종료 상태를 기록했습니다.

여러 환경은 설정과 식별자를 함께 검증합니다

staging과 production을 나누는 프로젝트에서는 Xcode 스킴, 빌드 구성, 번들 식별자, Flutter 빌드 인자를 하나의 대응표로 관리해야 합니다. Flutter의 iOS 환경 구성 안내는 이 연결을 점검할 때 기준이 됩니다.

환경 Xcode 스킴 번들 식별자 예시 확인할 서비스 설정
테스트 Staging com.example.sample.staging 테스트 API 주소
운영 Production com.example.sample 운영 API 주소
검증용 Review com.example.sample.review 검증 서버와 기능 플래그

표의 계정과 식별자는 설명용 예시입니다. 실제 저장소에는 회사의 값을 사용하되, 자격 증명 자체는 기록하지 않아야 합니다.

환경 변수와 비민감 설정은 CI에서 주입할 수 있습니다. 인증서 개인 키, API 비밀 키, 프로비저닝 프로필은 저장소나 평문 로그에 넣지 않습니다. 각각의 환경에서 IPA를 따로 생성하고 다음을 확인해야 합니다.

  • 번들 식별자가 목표 환경과 일치하는지 확인합니다.
  • 버전과 빌드 번호가 배포 규칙에 맞는지 확인합니다.
  • 앱 내부의 API 주소와 기능 플래그가 다른 환경으로 연결되지 않는지 확인합니다.
  • 보관 파일과 IPA가 어느 커밋에서 생성됐는지 기록합니다.

서명과 테스트플라이트 업로드를 분리해 검수합니다

Flutter iOS 패키징에 맥이 반드시 필요합니까?
iOS용 보관, 서명, 배포 단계에는 macOS와 Xcode가 필요합니다. 따라서 Dart 개발을 윈도우나 리눅스에서 하더라도 최종 iOS 산출물을 만들 장소로는 지원되는 Xcode가 설치된 실제 맥을 준비해야 합니다. Flutter의 iOS 배포 문서와 애플의 업로드 절차를 기준으로 확인합니다.

개발 디버깅 서명은 로컬 확인에 적합하지만 테스트 배포와 정식 출시 서명은 별도의 자격과 권한이 필요합니다. 원격 맥의 키체인에는 필요한 인증서와 개인 키만 넣고, 작업이 끝나면 세션과 임시 파일을 정리합니다.

원격 맥에서 IPA를 만들고 테스트플라이트로 보내는 흐름은 무엇입니까?
저장소를 가져온 뒤 환경 진단과 무서명 검증 빌드를 먼저 수행합니다. 그 다음 배포 인증서와 프로비저닝 프로필을 적용해 IPA를 만들고, Xcode 보관 파일의 검증 결과와 번들 식별자를 확인한 후 업로드합니다. 업로드가 접수되었다고 끝난 것이 아니므로 앱 스토어 커넥트의 처리 상태와 오류 메시지까지 기록해야 합니다.

서명 단계 필요한 자료 통과 기준
개발 확인 개발용 인증서와 프로필 지정 기기에서 실행
테스트 배포 배포 인증서, 개인 키, 프로필 보관 파일 검증과 테스트플라이트 처리
정식 출시 운영용 식별자와 배포 권한 업로드 요구 사항 충족과 메타데이터 일치

업로드 실패 시에는 인증서를 전부 재생성하지 말고 다음 순서로 좁힙니다.

  1. 실제 사용된 번들 식별자와 프로필의 식별자를 비교합니다.
  2. 보관 파일의 서명과 권한 항목을 확인합니다.
  3. Xcode 버전, SDK, 빌드 구성, 빌드 번호를 기록합니다.
  4. 앱 스토어 커넥트가 반환한 처리 상태를 확인합니다.
  5. 특정 권한이나 네이티브 플러그인이 원인인지 분리 빌드합니다.

배포 빈도에 따라 원격 맥 운영 방식을 고릅니다

저빈도 배포라면 필요할 때 원격 맥을 빌려 환경을 확인하고 첫 보관 파일을 만드는 방식이 합리적입니다. 매일 또는 여러 개발자가 함께 배포한다면 고정 노드, 작업 격리, 재시작 복구, 캐시 정책, 서명 권한 관리가 필요합니다.

선택 기준 필요할 때 원격 맥 장기 CI 빌드 노드
배포 빈도 낮음 높음 또는 일정함
비용 구조 사용 기간 중심 상시 운영과 관리 비용 포함
환경 관리 스냅샷과 진단 기록 필요 고정 버전과 자동 복구 필요
동시 작업 제한적 대기열과 격리 설계 필요
서명 관리 작업 전 주입, 작업 후 회수 전용 키체인과 권한 정책 필요
적합한 대상 개인, 일회성 출시 팀, 반복 배포, 자동화 파이프라인

KuzCloud의 원격 맥 콘솔을 사용할 경우에도 SSH 키, 세션 권한, 작업 종료 후 파일 정리 절차를 먼저 설계해야 합니다. 연결 방식과 보안 항목은 원격 맥 사용 안내에서 확인할 수 있습니다.

장기 노드로 전환하기 전에는 같은 커밋을 두 번 빌드해 동일한 번들 식별자, 버전, 권한, 의존성 해석 결과가 나오는지 확인합니다. 무인 실행 중 실패했을 때 비밀 자료를 로그에 남기지 않고, 작업을 중단한 뒤 재시도할 수 있어야 투입 기준을 충족합니다.

기존 방식과 원격 맥을 비용 관점에서 비교합니다

개인 맥을 즉시 구매하는 방식은 장기적으로 고정된 부하와 물리 장치 접근이 필요한 팀에 맞을 수 있습니다. 그러나 일회성 출시에는 초기 하드웨어 지출, macOS와 Xcode 관리, 고장 대응, 사용하지 않는 기간의 유휴 비용이 함께 생깁니다.

방식 실제 부담 적합한 경우
윈도우 또는 리눅스만 사용 iOS 보관과 서명을 수행할 수 없음 iOS 출시가 없는 프로젝트
개인 맥 구매 초기 구매, 업데이트, 고장과 보안 관리 장기간 고정 부하와 물리 접근 필요
가상 macOS 환경 호환성, 성능, 라이선스와 도구 지원 확인 필요 제한된 검증 목적
원격 맥 임시 사용 연결 품질, 작업 기간, 비밀 자료 회수 관리 첫 출시와 저빈도 배포
원격 맥 장기 노드 고정 환경, 접근 통제, 자동 복구 운영 팀 CI와 반복 배포

현재 윈도우나 리눅스만 사용하는 방식은 iOS 도구 체인이 없고, 가상 환경은 Xcode와 플러그인 호환성 검증 부담이 남습니다. 개인 맥 구매는 사용 빈도가 낮을 때 유휴 비용과 유지 관리 책임이 커집니다. 이런 조건이라면 먼저 KuzCloud에서 root 권한이 있는 원격 맥으로 첫 Flutter iOS 보관과 업로드를 검증한 뒤, 배포 빈도가 확인될 때 장기 노드로 확장하는 편이 구매보다 위험이 낮습니다. 반대로 장기간 고정 부하가 크거나 물리 USB 장치가 반드시 필요한 프로젝트라면 직접 보유한 맥이 더 적합합니다.

최종 투입 기준은 단순히 IPA가 한 번 생성되는 것이 아닙니다. 동일 커밋에서 검증 가능한 산출물을 반복 생성하고, 서명 자료를 안전하게 주입하며, 무인 실패와 복구 절차가 기록되어야 합니다. 이 기준을 통과한 뒤에만 일회성 원격 빌드를 팀의 지속적인 CI 흐름으로 승격해야 합니다.

아이오에스 출시를 위한 원격 맥을 시작해 보세요

윈도우나 리눅스에서 개발한 플러터 앱을 KuzCloud의 원격 맥에서 안정적으로 빌드할 수 있습니다.

필요한 기간만큼 맥 환경을 이용하며 의존성 확인과 서명 설정을 실제 환경에서 점검할 수 있습니다.