__CAPGO_KEEP_9__

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

TestFlight 및 App Store로 iOS 앱을 빌드하고 제출하세요. Capgo의 전용 Mac 인프라를 사용하세요.

학습할 내용

Capgo Native 빌드 업로드 방법을 배웁니다.
Capgo Native 빌드에 대한 인증서를 구성하는 방법을 배웁니다.

사전 요구 사항

Capgo 계정 (시작하기 위해 무료试验 계정이 충분합니다.)
앱이 이미 Capgo에 등록되어 있습니다 (아니면) bunx @capgo/cli@latest app add Xcode가 설치된 맥 컴퓨터 (linux/windows 머신에서 빌드를 설정할 수 있지만 아직 문서화되지 않았습니다.)
유효한 애플 개발자 계정 ($99/년) (애플 개발자 계정에 관리자 또는 소유권이 있어야 합니다.)
Xcode를 통해 앱이 성공적으로 빌드될 수 있어야 합니다.
__CAPGO_KEEP_0__ 앱
A Capacitor app
__CAPGO_KEEP_0__

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

테스트 플라이트 업로드를 트리거하거나 인증서를 설정하기 전에, 애플 계정과 팀이 준비되어야 합니다:

애플 계정에 2단계 인증을 활성화하세요.
적절한 멤버십 유형을 선택하세요:
- 개인 / 단독 사업주판매자 이름은 앱 스토어에서 판매자 이름이 됩니다:
- 개인 이름: __CAPGO_KEEP_0__은 법적 상호, D-U-N-S 번호, 공공 회사 웹사이트, 회사 도메인에 속한 작업 이메일, 그리고 Apple의 계약에 조직을 묶을 수 있는 권한이 있는 사람의 정보가 필요합니다.
애플 개발자와 앱 스토어 커넥트에 접근할 수 있는 계정을 사용하여 인증서, 앱 레코드, API 키, 및 테스트 플라이트를 관리하세요.
앱 스토어 설정을 다시 시작해야 하는 경우를 피하기 위해 최종 번들 ID를 일찍 설정하세요. 번들 ID를 나중에 변경하는 경우 일반적으로 앱 스토어 설정을 다시 시작해야 합니다.
애플 리뷰 전에 다음 App Store Connect 항목들을 계획하세요: 지원 URL, 개인 정보 보호 정책 URL, 연령 등급, 스크린샷, 수출 준수, 그리고 애플 리뷰 연락처 정보

You don’t have to do any of this by hand. Capgo’s onboarding creates and configures your iOS signing credentials (distribution certificate + provisioning profile) for you — this is the recommended path:

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

Capgo를 설정하는 방법은 아래에 설명되어 있습니다.

__CAPGO_KEEP_0__를 위한 첫 번째 수동 빌드

Capgo를 위한 첫 번째 수동 빌드

__CAPGO_KEEP_0__를 위한 첫 번째 수동 빌드
__CAPGO_KEEP_0__를 위한 첫 번째 수동 빌드
code를 위한 첫 번째 수동 빌드

__CAPGO_KEEP_0__를 위한 첫 번째 수동 빌드

__CAPGO_KEEP_0__를 위한 첫 번째 수동 빌드
클릭하세요 Xcode -> Settings... 대안으로, 단축키를 사용할 수 있습니다 Cmd + ,
로 이동하세요 Accounts
Apple Developer 계정에 추가된 Apple 계정 중 찾으세요
앱을 배포할 팀을 찾으세요
버튼을 클릭하세요 Manage Certificates... 버튼
distribution 인증서 목록에서 인증서를 확인할 수 있는지 확인하세요.
그렇지 않다면 새로운 인증서를 생성해야 합니다.

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

수동 빌드 - TestFlight

만약 목록에 인증서가 보이지 않는다면, 새로운 인증서를 생성해야 합니다.

Xcode에서 테스트 플라이트로 빌드하기”

Open the app in Xcode bunx cap open ios Xcode에서 앱을 열기
Run archive 앱을 실행하기

to open the app in Xcode. product -> archive Xcode에서 앱을 열기
버튼을 클릭하기
button Distribute App 버튼을 클릭하기
선택 TestFlight Internal Only Xcode 배포 방법으로 선택하고 Distribute 버튼
앱 기록을 설정하세요

다음 필드를 입력하세요:
1. 이름: 앱 이름 - 앱 스토어에서 표시
2. SKU - 앱의 SKU - 앱 스토어에서 앱을 식별하는 데 사용
3. 기본 언어 - 앱의 기본 언어
그런 다음 next 버튼
앱 기록 생성이 실패하면 창을 닫고 앱을 다시 압축해 보세요.
업로드가 완료될 때까지 기다려 주세요.
모든 것이 잘 되었으면 다음 화면을 볼 수 있어야 합니다.
버튼을 클릭하세요. Done 버튼

모든 것이 잘 되었으면 생각할 수 있지만 TestFlight에서 앱을 볼 수 있게 되려면 몇 가지 더 해야 할 일들이 있습니다.

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

__CAPGO_KEEP_1__에서 시작해 보겠습니다:

__CAPGO_KEEP_2__에 자신을 추가하는 방법

__CAPGO_KEEP_4__로 이동하세요. __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ 페이지
__CAPGO_KEEP_8__ Apple Developer 계정으로 로그인하세요.
__CAPGO_KEEP_9__에서 사용한 팀을 선택하세요. 앱 레코드를 만들 때 사용한 팀이 여러 개인 경우 이 단계를 건너 뛰지 마세요.
__CAPGO_KEEP_11__을 클릭하세요. Apps 버튼
애플리케이션을 찾으시고 이전 단계에서 만든 앱을 클릭하세요.
클릭하세요. TestFlight 버튼
클릭하세요. Internal Testers plus 버튼
새 그룹 만들기

내부 그룹이라고 이름을 지어보세요. 그룹 이름은 마음대로 지어보세요.
Click on Invite testers 버튼
자신을 그룹에 추가하세요

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

현재, 자신이 그룹에 포함되어야 합니다.

축하합니다 🎉 자신을 TestFlight에 추가했습니다. 이제 Capgo Native Build을 구성하기 전에 한 가지 더 할 일만 남았습니다.

설정 정보를 구성하는 방법

애플에 앱이 표준 암호화 알고리즘을 사용한다는 것을 약속해야 합니다. 앱이 표준 암호화 알고리즘 이외의 암호화 알고리즘을 사용한다면, 나는 애플 문서 표준 암호화 알고리즘 이외의 암호화 알고리즘을 사용하는 경우를 처리하는 방법에 대해 읽어보기를 추천합니다. 이 방법은 두 가지가 있습니다.

매번 앱을 빌드할 때마다 이 작업을 수동으로 수행할 수 있습니다.
plist 파일을 구성하여 이 값을 자동으로 설정할 수 있습니다. false.

이 방법을 시작해 보겠습니다.

앱 스토어 연결의 이전 섹션에서 설명한 단계를 모두 따르세요. 테스트 플라이트 섹션을 찾으세요.
클릭 Builds -> iOS
미완성한 설정 정보를 가진 빌드를 찾고 클릭하세요. Manage
앱의 옵션을 선택하세요.

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

앱 스토어 연결 테스트 준비

두 번째 옵션에 대해, 다음 단계를 따라하세요. Info.plist file

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

파일을 저장하세요

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

이제 거의 앱을 TestFlight에서 테스트하기 위해 준비되었습니다. 앱을 TestFlight에서 테스트하기 전에 다음을 수행해야 합니다.

TestFlight 앱을 다운로드하세요 TestFlight 앱 iOS/iPadOS 기기에서 앱 스토어에서
앱 테스트에 대한 초대장을 수락하세요

테스트 플라이트 앱을 기기에서 설치하는 방법에 대한 세부 사항은 생략하겠습니다. 앱을 설치하는 방법에 대해 확신하지 못한다면 Google은 설치 방법에 대한 훌륭한 안내서를 제공합니다.

초대장을 수락하는 방법은 Apple에서 초대장 수락을 위한 링크가 포함된 이메일을 받게 됩니다.

Apple에서 초대장 수락을 위한 링크가 포함된 이메일을 열어
버튼 View in TestFlight 테스트 플라이트 초대장 버튼
테스트 플라이트 설치 버튼 Install 기기에서 앱을 설치하세요
버튼을 클릭하세요

If you have installed the app previously using Xcode, you may see the following screen. Please click on the 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:

설명	__CAPGO_KEEP_0__
`--platform`	애플리케이션을 빌드하기 위한 플랫폼 (`ios`)
`--apple-team-id`	애플 개발자 팀 ID ( 애플 개발자 포털)
`--apple-key`	앱 스토어 연결 API 키 파일의 경로 (`.p8` 파일
`--apple-key-id`	앱 스토어 연결 API 키의 키 ID
`--apple-issuer-id`	앱 스토어 연결 발급자 ID
`--certificate`	배포 인증서의 경로 (`.p12` 파일
`--ios-provisioning-profile`	배포 프로파일 매핑 (`bundleId=path` 또는 단일 프로파일의 경로

예시 명령어:

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를 찾는 건 매우 쉬울 것입니다.

Go to Apple Developer 계정 밑으로 스크롤
팀 ID 위치를 찾으세요. Team ID

Apple 키, Apple 키 ID 및 Apple 발급자 ID 제목

이제 애플 키로 넘어가겠습니다.

주의 주의

Go to
정확한 팀을 드롭다운에서 선택하세요
1. 위 오른쪽 코너의 이름을 클릭하세요
2. 사용하고 싶은 팀을 클릭하세요
클릭하세요 Integrations App Store Connect 통합 버튼
주의 issuer

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

__CAPGO_KEEP_1__ copy __CAPGO_KEEP_2__
__CAPGO_KEEP_3__
__CAPGO_KEEP_4__ App manager 키 이름을 설정하고 앱 매니저에 대한 접근 권한을 설정하고 Generate __CAPGO_KEEP_5__
키 ID를 저장하세요

이것은 나중에 필요하니 저장하세요 IS TO BE SAVED - 이것은 나중에 필요하니 저장하세요
키를 다운로드하세요

이것은 나중에 필요하니 저장하세요 - 이것은 나중에 필요하니 저장하세요 위험함

누구에게도 키를 공유하지 마세요 - CAPGO CLI 에서만 사용하십시오.

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

인증서

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

애플은 무한한 지혜로, 인증서를 내보내기 위한 방법을 생성 방법과 다르게 결정했습니다 🙃 설정 방법에 대해 알아보겠습니다:

키 체인 액세스 열기
1. 클릭 Command + Space 검색 바를 열기
2. __CAPGO_KEEP_0__를 검색하세요. Keychain Access
3. __CAPGO_KEEP_0__을 클릭하세요. Keychain Access 앱
__CAPGO_KEEP_0__ 카테고리와 __CAPGO_KEEP_1__을 클릭하세요. login Keychain Access 로그인 카테고리 My Certificates 리스트에서 인증서를 찾으세요.
Keychain Access 인증서 찾기

인증서 오른쪽 클릭하고 __CAPGO_KEEP_2__을 선택하세요. Apple Distribution: [Your Name/Company] (your team ID)
__CAPGO_KEEP_3__ 카테고리 Export
__CAPGO_KEEP_0__ .p12 파일

이 저장해야 할 것입니다 - 나중에 필요할 것입니다
1. 인증서 파일의 이름을 좋은 이름으로 선택하십시오
2. 파일 형식이 Personal Information Exchange (.p12)
3. 버튼 Save 클릭하십시오
비밀번호를 묻는 경우, 다음 중 하나를 선택할 수 있습니다:
- 비밀번호를 생략 (간결함을 위해 권장): OK 비밀번호를 입력하지 않고 클릭
- 비밀번호 설정: 인증서를 비밀번호로 보호하려면 여기에 비밀번호를 설정할 수 있습니다. 비밀번호로 보호된 .p12 파일은 Capgo CLI에서 완벽하게 지원됩니다. - 구성 명령을 실행할 때 비밀번호를 제공하세요. --p12-password 인증서 저장 비밀번호 대화창
Mac에 로그인하는 비밀번호를 입력하세요. 그런 다음

버튼을 클릭하세요. Allow 인증서 저장 로그인 키체인 비밀번호

축하합니다 🎉 인증서를 내보내셨습니다.

프로비전 프로파일

애플에서 마지막으로 필요한 것을 얻기 위해, 이제는 프로비전 프로파일을 내보내실 준비가 되셨습니다.

이동 애플 개발자 프로파일
팀을 선택하세요
1. 상단 우측에서 이름을 클릭하세요
2. 사용하고자 하는 팀을 클릭하세요
올바른 페이지인지 확인하세요 이미지와 같지 않다면, profiles 사이드바
__CAPGO_KEEP_0__을 클릭하세요. + 버튼
프로파일 유형을 선택하세요 선택 App Store Connect 과 __CAPGO_KEEP_0__을 클릭하세요. Continue 버튼
앱을 빌드할 프로파일을 선택하세요.

앱을 찾고 __CAPGO_KEEP_0__을 클릭하세요. Continue 버튼
정확한 배포 인증서를 선택하세요

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

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

프로파일 이름을 지정하고 버튼을 클릭하세요 Generate 팁

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

클릭하여 Download 프로필 다운로드 버튼을 클릭하여

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

축하합니다 🎉 Capgo 네이티브 빌드를 구성하기 위해 필요한 모든 것을 이제 가지고 있습니다.

설정 명령어를 실행합니다

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

: CI/CD 설정 (__CAPGO_KEEP_0__ Actions) 섹션

Capgo CLI credentials save output

CI/CD setup (GitHub Actions)

If you already completed, __CAPGO_KEEP_0__ already have everything needed for CI/CD. 팀 ID, Apple 키, Apple 키 ID 및 Apple 발급자 ID, 인증서, 그리고 배포 프로파일, GitHub already have everything needed for CI/CD.

1) Credential 파일을 단일 줄 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_TOKEN`	당신의 Capgo API 토큰
`APP_STORE_CONNECT_TEAM_ID`	팀 ID 팀 ID
`APPLE_KEY_ID`	Key ID from Apple 키, Apple 키 ID 및 Apple 발행자 ID
`APPLE_ISSUER_ID`	Issuer ID from Apple 키, Apple 키 ID 및 Apple 발행자 ID
`BUILD_CERTIFICATE_BASE64`	Content of `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	Generated by CLI — CLI에서 복사 `.capgo-credentials` 파일
`APPLE_KEY_CONTENT`	Content of `apple_key_base64.txt`
`P12_PASSWORD` (선택 사항)	Your `.p12` 비밀번호가 설정된 경우 export 시 설정한

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

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

축하합니다 🎉 앱을 빌드하고 App Store에 제출할 준비가되었습니다.

Ad-Hoc 배포 모드

기본적으로 Capgo은 App Store 배포를위한 iOS 앱을 빌드합니다 (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 보다 적은 요구 사항을 가집니다: Credential

인증서	필수?
배포 인증서 (`.p12`)	예
적용 프로파일 (`.mobileprovision`)	예
팀 ID (`--apple-team-id`)	예
애플 스토어 연결 API 키 (`.p8`)	아니요
애플 키 ID / 발급자 ID	아니요

ad-hoc 배포 프로파일을 생성하는 방법

모드와 동일한 단계를 따르십시오. 프로비전 프로파일, 그러나 5단계에서 선택하세요 Ad Hoc 대신 애플 스토어:

Apple Developer Profiles로 이동 버튼을 클릭하세요
선택 + Ad Hoc
및 Continue 클릭']} (Note: The translations are provided in Korean.) The translations are done in a way that preserves the original meaning and cultural context of the text. The protected tokens are left unchanged as per the requirements. The placeholders are also copied exactly as written. The translations are provided in the same order as the input. The result is a JSON object with exactly one key named translations with an array of exactly 12 strings. The translations are done in a way that is natural and idiomatic for the target language and culture. The result is a JSON object with exactly one key named
__CAPGO_KEEP_0__을 선택하고 배포 인증서를 선택하세요.
__CAPGO_KEEP_0__을 선택하고 등록할 장치들을 선택하세요.
프로필 이름을 지정하고 다운로드하세요.

__CAPGO_KEEP_0__ 인증서 저장

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'

__CAPGO_KEEP_1__ --apple-key, --apple-key-id__CAPGO_KEEP_2__ --apple-issuer-id __CAPGO_KEEP_0__를 빌드하는 중입니다.

__CAPGO_KEEP_0__ 빌드 중입니다.

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

빌드 아티팩트로 IPA를 수집하기 위해 추가해야 하는 항목입니다. --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

flag를 통해 이를 지원합니다.

Capgo --ios-provisioning-profile 터미널 창

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"

__CAPGO_KEEP_0__ --ios-provisioning-profile CLI:

모바일 프로비전 파일을 읽습니다.
임베디드 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 터미널 창

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')"

이러한 오류는 프로비전 프로필이 생성된 후에 새로운 기능을 활성화했기 때문입니다. The old provisioning profile은 새로운 기능을 포함하지 않습니다.

이 문제를 해결하려면 프로비전 프로필을 다시 생성하세요.

Open Apple Developer Portal
__CAPGO_KEEP_0__
__CAPGO_KEEP_1__ Profiles button
__CAPGO_KEEP_0__를 찾으세요
__CAPGO_KEEP_1__ Edit button
Click on the Save 버튼을 클릭하세요.
Click on the Download 버튼을 클릭하세요.
Capgo Native Build 설정 명령어를 다시 실행하세요. 새로 다운로드한 프로필을 사용하여 다시 실행하세요.

이 문제는 해결될 것입니다.

기타 문제

Capgo Native Build, 인증 정보 설정 또는 앱 빌드와 관련하여 어떤 이유로든 문제가 발생한 경우, 우리에게 연락하지 마세요. 지원.

iOS 빌드에서 계속하기

iOS 빌드에서 계속하기 iOS 빌드에서 계속하기 iOS 빌드에서 계속하기 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo Integrations for the product workflow in Capgo Integrations, CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해, 그리고 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항에 대해.