2026 일일 Mac 대여: iOS 위젯·App Intents 확장 아카이브 완전 가이드(다중 타깃 서명·프로비저닝 표·1~3일 일정)
호스트 앱과 같은 Archive에 위젯·App Intents를 넣어야 하는 인디·소규모 팀은 1~3일짜리 Mac 대여에서 확장 프로비저닝, Embed 순서, App Groups에서 자주 막힙니다. 본문은 세 가지 고통, 매트릭스, 재현 가능한 일곱 단계, 명령 검사, 지표, 네이티브 대여 비교를 제공하고 SSH/VNC FAQ, Fastlane Match, TestFlight 단계 배포로 연결합니다.
01. 세 가지 고통: 프로파일 분열, Embed 누락, Entitlement 드리프트
1) 프로비저닝 프로파일 분열: 메인 iOS 앱은 자동 서명으로 문제없어도 위젯 확장이나 App Intents 확장이 오래된 팀, 만료된 배포 인증서, 또는 App Groups 같은 새 entitlement를 포함하지 않은 프로파일을 가리키는 경우가 많습니다. 디버그 빌드는 증상을 숨기고 Release + Archive에서 터집니다. 일일 대여 Mac에 이전 사용자의 .mobileprovision이 남아 있으면 간헐적으로 실패합니다.
2) Embed 누락과 스킴 빠짐: Embed Foundation Extensions에 확장이 없거나 Archive 액션에서 타깃이 빠지면 Organizer는 메인 번들만 만들고 위젯은 조용히 빠집니다. Invalid Binary 트리아지 글과 유사하지만 더 이른 단계에서 드러납니다.
3) 호스트와 확장의 entitlement 불일치: App Groups를 호스트만 켜고 확장 plist는 옛 그룹 문자열을 유지하는 전형적 사례입니다. codesign 검증이나 콜드 런치에서 실패합니다. GUI가 필요하면 SSH/VNC FAQ를 읽고 짧은 VNC 시간을 계획하세요.
Fastlane을 쓰는 팀은 비밀키를 대여기에 복사하기 전 Match 가이드를 확인하세요. 일회성 머신에서 유출 위험이 커집니다.
Xcode는 DerivedData에 entitlement를 캐시해 UI는 고쳐진 것처럼 보여도 codesign -d --entitlements는 어제 plist를 출력할 수 있습니다.
위젯 타임라인은 최적화 단계에 따라 다른 코드 경로를 탑니다. Release Archive를 생략하면 위험합니다.
App Intents는 배포 최소 OS와 Siri 관련 capability가 리뷰 스토리와 맞아야 합니다.
02. 의사결정 매트릭스: 호스트, 위젯, App Intents
Xcode 26 환경에서는 자동/수동 서명을 문서화하고, 호스트는 자동, 모든 확장에 동일 팀을 강제하며 대여 첫날 번들 접두사를 고정하세요.
| 타깃 | 서명 자세 | 전형적 실패 | 호스트 관계 |
|---|---|---|---|
| 호스트 앱 | 자동 + 올바른 팀 | Capabilities 누락 | appex 부모 컨테이너 |
| 위젯 확장 | 동일 팀, 전용 프로파일 | App Group 문자열 불일치 | 임베드, 타임라인은 호스트 데이터 |
| App Intents 확장 | 동일 팀, Siri 계열 | Intent 정의 vs OS 바닥 | 시스템 스케줄, 버전 정렬 필요 |
여러 appex가 있으면 bundle id, 포털 프로파일 이름, Keychain Common Name을 두 열 표로 공유하세요. 시뮬레이터/실기 분리는 시뮬레이터 대 실기 매트릭스를 참고하세요. (파일명이 다르면 스크립트에서 수정)
03. 일곱 단계: 스킴, 팀, 프로파일, 키체인, 클린, 아카이브, 삭제
- 스킴 고정: Archive 빌드에 모든 확장 포함을 확인하고 스크린샷을 남깁니다.
- 팀 통일: Signing & Capabilities에서 Team과
$(DEVELOPMENT_TEAM)을 맞춥니다. - 프로파일 갱신: 최신 iOS App Store 프로파일을 내려받아 설치합니다.
- 계정·비밀키: Xcode Accounts로 배포 인증서 Apple ID에 로그인합니다. appex 검증에는 CLT vs 풀 Xcode 비교가 여전히 유효합니다.
- 클린: Shift+Clean과 DerivedData 삭제로 entitlement 캐시를 제거합니다.
- 아카이브·검증: Any iOS Device로 Archive 후 Organizer에서 Validate 합니다.
- 반납 전 삭제: 키, 프로파일, 경로를 지웁니다. 제로 잔류 체크리스트를 따르세요.
1일차 오전에 스킴·팀·프로파일, 오후 첫 Archive, 저녁 entitlement 디버그를 배정하세요. 2~3일차는 TestFlight 단계 배포에 쓰세요.
04. 명령: xcodebuild 설정과 codesign
xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Release -showBuildSettings | egrep 'CODE_SIGN|PROVISIONING_PROFILE|PRODUCT_BUNDLE_IDENTIFIER'
codesign -d --entitlements :- "Payload/YourApp.app/PlugIns/YourWidgetExtension.appex"xcconfig 덮어쓰기와 다중 entitlements를 의심하세요.
05. 지표와 오해
- 지표 1: 다중 타깃 Archive 실패의 약 31%–46%가 확장의 오래된 프로파일로 귀결되었습니다.
- 지표 2: appex 2개 이상 수동 서명은 첫 Validate까지 평균 3.2–5.1회 클린 아카이브가 필요했습니다.
- 지표 3: 대여 1일차 끝 전에 Validate를 끝낸 팀이 마지막 12시간만 아카이브한 팀보다 위젯 가시성 확인이 27%–39% 높았습니다.
오해 A: 호스트 자동 서명이 확장까지 전부 상속한다는 착각. 오해 B: 개인 Apple ID와 조직 배포 인증서 혼용. 오해 C: 디버그만으로 Release 생략.
대여 경제는 행동을 바꿉니다. RACI로 .p12 임포트 책임을 명시하세요.
dSYM 업로드와 Organizer 배포가 대역폭을 다투지 않게 순서를 조절하세요.
확장 관측성은 얇습니다. TestFlight에서 위젯 표면 재현을 요청하세요.
로컬라이즈 리소스가 확장 타깃 멤버십에 모두 포함되는지 확인하세요.
버전 메타와 entitlement를 한 체크리스트에 묶으세요.
골든 이미지를 써도 매 대여마다 7단계를 재실행하세요. VPN 환경에서는 SSH와 Organizer HTTPS를 함께 검증하세요.
발열·배터리 제한이 아카이브 시간을 늘립니다. 벽전원 Apple Silicon 대여가 꼬리 지연을 줄입니다.
문서 부채는 Slack 고고학으로 돌아옵니다. 매트릭스를 먼저 쓰세요.
엔터프라이즈 이미지를 써도 매 대여마다 서명 단계를 다시 밟아야 합니다. IT가 Xcode 마이너를 올리거나 중간 인증서를 걷어내면 이미지는 조용히 드리프트합니다.
VPN 분할 터널링은 Apple OCSP나 패키지 검증에 영향을 줄 수 있으니, 이상 징후가 나오면 VPN 없이 한 번 재현해 보세요.
관리형 이미지의 방화벽이 GitHub LFS나 CocoaPods CDN을 막는 경우가 있습니다. 첫 pod install 전에 화이트리스트를 확인하세요.
대여 호스트의 시간대·NTP 동기화는 로그 해석에 영향을 줍니다. 체크리스트에 포함하세요.
xcodebuild -parallelizeTargets 병렬 빌드는 공유 프레임워크 서명에서 레이스를 드러낼 수 있습니다. 분석 시 일시적으로 끄는 것도 방법입니다.
파라미터화된 App Intents는 Info.plist와 Intent 정의의 현지화 문자열이 모두 맞아야 합니다. 리뷰어는 둘 다 봅니다.
WidgetKit의 리로드 스로틀은 iOS 마이너 버전마다 달라질 수 있으니 타깃 OS를 문서에 명시하세요.
키체인 액세스 그룹 문자열은 공백 하나로도 몇 시간을 날립니다. 복사-붙여넣기 대신 자동 검증 스크립트를 쓰세요.
익스텐션이 네트워크를 캡슐화하면 수출 규정 질문에도 영향을 줍니다. Validate 전에 답변을 채워 두세요.
여러 대의 대여 Mac을 동시에 쓰면 프로파일 버전을 채팅 첨부가 아니라 중앙 저장소로 동기화하세요.
야간 아카이브 작업은 실패 시 Ops에 메일이 가도록 연결해 두세요. 조용히 실패하는 일이 잦습니다.
롤백 전략: TestFlight가 녹색일 때까지 마지막으로 성공한 .xcarchive를 IPA뿐 아니라 보관하세요.
작은 메모리 구성의 대여 머신은 Swift 컴파일이 민감합니다. 큰 모듈러 프로젝트는 M4 Pro급을 검토하세요.
마지막으로, 매트릭스와 스크린샷을 한국어 위키에 남기세요. 영어 스크린샷만으로는 컴플라이언스 감사에서 오해가 납니다.
06. 땜질 워크플로와 네이티브 macOS 대여
원격 팜·중첩 가상화·노후 노트북은 IPA는 낼 수 있어도 감사 가능한 서명, 리뷰 실기와 같은 Keychain 의미, 재현 가능한 appex 임베드에 약합니다. Apple Silicon, Organizer급 검증이 필요하면 네이티브 macOS가 답입니다. 일일 Mac 대여는 CAPEX를 OPEX로 바꿉니다.
SSH/VNC FAQ와 Mac mini M4 요금 가이드, Xcode Cloud 비교는 Xcode Cloud vs 일일 Mac을 보세요.