코덤AGIC으로 자동 Capacitor iOS 빌드

iOS에서 Codemagic를 사용한 지속적인 배포

준비 사항

이 튜토리얼을 계속하기 전에…

iOS 개발자 프로그램 회원 가입
읽고 싶은 마음이 🤣…

가격에 관해 중요한 점

가격 Codemagic Action

서비스는 ‘무료’ 월 500 분의 macOS M1 분/월, 사용하는 기계에 따라 달라집니다.
우리는 macOS M1 기계를 사용할 것입니다. 스크린샷에서 가격과 제한을 확인할 수 있습니다 (가격은 이 튜토리얼이 생성된 시점의 가격으로, 미래에 변경될 수 있습니다) 요구 사항과 가격에 대해 경고한 후, 만약에 좋다면 계속하겠습니다… 이 포스트에서는 iTunes Connect에서 앱을 생성했으며, Apple 생태계의 인증서를 가지고 있다고 가정합니다. Codemagic이 모든 것을 설정해 줄 것입니다!

🔴 가격

📣 https://codemagic.io/pricing/

🤿 시작해 보세요.

이 포스트에서 따르는 단계

Codemagic과 함께 App Store Connect API 사용하기
필요 조건
App Store Connect API 키 만들기
App Store Connect API 키 사용하기
Fastlane 파일 복사하기
Codemagic 설정하기

1. Codemagic과 함께 App Store Connect API 사용하기

2021년 2월부터 모든 사용자가 App Store Connect에 로그인하기 위해 2단계 인증 또는 2단계 인증이 필요합니다. Apple ID에 대한 추가 보안层는 계정에 대한 액세스를 제한하여 계정에 대한 액세스를 보장합니다.
From 애플 지원

Getting started with match requires you to revoke your existing certificates. But no worry, you will have the new one directly.

요구 사항

To be able to use App Store Connect API, Codemagic needs 세 가지 발급자 ID

키 ID
키 파일 또는 키 내용
App Store Connect __CAPGO_KEEP_0__ 키 생성

Creating an App Store Connect API Key

1 — App Store Connect 로그인

App Store Connect three.

2 — 선택 사용자 및 접근.

애플 스토어 연결 사용자 접근

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

애플 스토어 연결 API 키

4 — API 키 생성 또는 (+) 버튼을 클릭하세요.

애플 스토어 연결 API 키 생성

5 — 키 이름을 입력하고 접근 권한을 선택하세요. 우리는 Apple Developer Program 역할 권한에 대해 더 알아보세요. App Manager 애플 스토어 연결 __CAPGO_KEEP_0__ 키 생성 이름 6 — 생성을 클릭하세요.

7 — API 키를 클릭하세요.

애플 스토어 연결 __CAPGO_KEEP_0__ 키 생성

API 키의 접근 권한은 특정 앱으로 제한할 수 없습니다.

__CAPGO_KEEP_0__ 키의 이름, 키 ID, 다운로드 링크 및 기타 정보가 페이지에 나타납니다.

애플 스토어 연결 다운로드 키

다음 세 가지 정보를 모두 가져오세요: <1> 문제 ID.
<2> 키 ID.
<3> API 키를 다운로드하려면 "API" 개인 키 다운로드"를 클릭하세요. 다운로드 링크는 개인 키가 다운로드되지 않은 경우에만 나타납니다. 애플은 개인 키의 복사본을 유지하지 않습니다. 따라서 개인 키를 한 번만 다운로드할 수 있습니다.

🔴 개인 키를 안전한 곳에 저장하세요. 키를 공유하지 마세요, 키를 code 저장소에 저장하지 마세요, 또는 code에 키를 포함하지 마세요.

API 키를 Codemagic에 추가하는 방법

Codemagic 팀 설정을 열어주세요. code 서명 식별자를 선택하세요. 인증서를 업로드하세요.
버튼을 클릭하세요. 키 추가하기 버튼을 클릭하세요.
키 이름을 입력하세요. 이 이름은 애플리케이션 설정에서 키를 참조할 때 사용됩니다. App Store Connect API key name키 이름을 입력하세요. 그리고
값을 입력하세요. Issuer ID 버튼을 클릭하세요. Key ID 버튼을 클릭하세요.
버튼을 클릭하세요. iOS 빌드용 .p8 파일을 선택하세요. 앱 스토어 연결 API 키를 다운로드한 후 파일을 업로드하세요.
클릭 Save.

앱 스토어 연결 API 키를 사용하여 코덤판지를 관리할 수 있게되었습니다. 좋습니다!

2. 인증서 및 배포 프로파일을 생성하세요.

인증서

XCode를 열고 설정 > 계정 > Apple ID > 팀 팀을 선택하세요.

Code 인증서

클릭 인증서 관리 > + Apple Distribution Apple Distribution.

그런 다음 새로운 인증서를 만들 수 있습니다.

그런 다음 키 체인으로 이동하여 인증서를 다운로드해야 합니다. .p12 파일 형식으로.

이를 위해 키 체인으로 이동하여 로그인 키 체인으로 전환하고 로그인 키 체인 탭 인증서.

인증서

그런 다음 다운로드하고 싶은 인증서를 선택할 수 있습니다. (인증서의 날짜를 확인하세요)

그런 다음 인증서 오른쪽 클릭하고 내보내기.

파일 형식 선택 개인 정보 교환 (.p12).

그것은 인증서를 다운로드 할 것입니다. .p12 파일 형태로.

프로비전 프로파일

열기 애플 개발자 그리고 올바른 팀을 선택하세요.

그런 다음 새로운 프로파일을 만들려면 +

새로운 프로파일 만들기

그리고 선택하세요. 앱 스토어 연결.

앱 스토어 연결 선택

그런 다음 올바른 앱을 선택해야 합니다. wildcard를 사용할 수 없으면서 서명이 실패할 것입니다.

올바른 앱을 선택하세요.

앞서 생성한 인증서 중 올바른 인증서를 선택하세요. (만료일이 오늘 날짜와 일치하는 날짜를 찾으세요). 계속.

올바른 인증서를 선택하세요.

마지막으로 프로필 이름을 입력하고 생성.

이름은 Codemagic에서 프로필을 식별하는 데 사용됩니다.

프로필을 생성하세요.

프로필을 다운로드할 수 있는 .mobileprovision 파일

프로필 다운로드

Code 인증서를 추가하세요.

Codemagic는 code 서명 인증서를 PKCS#12 아카이브로 업로드 할 수 있게 해줍니다. 이 아카이브에는 인증서와 개인 키가 포함되어 있어 인증서를 사용하기 위해 필요합니다. 업로드 시, Codemagic는 인증서가 암호화된 경우 인증서 암호를 제공하도록 요청하고, 고유한 Reference name,을 제공해야 합니다. 이 이름은 codemagic.yaml configuration

에서 특정 파일을 가져오기 위해 사용할 수 있습니다.
인증서 업로드
새 인증서 생성

개발자 포털에서 가져오기 Codemagic 팀 설정을 열고 codemagic.yaml 설정 Code signing identities.
>__CAPGO_KEEP_0__ 서명 식별자 iOS 인증서 탭.
인증서 파일을 업로드하려면 .p12 또는 .pem 파일을 선택하세요 또는 프레임에 드래그하여 업로드하세요.
인증서 비밀번호를 입력하세요 인증서 이름을 선택하세요 버튼을 클릭하세요.
인증서 추가 프로비전 프로파일 추가

프로비전 프로파일 추가

Codemagic은 애플리케이션을 위한 프로비저닝 프로파일을 업로드하거나 애플 개발자 포털에서 프로파일을 가져올 수 있게 해줍니다.

Code에 추가된 프로파일의 유형, 팀, 번들 ID, 만료일이 표시됩니다. 또한, Codemagic은 code 서명 인증서가 Code 서명 식별자에 존재하는지 알려줍니다 (인증서 필드의 녹색 체크마크). 3. Codemagic 설정 Codemagic 비밀 설정

프로젝트의 비밀 값이 어디서 오는지 궁금하셨나요? 비밀은 더 이상 비밀이 아닙니다 – 그것은 프로젝트의 비밀에서 오는 것입니다.

4. Codemagic 워크플로 파일 설정

프로젝트의 루트 디렉토리에 파일명을 __CAPGO_KEEP_0__으로 지정한 후 다음을 추가하세요. ENV 이 워크플로는 수동으로 또는 각 __CAPGO_KEEP_0__ 후에 트리거되어야 합니다.

트리거

서명 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

This workflow should be triggered manually or after each GitHub 태그, 자동 태그화가 필요하다면, Automatic build and release with GitHub actions 먼저 이 워크플로우는 NodeJS 의존성을 가져와,

그리고 자바스크립트 앱을 빌드합니다.

각각의 새로운 태그를 전송할 때마다, 테스트 플라이트에서 릴리즈가 빌드됩니다.

Your App doesn’t need to use Ionic, only Capacitor base is mandatory, it can have old Cordova module, but Capacitor JS plugin should be preferred.

기본은 필수이며,

기존의 코르도바 모듈을 사용할 수 있지만,

JS 플러그인은 선호됩니다. main 5. 워크플로우 트리거 development 워크플로우를 트리거합니다. 또는,

시작한 커밋

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

테스트 플라이트 대시보드

수동으로 시작

워크플로우를 수동으로 시작할 수 있습니다.

먼저 빌드하고 싶은 앱을 선택한 후 페이지/영역: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_first` (네이티브 빌드 빌더 크레딧 퍼스트)..

새 빌드를 시작

앱 선택

빌드하고 싶은 branch를 선택

branch 선택 그리고 클릭하여.

그런 다음 빌드 목록으로 이동하세요.

빌드 목록

그리고 결과를 볼 수 있는 빌드를 클릭하세요.

빌드 결과

로컬 머신에서 배포할 수 있습니다.

네, 가능합니다. 그리고 그것은 매우 쉬워요.

Xcode를 사용하여 앱을 빌드하고 서명할 수 있습니다. 항상 그대로입니다.

감사합니다.

이 블로그는 다음 기사에 기반하고 있습니다.

자동 Capacitor iOS 빌드에 Codemagic으로 계속 진행하세요

만약 __CAPGO_KEEP_0__ iOS 빌드에 Codemagic을 사용하고 있다면 Capacitor iOS 빌드에 Codemagic을 사용하여 CI/CD 자동화 계획을 만드는 경우 __CAPGO_KEEP_0__ CI/CD Capgo CI/CD에서 제품 워크플로우 Capgo 네이티브 빌드 Capgo 네이티브 빌드에서 제품 워크플로우 Capgo 통합 Capgo 통합에서 제품 워크플로우 for the product workflow in Capgo Integrations, CI/CD 통합의 구현 세부 사항 __CAPGO_KEEP_0__ CI/CD 통합 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항을 위해.

자동 Capacitor IOS 빌드와 Codemagic