iOS 빌드

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사합니다.

TestFlight 및 App Store로 iOS 앱을 빌드하고 제출하는 데 Capgo의 전용 Mac 인프라를 사용합니다.

학습할 내용

Capgo Native 빌드를 통해 앱을 업로드하는 방법을 배웁니다.
Capgo Native Build 인증서를 구성하는 방법을 배울 것입니다.

준비 사항

Capgo 계정 (무료试用도 시작하기에 충분합니다)
Capgo에 이미 앱이 등록되어 있습니다 (run, 만약에) bunx @capgo/cli@latest app add Mac 컴퓨터에 Xcode가 설치되어 있습니다 (linux/windows 머신에서 빌드를 설정할 수 있지만, 아직 문서화되지 않았습니다)
유효한 Apple Developer 계정 ($99/년) (Apple Developer 계정에 관리자 또는 소유권이 있어야합니다)
Xcode를 통해 앱이 성공적으로 빌드될 수 있어야합니다
__CAPGO_KEEP_0__ 앱
Capacitor 앱에 구성된 아이콘. 아이콘을 없는 앱은 앱 스토어에 업로드할 수 없습니다.
주의

애플의 포털에서 시작하기 전에

애플 계정과 팀이 준비되어 있는지 확인하기 전에 테스트 플라이트 업로드를 트리거하거나 인증서를 설정하지 마십시오:

애플 계정에 2단계 인증을 활성화하십시오.
적절한 회원 유형을 선택하십시오:
- 개인/개인 사업자: 판매자 이름은 앱 스토어에서 개인의 법적 이름이 됩니다.
- 단체: 법적 엔터프라이즈, D-U-N-S 번호, 공공 회사 웹사이트, 회사 도메인에 있는 이메일, 그리고 애플의 계약에 대한 권한을 부여할 수 있는 사람
Apple 개발자 및 App Store Connect에 접근할 수 있는 계정을 사용하여 인증서, 앱 레코드, API 키, 및 테스트 플라이트를 사용하세요.
최종 번들 ID를 일찍 결정하세요. 변경하는 경우 일반적으로 App Store 설정을 다시 시작해야 합니다.
App Review 전에 App Store Connect 항목을 계획하세요: 지원 URL, 개인 정보 정책 URL, 연령 등급, 스크린샷, 수출 준수, 및 App Review 연락처 정보

Capgo의 자동 등록 기능을 복사

bunx @capgo/cli@latest build init --platform ios

아래의 수동_walkthrough는 자체적으로 인증 정보를 설정하는 사람들만을 위한 것입니다. 또는 Capgo이 하드웨어 아래에서 정확히 무엇을하는지 이해하고 싶은 사람들.

첫 번째 수동 빌드

앱을 Capgo으로 빌드하기 전에 생각할 수 있는 것들에 대해 생각하기 전에, 우리는 먼저 Capgo을 설정하고, 수동으로 첫 번째 테스트 플라이트 빌드를 해야합니다. 수동 빌드를 하는 것은 몇 가지 이점이 있습니다:

__CAPGO_KEEP_0__에 관련된 빌드 프로세스와 관련된 문제를 해결할 수 있습니다.
__CAPGO_KEEP_0__에 대한 App Store 기록을 만듭니다. 만약 이미 만들지 않았다면.
You will be able to figure out any issues with the build process linked to your app code

앱 __CAPGO_KEEP_0__에 관련된 문제를 해결할 수 있습니다.

앱 __CAPGO_KEEP_0__에 대한 App Store 기록을 만듭니다.

앱 __CAPGO_KEEP_0__에 대한 빌드 프로세스와 관련된 문제를 해결할 수 있습니다.
Xcode를 열어주세요. Xcode -> Settings... 대안적으로, 단축키를 사용할 수 있습니다. Cmd + ,
Xcode로 이동하세요. Accounts
Xcode에서 선택한 Apple 계정
Xcode에서 팀 찾기
Xcode에서 인증서 관리 Manage Certificates... 배포 인증서가 목록에 보이도록 확인하세요.
__CAPGO_KEEP_0__
인증서가 없다면 새로운 인증서를 생성해야 합니다.

애플은 3개의 배포 인증서만 허용합니다. 3개 이상의 인증서가 있다면 하나를 삭제해야 새로운 인증서를 생성할 수 있습니다. 이 튜토리얼에서는 삭제 과정을 다루지 않습니다.
1. 버튼을 클릭하고 다음에 + Xcode 인증서 추가 Apple Distribution
2. 배포 인증서를 설치한 후에 빌드 프로세스를 시작할 수 있습니다.

수동 빌드 (테스트 플라이트)

Xcode에서 앱을 열기

실행 bunx cap open ios Xcode에서 앱을 열기.
버튼을 찾고 클릭하세요. archive 버튼

Xcode 도구栏에서 버튼을 찾고 클릭하세요. product -> archive 버튼.
빌드를 완료하기까지 기다리세요.
버튼 Distribute App Xcode 배포 버튼
배포 방법을 선택하고 TestFlight Internal Only 클릭하세요. Distribute 버튼
앱 기록을 설정하세요.

다음 필드를 입력하세요:
1. 이름: 앱 이름 - 앱 스토어에서 표시됩니다.
2. SKU - 앱의 SKU - 앱 스토어에서 앱을 식별하는 데 사용됩니다.
3. 기본 언어 - 앱의 기본 언어.
그다음에 next 버튼
If the creation of the app record fails, try to close the window and try to archive the app again.
업로드를 완료하기까지 기다려 주세요.
If everything went well, you should see the following screen
클릭하세요. Done 버튼

You may instinctively think that all is good now and that you will be able to see your app in TestFlight now, but there are a few more things still to finish:

TestFlight에 자신을 추가하세요.
제품이 테스트가 가능하도록 빌드가 완료되도록 수출 규정 완료
App Store Connect에서 지원 URL, 개인 정보 보호 정책 URL, 연령 등 필수 메타데이터를 입력하세요.
실제로 지원하는 기기와 일치하는 스크린샷을 준비하세요.
App Review에 연락처 정보와 테스트 자격증명을 추가하세요. 그리고 제품 제출 전에 준비하세요.

Let’s start with the first one:

TestFlight에 가입하는 방법

App Store Connect로 이동하세요. App Store Connect 페이지
Apple Developer 계정으로 로그인하세요.
팀을 선택하세요. 앱 레코드를 만들 때 사용한 팀을 선택하세요. 단, 단 하나의 개발자 계정이면 이 단계를 건너뛸 수 있습니다.
버튼을 클릭하세요. Apps __CAPGO_KEEP_0__
앞서서 단계에서 생성한 앱을 찾고 클릭하세요
클릭하세요. TestFlight 버튼
클릭하세요. Internal Testers plus 버튼
새 그룹 만들기

내부 그룹이라고 이름을 지어주지만 원하는 이름으로 지어도 됩니다.
클릭 Invite testers 버튼
그룹에 자신을 추가하세요

자신의 이름 옆에 체크박스를 선택하세요. (자신을 확인하려면 페이지를 새로 고쳐야 할 수 있습니다) 그 다음, Add 버튼을 클릭하세요.
자신이 그룹에 추가되었는지 확인하세요

자신이 그룹에 추가되었으므로 이제는 다음 단계만 수행하면 됩니다.

Congratulations 🎉 You have added yourself to TestFlight. Now, there is just one more thing you need to do before you can configure Capgo Native Build.

App Store Connect invite testers button

애플에 앱이 표준 암호화 알고리즘을 사용한다는 것을 약속해야 합니다. 앱이 표준 암호화 알고리즘을 사용하지 않는다면, Apple 문서 표준 암호화 알고리즘을 사용하지 않는 경우의 처리 방법

이 방법은 두 가지가 있습니다.
이 방법을 사용하려면 매번 앱을 빌드할 때마다 수동으로 처리해야 합니다. false.

plist 파일을 구성하여 자동으로 이 값을 설정할 수 있습니다.

이 방법부터 시작해 보겠습니다.
앱 스토어 연결의 테스트 플라이트 섹션을 찾는 방법에 대한 이전 섹션의 모든 단계를 따르세요. Builds -> iOS
비교 정보가 누락된 빌드를 찾고 클릭하세요. Manage
선택한 옵션은 앱의 특성을 가장 잘 설명합니다.

나는 이 것을 none하지만, 당신에게는 다를 수 있습니다. 그 다음, 저장을 클릭하세요.
앱이 이제는 ready to test

두 번째 옵션에 대해, 다음 단계를 따라하세요:

열기 Info.plist 파일

다음 키를 추가하세요:

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

파일을 저장

TestFlight 앱을 설치하고 초대장을 수락하는

이제 거의 준비가 끝났습니다. TestFlight에서 앱을 테스트하기 위해

다운로드할 TestFlight 앱 App Store에서 iOS/iPadOS 기기에서
초대장을 수락하여 앱을 테스트하세요

TestFlight 앱을 장치에 설치하는 방법의 세부 사항은 생략하겠습니다. 앱을 설치하는 방법에 대해 확신하지 못한다면 Google은 이를 수행하는 방법에 대한 훌륭한 지침을 제공합니다.

초대장을 수락하는 경우 애플에서 초대장을 수락하기 위한 링크가 포함된 이메일을 받게 됩니다.

애플에서 초대장을 수락하기 위한 링크가 포함된 이메일을 열어보세요
클릭하세요 View in TestFlight 초대장 이메일 버튼
버튼 Install TestFlight 설치 버튼
Xcode를 사용하여 앱을 이전에 설치한 경우 다음 화면을 볼 수 있습니다. 버튼을 클릭하세요.

button install 버튼.
앱을 설치 기다려 주세요
버튼을 클릭하고 클릭하세요 Open 축하합니다 🎉 테스트 플라이트에서 앱 테스트에 대한 초대를 수락했습니다. 이제 __CAPGO_KEEP_0__ 네이티브 빌드를 구성하여 테스트 플라이트로 앱을 제출할 수 있습니다.

Capgo 네이티브 빌드 구성

제목 ‘Capgo 네이티브 빌드 구성’

There are a few things you need to configure in Capgo Native Build to be able to build and submit your app to TestFlight. Here is a list of the things you will pass to the Capgo CLI:

설명	빌드할 플랫폼
`--platform`	설정`ios`)
`--apple-team-id`	Your Apple Developer Team ID (found in 애플 개발자 포털)
`--apple-key`	Path to your App Store Connect API Key file (`.p8` 파일)
`--apple-key-id`	The Key ID of your App Store Connect API Key
`--apple-issuer-id`	앱 스토어 연결 Key의 키 ID
`--certificate`	Your App Store Connect Issuer ID`.p12` 앱 스토어 연결 발급자 ID
`--ios-provisioning-profile`	Path to your distribution certificate (`bundleId=path` 파일)

Provisioning profile mapping (

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile '/path/to/profile.mobileprovision'

팀 ID

팀 ID를 찾는 건 매우 쉬울 것입니다.

Apple Developer 계정으로 이동 Apple Developer 계정으로 이동 Apple Developer 계정에서 아래로 스크롤
팀 ID 위치 찾기 Team ID

Apple 키

Apple 키 ID

App Store Connect 사용자 및 접근 페이지 주의

Select the correct team in the dropdown
Select the correct team in the dropdown
1. 위치한 오른쪽 상단의 이름을 클릭하세요
2. 사용하고 싶은 팀을 클릭하세요
클릭하세요 Integrations 버튼
이 issuer

이는 나중에 필요하므로 저장하세요 __CAPGO_KEEP_0__ 앱 스토어 연결 통합 버튼

클릭하여 발급자 복사 copy 발급자 복사 버튼을 클릭하세요
클릭하여 플러스 버튼
키 이름을 설정하고 액세스 권한을 설정하고 App manager 앱 매니저 액세스 권한을 설정하고 키 ID를 생성하세요 Generate 키 ID를 저장하세요
주의

이것은 저장해야 합니다 - 나중에 필요할 것입니다
키를 다운로드하세요

이것은 저장해야 합니다 - 나중에 필요할 것입니다

누군가에게 키를 공유하지 마세요 - CAPGO CLI 에서만 사용하세요.

축하합니다 🎉 애플 키, 애플 키 ID 및 애플 발급자 ID를 생성했습니다.

인증서

인증서를 내보내려면 이제 준비가 되었습니다. 이 가이드의 첫 번째 단계 중 하나는 배포 인증서를 설정하는 것이었습니다.

그러나 애플은 무한한 지혜로 결정했습니다. 인증서를 내보내는 방법은 인증서를 만들 때와는 다르다는 것을 기억하세요 🙃 설정에 들어가 보겠습니다:

키 체인 액세스 열기
1. 클릭 Command + Space 검색 바를 열기
2. 검색 Keychain Access
3. Click on the Keychain Access app
Select the login category and click on the My Certificates button
Find your certificate in the list

The certificate should be named Apple Distribution: [Your Name/Company] (your team ID)
Right-click on the certificate and select Export
인증서를 저장하세요. .p12 파일

이 __CAPGO_KEEP_0__ - 나중에 필요할 것입니다.
1. 인증서 파일의 이름을 잘 선택하세요.
2. 파일 형식이 Personal Information Exchange (.p12)
3. 버튼 Save 인증서 저장 dialog
비밀번호를 묻는 경우, 다음 중 하나를 선택할 수 있습니다:
- 비밀번호를 생략 (간결함을 위해 권장): 비밀번호를 입력하지 않고 OK 클릭합니다.
- 비밀번호 설정: 비밀번호로 인증서를 보호하는 것을 선호하는 경우, 비밀번호를 설정할 수 있습니다. 비밀번호로 보호된 .p12 파일은 Capgo CLI에 의해 완전히 지원됩니다. - 비밀번호를 제공하기 위해 --p12-password 설정 명령어를 실행할 때 옵션을 사용하십시오.
로그인 키체인 비밀번호를 묻는 경우, Mac에 로그인하는 데 사용하는 비밀번호를 입력하십시오.

Mac에 로그인하는 데 사용하는 비밀번호를 입력하십시오. 그런 다음 Allow 버튼을 클릭하십시오.

축하합니다! 🎉 인증서를 성공적으로 내보냈습니다.

__CAPGO_KEEP_0__

애플에서 마지막으로 필요한 것을 받을 수 있도록 준비되었습니다.

애플 개발자 프로파일로 이동하세요. 적절한 팀을 드롭다운에서 선택하세요.
__CAPGO_KEEP_2__
1. __CAPGO_KEEP_3__
2. __CAPGO_KEEP_4__
적절한 페이지인지 확인하세요. 이런 모습이면 좋습니다. 그렇지 않다면 profiles 사이드바의
클릭하여 + 버튼
프로필 유형을 선택하세요 선택 App Store Connect 및 클릭하여 Continue 버튼
빌드하고 싶은 앱을 선택하세요

다운로드 메뉴에서 앱을 찾고 클릭하여 Continue 버튼
정확한 배포 인증서를 선택하세요

이전 단계에서 내보낸 인증서를 선택하고 버튼을 클릭하세요. Continue __CAPGO_KEEP_0__

선택할 인증서가 확실하지 않다면, Keychain Access로 돌아가서 내보낸 인증서를 찾으세요. 그 다음 만료일을 확인하세요.
프로파일 이름을 지어주세요.

프로파일 이름을 지어주세요. 그리고 버튼을 클릭하세요. Generate 팁

The profile name is automatically extracted by the Capgo CLI — you don’t need to remember it.
프로필 다운로드

다운로드 프로필을 클릭하세요 Download 다운로드 프로필을 다운로드하려면 버튼을 클릭하세요

이 파일 이 파일은 저장해야 합니다 - 나중에 필요하니 저장하세요

축하합니다 🎉 Capgo Native Build을 구성하기 위해 필요한 모든 것을 이제 가지고 있습니다.

설정 명령어를 실행합니다.

축하합니다! Capgo Native Build을 설정하기 위해 필요한 모든 것을 얻으셨습니다.

실행할 명령어는 다음과 같습니다.

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id UVTJ336J2D \
  --apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \
  --apple-key-id 66FGQZB566 \
  --apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \
  --certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \
  --ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision

모든 것이 잘 되었으면 다음 출력을 볼 수 있을 것입니다:

Capgo CLI 인증서 저장 출력

CI/CD 설정 (GitHub Actions)

CI/CD 설정을 이미 완료했다면 팀 ID, Apple 키, Apple 키 ID 및 Apple 발급자 ID, 인증서, 및 배포 프로파일, CI/CD를 위해 이미 필요한 모든 것을 가지고 있습니다. 이 섹션은 CI/CD를 위해 GitHub Actions 비밀과 환경 변수로 값을 전달하는 방법만 설명합니다.

1) __CAPGO_KEEP_0__ 인증 파일을 단일 줄 base64로 변환하세요.

# Distribution certificate (.p12)
base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt

# Provisioning profile (.mobileprovision)
base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt

# App Store Connect API key (.p8)
base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt

2) 저장소 비밀을 생성하세요.

내 GitHub > Repository > Settings > Secrets and variables > Actions, 추가:

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ __CAPGO_KEEP_0__	__CAPGO_KEEP_2__
`CAPGO_TOKEN`	Your Capgo API token
`APP_STORE_CONNECT_TEAM_ID`	__CAPGO_KEEP_6__ __CAPGO_KEEP_7__ __CAPGO_KEEP_8__
`APPLE_KEY_ID`	__CAPGO_KEEP_9__ __CAPGO_KEEP_10__ __CAPGO_KEEP_11__ __CAPGO_KEEP_12__와 __CAPGO_KEEP_13__ __CAPGO_KEEP_14__ __CAPGO_KEEP_15__
`APPLE_ISSUER_ID`	__CAPGO_KEEP_16__ __CAPGO_KEEP_17__ __CAPGO_KEEP_11__ __CAPGO_KEEP_12__와 __CAPGO_KEEP_13__ __CAPGO_KEEP_14__ __CAPGO_KEEP_15__
`BUILD_CERTIFICATE_BASE64`	__CAPGO_KEEP_18__의 내용 `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	CLI에서 생성된 — CLI에서 복사 `.capgo-credentials` __CAPGO_KEEP_19__
`APPLE_KEY_CONTENT`	내용 `apple_key_base64.txt`
`P12_PASSWORD` (선택)	당신의 `.p12` 패스워드가 설정된 경우 내보내기 중 export

3) Actions 워크플로우에서 GitHub에서 환경 변수를 사용하세요

name: iOS Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  ios-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS build with Capgo
        run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}

빌드 실행

현재 당신은 첫 번째 빌드를 실행할 준비가 되었습니다.

아래 명령어를 실행하여 앱을 빌드하세요:

bunx @capgo/cli@latest build request --platform ios

축하합니다 🎉 이제 앱 빌드가 성공적으로 완료되었으며 앱 스토어에 제출할 준비가 되었습니다.

앱 스토어 리뷰 제출

일반적인 앱 스토어 빌드 경로는 빌드를 앱 스토어 연결/테스트 플라이트에 업로드합니다. CI 릴리즈에서 처리된 테스트 플라이트 빌드를 앱 스토어 버전과 함께 첨부하고 리뷰에 제출하려면 --submit-to-store-review 릴리즈 빌드와 함께

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --ios-distribution app_store \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

App Store Connect API 인증 정보 (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, 및 APP_STORE_CONNECT_TEAM_ID)가 필요합니다. App-specific password 업로드 및 ad_hoc 배포는 검토를 위해 빌드를 제출할 수 없습니다. --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION 수동으로 배포하기 위해 기다릴 수 있습니다. --store-release-notes 외부 베타 배포에 사용할 수 있지만 App Store 검토 제출에는 필요하지 않습니다. --store-release-notes-locale "locale=notes" Ad-Hoc 배포 모드 --ios-automatic-release App Store Connect __CAPGO_KEEP_0__ 인증 정보 ( --no-ios-automatic-release , 및 --ios-testflight-groups )가 필요합니다. App-specific password 업로드 및

배포는 검토를 위해 빌드를 제출할 수 없습니다.

기본적으로 Capgo은 iOS 앱을 App Store 배포 (TestFlight + App Store) 용으로 빌드합니다. 내부 테스트 또는 CI 아티팩트 수집을 위해 ad-hoc 빌드를 필요로 한다면, flag를 사용할 수 있습니다. --ios-distribution flag

When to use ad-hoc mode

You want to distribute IPAs directly to registered devices (no TestFlight)
You don’t have or don’t want to use an App Store Connect API key
You want to collect build artifacts via --output-upload App Store에 제출하지 않고

Requirements

Ad-hoc builds have App Store builds보다 fewer requirements

요구 사항이 적다	than App Store builds:
인증서`.p12`)	Yes
자체 프로비저닝 프로파일 (`.mobileprovision`)	Yes
팀 ID (`--apple-team-id`)	Yes
애플 스토어 연결 API 키 (`.p8`)	No
애플 키 ID / 발급자 ID	No

어드혹 제공 프로파일 생성

위와 같은 단계를 따르십시오. 제공 프로파일, 하지만 5단계에서 Ad Hoc 대신 애플 앱 스토어:

등록하기 애플 개발자 프로필
버튼을 클릭하세요 + 버튼
선택 Ad Hoc 계속하기
앱과 배포 인증서를 선택하세요
등록할 기기를 선택하세요
이름과 다운로드 프로필

임의 인증서 저장

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --ios-distribution ad_hoc \
  --apple-team-id YOUR_TEAM_ID \
  --certificate './certificate.p12' \
  --ios-provisioning-profile './adhoc_profile.mobileprovision'

아니오 --apple-key, --apple-key-id, 또는 --apple-issuer-id 필요하지 않습니다.

임의 빌드 실행

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc

__CAPGO_KEEP_0__를 빌드 아티팩트로 수집하기 위해서는 --output-upload:

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc \
  --output-upload

CI/CD에 ad-hoc 빌드를 사용

GitHub 액션의 경우 App Store 빌드보다 비밀을 더 적게 필요합니다:

name: iOS Ad-Hoc Build

on:
  workflow_dispatch:

jobs:
  ios-adhoc:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS ad-hoc build
        run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }}
          CAPGO_IOS_DISTRIBUTION: ad_hoc

확장 프로그램이 포함된 앱 (다중 대상 인증)

앱이 확장 프로그램을 포함하고 있다면 (공유 확장 프로그램, 위젯, 알림 서비스 확장 프로그램 등), 각 확장 프로그램 대상에는 riêng의 인증서 파일이 필요합니다. Capgo은 반복 가능한 --ios-provisioning-profile flag를 통해 이러한 기능을 지원합니다.

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

flag는 번들 ID를 인증서 파일로 맵핑합니다. __CAPGO_KEEP_0__: --ios-provisioning-profile flag maps a bundle ID to its provisioning profile file. The CLI:

Each
자동으로 plist 내부에서 프로필 이름을 추출합니다.
파일을 Base64로 인코딩합니다.
모든 것을 단일 CAPGO_IOS_PROVISIONING_MAP 인증 정보

단일 프로파일에서 마이그레이션

이전 버전에서 단일 프로파일을 사용한 경우 BUILD_PROVISION_PROFILE_BASE64 (단일 프로파일)에서 사용하십시오:

bunx @capgo/cli@latest build credentials migrate --platform ios

기존 단일 프로필 인증 정보를 새로운 형식으로 변환하고 레거시 키를 제거합니다. CAPGO_IOS_PROVISIONING_MAP 기존 단일 프로필 인증 정보를 새로운 형식으로 변환하고 레거시 키를 제거합니다.BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

( update command (additive merge):

bunx @capgo/cli@latest build credentials update \
  --platform ios \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

문제 해결

프로비전 프로파일에는 XYZ 기능이 포함되어 있지 않습니다.

일부 경우, 다음 오류를 볼 수 있습니다:

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

이러한 오류는 프로비전 프로파일이 생성된 후에 새로운 기능을 활성화했기 때문에 발생합니다.

기존의 프로비전 프로파일에는 새로운 기능이 포함되어 있지 않습니다.

이 문제를 해결하려면 프로비전 프로파일을 다시 생성해야 합니다. 열기
__CAPGO_KEEP_0__을 선택하세요.
__CAPGO_KEEP_2__ 버튼을 클릭하세요. Profiles __CAPGO_KEEP_3__ 개발자 프로필 버튼
__CAPGO_KEEP_5__ 개발자 프로파일 찾기
__CAPGO_KEEP_6__ 개발자 프로파일 편집 Edit __CAPGO_KEEP_2__ 버튼을 클릭하세요.
__CAPGO_KEEP_2__ 버튼을 클릭하세요. Save __CAPGO_KEEP_3__ 개발자 프로필 버튼
클릭하여 Download 버튼
Capgo 네이티브 빌드 설정 명령어를 다시 실행하세요. 새로 다운로드한 프로필을 사용하세요. 이 문제를 해결할 수 있습니다.

기타 문제

제목이 '기타 문제'인 섹션

If for whatever reason you are having issues either with Capgo Native Build, configuring the credentials or building the app, please don’t hesitate to reach via our iOS 빌드에서 계속 진행하세요.

support

iOS 빌드를 사용 중이라면 iOS Builds CI/CD 자동화 계획을 위해 iOS Builds를 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 연결하세요. Capgo 네이티브 빌드 Capgo 네이티브 빌드에서 제품 워크플로우를 연결하세요. Capgo 통합 Capgo 통합에서 제품 워크플로우를 연결하세요. CI/CD 통합 CI/CD 통합 구현 세부 정보 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항을 위해.