Flutter 3.47 iOS CI에서 어떤 작업을 반드시 Mac에서 해야 할까? 2026 가이드
Flutter 공식 문서는 Flutter 3.47.0 릴리스 정보를 별도로 제공하며, iOS 개발 설정에는 macOS와 Xcode가 필요하다고 안내합니다(릴리스 정보, iOS 설정 안내). 따라서 Flutter 3.47 iOS CI는 전체 작업을 맥으로 옮기기보다, 일반 Dart 검사와 비 iOS 작업은 현재 환경에 두고 iOS 도구 체인·시뮬레이터·서명이 필요한 일만 macOS 노드로 보내는 구성이 적절합니다.
Flutter 개발자: 기존 개발 환경을 유지하면서 iOS 빌드와 배포를 완성하려는 경우에 유용합니다.
CI 엔지니어: 작업별 실행 환경을 나누고 실제 라우팅 결과를 검증할 기준이 필요할 때 참고할 수 있습니다.
플랫폼 담당자: 새 맥 노드나 원격 맥을 도입해야 하는지 판단하려는 경우에 적합합니다.
마지막으로 확인한 날짜: 2026년 10월 2일. Flutter의 지원 플랫폼 안내, iOS 설정 안내, iOS 배포 안내를 기준으로 확인했습니다. 배포 전에는 해당 문서의 최신 내용을 다시 점검하세요.
Flutter 3.47 iOS CI에서 Mac 경계를 정하는 기준
판단 기준은 프로젝트가 iOS를 대상으로 하는지 여부가 아니라, 각 작업이 Apple 플랫폼 도구를 실제로 호출하는지입니다. Dart 코드 검사와 일반 테스트는 작업 의존성에 따라 기존 Linux 노드에서 수행할 수 있습니다. 반면 iOS 앱 빌드, iOS Simulator 검증, 서명과 배포는 macOS 및 필요한 Xcode 환경을 갖춘 노드로 라우팅해야 합니다.
Flutter의 Dart 테스트를 Linux CI에서 실행할 수 있나요?
가능합니다. 다만 테스트가 iOS 전용 플러그인이나 네이티브 프레임워크에 접근하지 않고, 해당 노드에서 필요한 Flutter·Dart 의존성을 갖추어야 합니다. Flutter 공식 문서는 테스트를 단위 테스트, 위젯 테스트, 통합 테스트의 세 유형으로 안내합니다(테스트 개요). 테스트 종류만으로 실행 환경을 정하지 말고, 테스트가 실제로 사용하는 플랫폼 API와 플러그인을 확인하세요.
예를 들어 형식 검사, 정적 분석, 순수 Dart 로직 테스트는 기존 환경에서 실행하고, 동일 커밋의 iOS 빌드와 시뮬레이터 검증은 맥 작업으로 분리할 수 있습니다. flutter analyze나 flutter test 같은 명령을 사용하더라도, 테스트 코드가 네이티브 기능에 기대고 있다면 실행 환경을 별도로 검토해야 합니다.
코드 품질 작업은 의존성에 따라 기존 노드에 둡니다
제출 단계에서 분리할 검사
저장소의 iOS 대상 여부만 보고 모든 제출 검사에 맥 노드를 할당하면, 플랫폼 도구를 사용하지 않는 작업까지 맥 실행 대기열에 들어갑니다. 비용과 대기 시간을 줄이려면 검사 명령과 의존성을 기준으로 나누세요.
- 포맷 확인과 정적 분석: 프로젝트에서 사용하는 Flutter·Dart 도구가 설치되어 있고, iOS 도구 호출이 없다면 기존 노드에서 수행합니다.
- 순수 로직 테스트: 네이티브 플러그인이나 iOS 전용 API에 접근하지 않는 테스트는 기존 환경에 둘 수 있습니다.
- 의존성 확인: 잠금 파일과 패키지 해석 결과를 검사하되, iOS 네이티브 산출물이 필요한지 구분합니다.
- 공통 코드 테스트: Android와 Web 작업에 필요한 검사를 iOS 빌드 작업에 묶지 않습니다.
- 플러그인 통합 테스트: iOS 구현을 호출하거나 Xcode 프로젝트 설정을 확인해야 한다면 맥 검증 작업을 추가합니다.
플러그인이 들어 있으면 모든 검사를 맥에서 해야 하나요?
그렇지는 않습니다. Flutter의 플러그인 테스트 안내는 플러그인 코드를 테스트할 때 고려할 유형과 접근 방식을 다루지만, 플러그인 이름이 의존성 목록에 있다는 사실만으로 모든 Dart 검사에 iOS 환경이 필요한 것은 아닙니다(플러그인 테스트 안내). 공통 코드 테스트와 iOS 플러그인 구현 검증을 분리하고, 실패한 테스트가 실제로 네이티브 코드에 도달하는지 확인하세요.
iOS 컴파일과 시뮬레이터 검증은 맥 작업으로 분리합니다
Flutter의 공식 iOS 설정 안내는 iOS 개발에 macOS와 Xcode가 필요하다고 설명합니다. 그러므로 iOS 대상 바이너리를 빌드하거나 Xcode 프로젝트를 처리하는 작업은 macOS 노드에서 실행하도록 구성해야 합니다. 여기에는 iOS Simulator용 빌드와 시뮬레이터에서 실행하는 검증도 포함됩니다.
Flutter iOS 시뮬레이터 빌드에 macOS가 필요한가요?
iOS Simulator 대상 빌드는 Xcode 기반 iOS 도구 체인을 사용하므로 macOS 노드에 배치해야 합니다. 다만 시뮬레이터 빌드가 성공했다는 사실은 실제 기기에서의 동작이나 배포 준비까지 검증했다는 뜻이 아닙니다. Flutter는 통합 테스트를 별도 유형으로 설명하므로, 앱 실행과 사용자 흐름 검증이 필요하다면 빌드 성공과 테스트 결과를 따로 기록하세요(통합 테스트 안내).
시뮬레이터와 실제 기기 검증은 확인 범위도 다릅니다. 시뮬레이터 작업은 해당 시뮬레이터 대상의 빌드와 실행 흐름을 확인합니다. 실제 기기 시험은 기기별 동작이나 실제 배포 환경에 가까운 조건을 확인하는 별도 검증입니다. 한 단계의 성공을 전체 iOS 검수 완료로 표현하지 않는 것이 중요합니다.
서명과 배포는 권한을 분리해 실행합니다
아카이브 생성, 서명, 베타 배포와 출시 작업은 iOS용 도구 체인과 배포 권한이 필요할 수 있으므로, 이를 수행하는 단계는 맥 노드에 배치합니다. 반면 앱 코드 검사나 서명 없는 시뮬레이터 빌드까지 배포 인증 정보에 접근하게 할 이유는 없습니다.
Flutter iOS 서명과 아카이브 작업은 CI에서 어떻게 나누나요?
코드 검사와 일반 테스트, 서명 전 iOS 검증, 서명·아카이브·배포 단계를 서로 다른 작업으로 나눕니다. 서명 자격 증명은 이를 실제로 사용하는 배포 작업에만 제공하고, 그 작업의 실행 주체와 접근 가능 범위를 확인하세요. Flutter의 iOS 배포 안내와 Apple의 앱 베타 테스트 및 출시 배포 문서를 기준으로 프로젝트의 배포 절차를 점검할 수 있습니다.
아카이브 결과는 다음 실행에서도 확인할 수 있도록 작업 기록에 연결합니다. 서명 전 결과와 서명 후 산출물을 구분하고, 배포 자격 증명 없이도 가능한 검사에는 해당 정보가 전달되지 않는지 살펴보세요. 이 방식은 특정 CI 제품의 기능을 전제로 하지 않으며, 조직의 보안 정책과 저장소 권한 구조에 맞게 적용해야 합니다.
주의: 시뮬레이터 빌드 통과, 실제 기기 확인, 서명된 아카이브 생성, 배포 완료는 서로 다른 검증 결과입니다. 파이프라인 상태를 하나의 “성공”으로 뭉뚱그리지 말고 각 단계의 증거를 남기세요.
Android·Web과 iOS 작업은 실행 조건별로 병렬 배치합니다
Android와 Web용 작업은 프로젝트의 도구 요구 사항을 충족하는 기존 노드에서 실행할 수 있습니다. iOS 전용 작업만 맥으로 보내면 플랫폼별 검증을 유지하면서도 모든 커밋이 맥 대기열에 의존하는 상황을 피할 수 있습니다. 실제 분할은 CI 제품의 특정 병렬 실행 기능이 아니라 저장소와 작업의 의존 조건을 기준으로 정합니다.
저장소를 바꾸지 않고 각 플랫폼 작업이 같은 커밋을 확인하도록 구성하면 결과를 비교하기 쉽습니다. Android 테스트가 끝나기 전에 iOS 빌드가 반드시 완료되어야 하는지, Web 결과가 배포 승인에 필요한지처럼 작업 간 의존 관계도 명시하세요. 서로 독립된 작업은 별도로 실행하고, 출시 승인 단계에서 필요한 결과만 모으는 구조가 적합합니다.
팀의 노드 경계를 확인하는 목록
아래 항목에 표시하면서, 어떤 작업이 현재 환경에서 막히는지와 그 이유를 CI 로그로 확인하세요.
- [ ] 포맷, 정적 분석, Dart 테스트가 iOS 도구 체인 없이 완료되는지 확인합니다.
- [ ] iOS 빌드와 Xcode 프로젝트 처리가 macOS 노드로 전달되는지 확인합니다.
- [ ] iOS Simulator용 빌드와 시뮬레이터 실행 결과가 별도 기록으로 남는지 확인합니다.
- [ ] Swift, Objective-C 또는 iOS 플러그인 구현을 사용하는 테스트가 맥 검증에 포함되는지 확인합니다.
- [ ] 서명과 배포 자격 증명이 필요한 작업에만 제한되어 있는지 확인합니다.
- [ ] 실제 기기 검증이 필요하다면 시뮬레이터 결과와 구분해 기록합니다.
- [ ] 신규 원격 맥을 평가할 때 Xcode 도구 체인 확인, 대표 iOS 작업 실행, 자격 증명 접근 경계를 각각 검증합니다.
작업 라우팅 표로 맥 노드 필요성을 결정합니다
| 작업 유형 | 우선 배치 환경 | 결정 근거 |
|---|---|---|
| 포맷, 정적 분석, 순수 Dart 테스트 | 기존 환경 가능 | 테스트와 도구가 iOS 네이티브 의존성을 사용하지 않는지 확인합니다. |
| Android·Web 빌드 및 테스트 | 요구 도구를 갖춘 기존 환경 | 프로젝트 설정과 해당 플랫폼 도구 체인을 기준으로 합니다. |
| iOS 앱 컴파일, Xcode 프로젝트 처리 | macOS | Flutter iOS 설정에 macOS와 Xcode가 필요합니다. |
| iOS Simulator 빌드와 실행 | macOS | iOS 시뮬레이터 검증을 iOS 작업으로 분리합니다. |
| 서명, 아카이브, 베타 배포와 출시 | macOS | 배포 도구와 서명 권한이 필요한 단계만 접근을 허용합니다. |
| 검증 결과 | 확인할 수 있는 범위 | 그 결과만으로 단정할 수 없는 것 |
|---|---|---|
| Dart 검사와 일반 테스트 통과 | 검사 대상 코드와 해당 환경의 테스트 결과 | iOS 빌드나 네이티브 플러그인 동작 |
| iOS Simulator 빌드 성공 | 지정된 시뮬레이터 대상의 컴파일 결과 | 실제 기기 검수 완료나 출시 준비 완료 |
| 시뮬레이터 통합 테스트 통과 | 자동화된 앱 실행 흐름의 결과 | 모든 기기 조건에서의 동작 |
| 서명된 아카이브 생성 | 해당 작업에서 산출한 서명 결과 | 배포 승인이나 외부 출시 완료 |
| 서명·배포 단계 | 실행 환경에 둘 작업 | 접근 권한 기준 |
|---|---|---|
| 서명 전 검사 | 코드 검사, 공통 테스트, 서명 없는 빌드 | 배포 자격 증명을 전달하지 않습니다. |
| 아카이브와 서명 | iOS 아카이브 생성 및 서명 | 필요한 작업 주체만 자격 증명에 접근하도록 제한합니다. |
| 베타 배포와 출시 | 배포 승인 이후 실행하는 전송 작업 | 승인 권한과 실제 배포 권한을 구분해 관리합니다. |
기존 노드와 원격 맥 중에서 운영 방식을 고릅니다
현재 Linux 또는 다른 기존 노드만으로 Dart 검사와 공통 테스트를 처리할 수 있고, iOS 작업이 간헐적으로 필요하다면 우선 작업을 분리해 보세요. 그 뒤 실제 iOS 빌드, 시뮬레이터 검증, 서명 배포를 수행할 macOS 환경을 어떤 방식으로 마련할지 비교합니다. 원격 맥을 처음 평가할 때는 서비스 설명만으로 적합성을 확정하지 말고, 실제 계정에서 Xcode 도구 체인 확인과 대표 프로젝트 작업을 직접 검증해야 합니다.
맥을 상시 보유하는 방식은 지속적인 사용과 물리 인터페이스 접근이 중요할 때 검토할 수 있습니다. 원격 맥 임대는 iOS 작업을 위한 환경이 필요하지만 하드웨어를 직접 구매하고 관리할 필요가 없는 팀에서 후보가 될 수 있습니다. 단, 네트워크 접근, 팀의 보안 정책, 작업량과 사용 기간을 따져야 하며, 장기간 안정적인 고부하 작업이나 물리 장비 연결이 필수라면 임대가 적합하지 않을 수 있습니다.
기존 노드만 사용하는 방식은 비용과 관리 대상을 줄일 수 있지만, iOS 도구 체인 작업을 처리하지 못합니다. 따라서 현재 환경의 분석·공통 테스트는 유지하고 iOS 컴파일과 시뮬레이터, 서명 단계만 macOS로 분리하는 구성이 가능한지 먼저 확인하세요. 원격 접근과 사용 조건을 검토할 때는 KuzCloud 콘솔 안내와 한국 요금 안내를 참고할 수 있습니다.
현재 Linux 중심 흐름을 그대로 유지하면 iOS 빌드 단계에서 실행 환경이 부족하고, 모든 검사를 맥으로 옮기면 불필요한 작업까지 맥 자원을 사용하며, 자체 장비를 구매하면 관리와 운영 책임이 추가됩니다. 필요한 것이 iOS 전용 CI 작업을 위한 임시 또는 지속적인 macOS 환경이라면, 실제 작업으로 도구 체인과 접근 경계를 검증한 뒤 KuzCloud 원격 맥을 기존 노드의 보완책으로 비교해 보세요. 구매가 필요한지, 임대가 맞는지는 실제 사용 빈도와 운영 조건을 기준으로 결정하는 편이 안전합니다.
아이오에스 빌드가 필요할 때, KuzCloud 전용 맥을 활용해 보세요
실제 맥 장비에서 시뮬레이터와 서명 작업을 수행해 아이오에스 검증 환경을 마련할 수 있습니다.
전용 물리 장비와 관리자 권한으로 필요한 개발 도구를 직접 설치하고 빌드 환경을 구성할 수 있습니다.