Codemagic을 이용한 iOS Continuous Delivery
사전 요구사항
튜토리얼을 계속하기 전에…
- iOS 개발자 프로그램 멤버십.
- 읽고 싶은 마음 😆…
가격 관련 중요 사항

이 서비스는 '무료'이며, 선택한 머신에 따라 매월 macOS M1 500분까지 제공됩니다.
저희는 macOS M1 머신을 사용할 예정이며, 스크린샷에서 가격과 제한 사항을 확인할 수 있습니다 (가격은 튜토리얼 작성 시점 기준이며 향후 변경될 수 있습니다).
🔴 요구 사항과 가격을 확인했으니, 괜찮으시면 계속 진행하겠습니다…
📣 이 글에서는 iTunes Connect에 앱이 생성되어 있고 Apple 생태계의 인증서가 준비되어 있다고 가정합니다. 모든 설정은 Codemagic이 처리합니다!
시작해 볼까요 🤿
포스트에서 따를 단계
- Codemagic에서 App Store Connect API 사용
- 요구 사항
- App Store Connect API 키 생성하기
- App Store Connect API Key 사용하기
- Fastlane 파일 복사
- Codemagic 설정
1. Codemagic에서 App Store Connect API 사용
2021년 2월부터 App Store Connect에 로그인하려면 모든 사용자에게 2단계 인증이 필요합니다. Apple ID에 대한 이 추가 보안 계층은 귀하만이 계정에 접근할 수 있도록 보장하는 데 도움이 됩니다.
다음 경로에서 Apple 지원
match를 시작하려면 기존 인증서를 폐기해야 합니다. 걱정하지 마세요, 새 인증서가 바로 발급됩니다.
요구 사항
App Store Connect API를 사용하려면 Codemagic에는 세 가지 가 필요합니다.
- 발행자 ID.
- Key ID.
- Key 파일 또는 Key 콘텐츠.
App Store Connect API 키 생성하기
키를 생성하려면 App Store Connect에서 Admin 권한이 필요합니다. 해당 권한이 없다면 관련 담당자에게 이 문서를 공유하고 아래 지침을 따르도록 안내하세요.
1 — 로그인 App Store Connect.
2 — 선택 사용자 및 액세스.

3 — API Keys 탭을 선택하세요.

4 — Generate API Key 또는 추가(+) 버튼을 클릭하세요.

5 — 키 이름을 입력하고 접근 수준을 선택하세요. 다음을 선택하는 것을 권장합니다. App Manager 접근 권한, Apple Developer Program 역할 권한에 대해 자세히 보기 여기

6 — Generate 클릭.
API 키의 액세스 권한은 특정 앱으로 제한할 수 없습니다.
새 키의 이름, 키 ID, 다운로드 링크 및 기타 정보가 페이지에 표시됩니다.

여기서 필요한 세 가지 정보를 확인하세요:
<1> Issue ID.
<2> Key ID.
<3> “Download API Key”를 클릭해 API private key를 다운로드하세요. 다운로드 링크는 private key를 아직 다운로드하지 않은 경우에만 표시됩니다. Apple은 private key 사본을 보관하지 않으므로 한 번만 다운로드할 수 있습니다.
🔴 private key는 안전한 곳에 보관하세요. 키를 절대 공유하거나, code repository에 저장하거나, 클라이언트 측 code에 포함해서는 안 됩니다.
Codemagic에 App Store Connect API 키 추가
-
Codemagic 팀 설정을 엽니다.
code 서명 ID 선택
그리고 인증서 업로드

-
Members 섹션에서 키 추가 버튼을 클릭하세요.
-
다음을 입력하세요:
App Store Connect API key name. 이는 나중에 애플리케이션 설정에서 키를 참조할 때 사용할 사람이 읽을 수 있는 이름입니다. -
다음을 입력하세요:
Issuer ID및Key ID값입니다. -
클릭하세요 .p8 파일 선택 또는 파일을 드래그하여 이전에 다운로드한 App Store Connect API 키를 업로드하세요.
-
클릭 저장.
이제 App Store Connect API 키로 Codemagic을 관리할 수 있습니다. 훌륭하네요!
2. 인증서 및 프로비저닝 프로필 생성
인증서
Xcode를 열고 설정 > 계정 > Apple ID > 팀 에서 팀을 선택하세요.

클릭하세요 인증서 관리 > + 를 선택한 후 Apple Distribution.

을 선택하면 새 인증서를 생성할 수 있습니다.
그다음 키체인으로 이동해 인증서를 다음 형식으로 다운로드해야 합니다. .p12 다운로드됩니다.
이렇게 하려면 키체인으로 이동해 다음으로 전환해야 합니다. 로그인 키체인으로 이동한 다음 탭 My Certificates에서.

그다음 다운로드할 인증서를 선택할 수 있습니다. (인증서 날짜를 기준으로 확인하세요)
그 후 인증서를 우클릭하여 다음을 선택하세요 내보내기.
파일 형식 선택 개인 정보 교환 (.p12).
그러면 인증서가 파일로 .p12 다운로드됩니다.
Provisioning 프로파일
열기 Apple Developer 그리고 올바른 팀을 선택하세요.
그런 다음, 다음을 클릭해 새 프로필을 만드세요. +

그리고 다음을 선택하세요. App Store Connect.

그런 다음 올바른 앱을 선택해야 합니다. 와일드카드는 사용할 수 없으며, 사용하면 서명이 실패하니 주의하세요.

이전에 생성한 올바른 인증서를 선택하세요(만료 날짜가 오늘과 같은지 확인)하고 클릭하세요 계속.

마지막으로 프로파일 이름을 입력하고 클릭하세요 생성.
이 이름은 Codemagic에서 프로필을 식별하는 데 사용됩니다.

프로파일을 다음 형식으로 다운로드할 수 있습니다 .mobileprovision 다운로드됩니다.

Code 서명 인증서 추가
Codemagic는 인증서와 사용에 필요한 개인 키가 모두 포함된 PKCS#12 아카이브 형식으로 code 서명 인증서를 업로드할 수 있습니다. 업로드 시 Codemagic은 인증서 비밀번호(비밀번호 보호가 된 경우)와 고유한 참조 이름을(를) 입력하라고 요청하며, 이는 codemagic.yaml 설정에서 특정 파일을 가져오는 데 사용할 수 있습니다.
- 인증서 업로드
- 새 인증서 생성
- Developer Portal에서 가져오기
- Codemagic 팀 설정을 열고 codemagic.yaml 설정 > Code 서명 ID.
- 열기 iOS 인증서 탭에 머무르세요.
- 클릭하여 인증서 파일을 업로드하세요 .p12 또는 .pem 파일 선택 또는 지정된 영역으로 드래그하세요.
- 다음을 입력하세요: 인증서 비밀번호 그리고 다음을 선택하세요 참조 이름.
- 클릭 인증서 추가
프로비저닝 프로필 추가
Codemagic에서는 애플리케이션에 사용할 프로비저닝 프로필을 업로드하거나 Apple Developer Portal에서 프로필을 가져올 수 있습니다.
추가된 각 프로필의 유형, 팀, 번들 ID, 만료일이 Code 서명 신원 목록에 표시됩니다. 또한 Codemagic은 Code 서명 신원에 일치하는 code 서명 인증서가 있는지 알려줍니다(( 인증서 필드에 녹색 체크 표시가 있는 경우)
3. Codemagic 설정
Codemagic 시크릿 구성
값이 어디에서 오는지 궁금한 적 있으신가요? ENV 비밀이 아닙니다 – 프로젝트의 시크릿에서 가져온 것입니다. 🤦
4. Codemagic 워크플로 파일 구성
다음과 같은 이름의 파일을 생성하세요. codemagic.yml 프로젝트 루트에 파일을 추가하고 아래 내용을 넣으세요.
workflows:
ionic-capacitor-ios-workflow:
name: Capacitor iOS Workflow
max_build_duration: 120
instance_type: mac_mini_m1
integrations:
app_store_connect: CodeMagic
environment:
ios_signing:
distribution_type: app_store
bundle_identifier: YOUR_BUNDLE_IDENTIFIER
vars:
XCODE_WORKSPACE: ios/App/App.xcworkspace
XCODE_SCHEME: App
APP_STORE_APP_ID: YOUR_APP_STORE_APP_ID
node: v20.14.0
xcode: 15.4
cocoapods: default
triggering:
events:
- tag
tag_patterns:
- pattern: '*'
include: true
scripts:
- name: Install dependencies
script: |
npm install
- name: Cocoapods installation
script: |
cd ios/App && pod install
- name: Update dependencies and copy web assets to native project
script: |
npm run build
npx cap sync ios
- name: Set up code signing settings on Xcode project
script: |
xcode-project use-profiles
- name: Increment build number
script: |
cd $CM_BUILD_DIR/ios/App
LATEST_BUILD_NUMBER=$(app-store-connect get-latest-app-store-build-number "$APP_ID")
agvtool new-version -all $(($LATEST_BUILD_NUMBER + 1))
- name: Build ipa for distribution
script: |
xcode-project build-ipa \
--workspace "$XCODE_WORKSPACE" \
--scheme "$XCODE_SCHEME"
artifacts:
- build/ios/ipa/*.ipa
- /tmp/xcodebuild_logs/*.log
- $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.app
- $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.dSYM
publishing:
email:
recipients:
- YOUR_EMAIL
notify:
success: true # To not receive a notification when a build succeeds
failure: false # To not receive a notification when a build fails
app_store_connect:
auth: integration
# Configuration related to TestFlight (optional)
# Note: This action is performed during post-processing.
submit_to_testflight: true
# Configuration related to App Store (optional)
# Note: This action is performed during post-processing.
submit_to_app_store: false
이 워크플로우는 수동으로 또는 각 GitHub 이후에 트리거되어야 합니다. 태그가 있습니다tag 자동화가 필요하면 다음을 참고하세요: GitHub actions를 이용한 자동 빌드 및 릴리스 먼저.
그다음 이 워크플로우가 NodeJS 의존성을 가져와 설치하고 JavaScript 앱을 빌드합니다.
새 태그를 보내는 때마다 TestFlight에서 릴리스가 빌드됩니다.
앱은 Ionic을 사용할 필요가 없으며, Capacitor 기반만 필수입니다. 기존 Cordova 모듈을 사용할 수 있지만, Capacitor JS 플러그인을 사용하는 것이 좋습니다.
5. 워크플로우 트리거
워크플로우 트리거
브랜치에 새 커밋을 푸시하세요 main 또는 development 워크플로우를 트리거합니다.

몇 분 후, 빌드가 App Store Connect 대시보드에서 사용 가능해야 합니다.

수동으로 시작
워크플로우를 수동으로 시작할 수 있습니다.
빌드할 앱을 선택한 후, 다음을 클릭하세요 새 빌드 시작.

빌드할 브랜치를 선택하세요.

그리고 클릭 새 빌드 시작.
그 다음 빌드 목록으로 이동

빌드를 클릭하여 결과를 확인하세요.

로컬 머신에서 배포 가능
네, 가능합니다. 매우 간단합니다.
항상 그랬듯 Xcode로 앱을 빌드하고 서명할 수 있습니다.
감사합니다
이 블로그는 다음 아티클을 기반으로 작성되었습니다:
Codemagic를 활용한 자동 Capacitor iOS 빌드 계속하기
사용 중이라면 Codemagic으로 자동 Capacitor iOS build하기 CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.