iOS 빌드

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시를 복사하려면

Build and submit iOS apps to TestFlight and the App Store using Capgo’s dedicated Mac infrastructure.

학습할 내용

Capgo Native Build를 위한 인증서를 구성하는 방법을 배웁니다.
You will learn how to configure the certificates for Capgo Native Build

학습할 내용

Capgo 계정이 활성화된 구독이 있는 계정
Capgo에 이미 앱이 등록되어 있습니다 (아니면 실행) bunx @capgo/cli@latest app add Mac 컴퓨터에 Xcode가 설치되어 있어야 합니다 (linux/windows 머신에서 빌드를 설정할 수 있지만 아직 문서화되지 않았습니다)
유효한 Apple Developer 계정 ($99/년) (Apple Developer 계정에 관리자 또는 소유자 권한이 있어야 함)
Xcode를 통해 앱이 성공적으로 빌드될 수 있어야 합니다
__CAPGO_KEEP_0__ 앱
A Capacitor app
주의

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

애플 계정과 팀이 준비되기 전에 인증서 설정이나 첫 번째 테스트 플라이트 업로드를 트리거하기 전에 확인하세요:

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

앱을 __CAPGO_KEEP_0__로 빌드하기 전에, 우리는 먼저 앱을 설정하고, 수동으로 테스트 플라이트 빌드를 해보아야 합니다. 수동 빌드를 먼저 하는 것은 몇 가지 이점이 있습니다:

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first TestFlight build by hand. There are some advantages to doing a manual build first:

배포 인증서를 로컬 머신에 설치해야 합니다.
앱을 __CAPGO_KEEP_0__로 빌드하기 전에, 배포 인증서를 로컬 머신에 설치해야 합니다. 이것은 매우 복잡하지만, 아래에 설명하겠습니다.
code

__CAPGO_KEEP_0__

배포 인증서 설정

Xcode 열기
클릭 Xcode -> Settings... 단축키를 사용할 수도 있습니다. Cmd + ,
Xcode로 이동 Accounts
선택한 Apple 계정
앱을 배포할 팀
클릭하여 Manage Certificates... 버튼
인증서 목록에서 배포 인증서가 보이도록 확인하세요
보이지 않으면 새로운 인증서를 생성해야 합니다

애플은 배포 인증서의 최대 수를 3개로 제한하고 있습니다. 3개 이상의 인증서가 있는 경우, 새로운 인증서를 생성하기 위해 하나를 삭제해야 합니다. 이 튜토리얼에서는 삭제 과정을 다루지 않습니다.
1. 클릭하여 + 버튼을 클릭하고 Apple Distribution
2. 자동으로 인증서가 생성됩니다. 목록에서 확인하실 수 있습니다.

분산 인증서가 설치되면 이제 빌드 프로세스를 시작할 수 있습니다.

테스트 플라이트로 수동 빌드

Xcode에서 앱을 열어보세요.

실행 bunx cap open ios Xcode에서 앱을 열어보세요.
버튼 archive Xcode 도구栏에서 버튼을 찾고 클릭하세요.

Xcode 도구栏 product -> archive Xcode 도구栏에서 버튼을 찾고 클릭하세요.
빌드가 완료될 때까지 기다려 주세요
버튼을 클릭하세요 Distribute App 버튼
배포 방법으로 TestFlight Internal Only 버튼을 클릭하세요 Distribute Xcode TestFlight 내부 배포 방법
다음 필드를 입력하세요:

이름: 앱의 이름 - 앱 스토어에서 표시됩니다
1. SKU - 앱의 SKU - 앱 스토어에서 앱을 식별하는 데 사용됩니다
2. __CAPGO_KEEP_0__
3. 앱의 기본 언어
그 다음에 next 버튼
앱 기록 생성이 실패하면 창을 닫고 앱을 다시 압축해 보세요.
업로드가 완료될 때까지 기다려 주세요.
모든 것이 잘 되었으면 다음 화면을 볼 수 있을 것입니다.
버튼 Done 이제 TestFlight에서 앱을 볼 수 있을 것처럼 생각할 수 있지만, 몇 가지 더 할 일들이 남았습니다.

TestFlight에 자신을 추가하세요.

__CAPGO_KEEP_0__
완전한 수출 준수성을 위해 빌드가 테스트 가능하도록 하세요.
App Store Connect에서 지원 URL, 개인 정보 보호 정책 URL 및 연령 등급과 같은 필수 메타데이터를 입력하세요.
실제로 지원하는 기기와 일치하는 스크린샷을 준비하세요.
제품 제출 전에 App Review 연락처 및 테스트 자격증명을 추가하세요.

첫 번째 항목부터 시작해 보겠습니다.

테스트 플라이트에 자신을 추가하는 방법

다음으로 이동하세요. App Store Connect App Store Connect 로그인 페이지
App Store Connect 페이지
앱 레코드를 만들 때 사용한 팀을 선택하세요. 단일 개발자 계정만 사용하는 경우 이 단계를 건너뛸 수 있습니다.
버튼을 클릭하세요. Apps 앱 스토어 연결 앱 버튼
앱 스토어 연결 앱 선택
앱 스토어 연결 테스트 플라이트 버튼 TestFlight 버튼을 클릭하세요.
__CAPGO_KEEP_0__ Internal Testers plus __CAPGO_KEEP_0__
새 그룹 만들기

그룹 이름을 "내부"이라고 지칭하는 것을 좋아합니다. 원하는 이름으로 지명할 수 있습니다.
클릭하세요 Invite testers 버튼
자신을 그룹에 추가하세요

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

이제 그룹에 자신을 볼 수 있어야 합니다.

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

준수 정보 설정

애플이 자신의 앱이 표준 암호화 알고리즘을 사용하지 않는지 약속해야 합니다. 앱이 표준 암호화 알고리즘을 사용하지 않는 경우, 사용하는 암호화 알고리즘을 사용하는 방법에 대한 애플 문서 를 읽는 것을 추천합니다. 이 방법을 사용할 수 있는 두 가지 방법이 있습니다.

앱을 빌드할 때마다 이 방법을 사용할 수 있습니다.
plist 파일을 자동으로 설정하는 방법을 사용할 수 있습니다. false.

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

이전 섹션에서 설명한 단계를 모두 따라서 App Store Connect의 TestFlight 섹션을 찾으세요.
클릭하세요 Builds -> iOS
미흡한 준수 정보가 있는 빌드를 찾으시고 클릭하세요 Manage
앱에 대한 가장 적합한 옵션을 선택하세요

저에게는 이것이 none그러나 당신에게는 다를 수 있습니다. 그 후, 저장
앱이 이제는 ready to test

두 번째 경우에 대한 단계는 다음과 같습니다:

열어보세요 Info.plist 파일

__CAPGO_KEEP_0__ 키를 추가하세요.

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

파일을 저장하세요.

테스트 플라이트 앱을 설치하고 초대장을 수락하세요.

이제 당신은 마치 앱을 TestFlight에서 테스트하기 위해 준비하세요. 테스트하기 전에 다음 단계를 수행해야 합니다:

__CAPGO_KEEP_0__ 다운로드 TestFlight 앱 iOS/iPadOS 기기에서 앱 스토어에서
앱 테스트에 대한 초대 수락

TestFlight 앱을 기기에 설치하는 방법에 대한 세부 정보는 생략하겠습니다. 앱을 설치하는 방법에 대해 확신하지 못한다면 Google은 설치 방법에 대한 훌륭한 안내서를 제공합니다.

초대 수락에 대한 자세한 내용은 Apple에서 초대 수락을 위한 링크가 포함된 이메일을 받게 됩니다.

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

Xcode를 사용하여 앱을 이전에 설치한 경우 다음 화면을 볼 수 있습니다. "버튼"을 클릭하세요. install TestFlight 앱 설치
버튼을 클릭하고 클릭하세요
축하합니다 🎉 TestFlight에서 앱을 테스트하기 위한 초대장을 수락했습니다. 이제 __CAPGO_KEEP_0__ Native Build를 구성하여 앱을 TestFlight에 제출할 수 있습니다. Open __CAPGO_KEEP_0__ Native Build 구성

제목 "Capgo Native Build 구성"

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_1__ __CAPGO_KEEP_2__에 전달할 항목의 목록입니다.	__CAPGO_KEEP_2__
`--platform`	플랫폼`ios`)
`--apple-team-id`	설명 ()
`--apple-key`	Path to your App Store Connect API Key file (`.p8` 애플 개발자 포털
`--apple-key-id`	앱 스토어 연결 API 키 파일의 경로 (
`--apple-issuer-id`	파일
`--certificate`	앱 스토어 연결 __CAPGO_KEEP_0__ 키의 키 ID`.p12` 앱 스토어 연결 발급자 ID
`--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

Apple Developer Account로 가서 아래로 스크롤하세요.

팀 ID를 찾으세요. Apple Developer Account and scroll down
Find the Team ID

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

Apple 키로 넘어가겠습니다.

App Store Connect 사용자 및 접근 페이지로 이동하세요. 주의

정확한 팀을 드롭다운에서 선택하세요.
상단 오른쪽에서 이름을 클릭하세요.
1. 사용하고 싶은 팀을 클릭하세요.
2. 정확한 팀을 선택하세요.
버튼을 클릭하세요. Integrations 버튼
이것을 찾으세요. issuer

이것은 나중에 필요하므로 저장해 두세요. __CAPGO_KEEP_0__ 버튼을 클릭하여 발행자 복사본을 얻으세요.

button copy App Store Connect integrations button
플러스 버튼을 클릭하세요.
키 이름을 설정하고 앱 매니저에 대한 접근 권한을 설정한 후 생성 버튼을 클릭하세요. App manager __CAPGO_KEEP_2__ Generate __CAPGO_KEEP_3__
키 ID를 저장하세요.

이 저장해야 합니다. - __CAPGO_KEEP_0__ 필요할 때 다시 사용하세요
키를 다운로드하세요

이 __CAPGO_KEEP_0__ 에서만 사용하세요 - __CAPGO_KEEP_0__ 필요할 때 다시 사용하세요

CAPGO 에서 CLI 에서 CAPGO를 절대 다른 사람과 공유하지 마세요 - CAPGO에서만 사용하세요

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

인증서

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

애플은 무한한 지혜로, 인증서를 내보내기 위한 방법이 인증서를 생성하는 방법과는 다르다고 결정했습니다 🙃 설정에 들어가 봅시다:

키 체인 액세스 열기
1. 클릭 Command + Space 검색 바를 열기
2. 검색 Keychain Access
3. 클릭하여 Keychain Access 앱 클릭
분류를 선택하고 login 버튼을 클릭하세요 My Certificates 버튼
리스트에서 인증서를 찾으세요

인증서 이름이 Apple Distribution: [Your Name/Company] (your team ID)
인증서 오른쪽 클릭하고 Export
인증서를 파일로 저장하세요 .p12 파일로 저장

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

Mac에 로그인하는 비밀번호를 입력하세요. 그런 다음 Allow 버튼을 클릭하세요.

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

배포 프로파일

이제 프로비저닝 프로파일을 내보낼 준비가 되었습니다. Apple에서 마지막으로 필요한 것은 이것입니다.

Go to Apple Developer 프로파일
다운로드 드롭다운에서 올바른 팀을 선택하십시오
1. 상단 우측에서 이름을 클릭하십시오
2. 사용하고 싶은 팀을 클릭하십시오
올바른 페이지인지 확인하십시오 이런 모습이면 좋습니다. 그렇지 않다면 profiles 사이드바
클릭하십시오 + 버튼
프로필 유형을 선택하세요 선택 App Store Connect 과 클릭하세요 Continue 버튼
빌드하고 싶은 앱을 선택하세요

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

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

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

__CAPGO_KEEP_0__ 이름을 지정하고 __CAPGO_KEEP_1__ 버튼을 클릭하세요. Generate 팁

The profile name is automatically extracted by the Capgo CLI — you don’t need to remember it.
__CAPGO_KEEP_1__ 버튼 클릭

Apple Developer __CAPGO_KEEP_0__ 선택 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_KEEP_0__ __CAPGO_KEEP_1__ 인증서 저장 출력

Capgo CLI credentials save output

제목: CI/CD 설정 (GitHub Actions)

__CAPGO_KEEP_0__ ID 애플 키, 애플 키 ID 및 애플 이슈어 ID, 애플 키, 애플 키 ID 및 애플 이슈어 ID, 인증서, 그리고 배포 프로파일, 이미 CI/CD를 위해 필요한 모든 것을 가지고 있습니다. 이 섹션은 CI/CD를 위해 필요한 값을 GitHub Actions 비밀과 환경 변수로 전달하는 방법에 대해 설명합니다.

1) 인증 파일을 한 줄의 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`	키 ID 애플 키, 애플 키 ID 및 애플 발급자 ID
`APPLE_ISSUER_ID`	발급자 ID Apple key, Apple key ID 및 Apple issuer ID
`BUILD_CERTIFICATE_BASE64`	내용 `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	CLI에서 복사한 내용입니다. `.capgo-credentials` 파일
`APPLE_KEY_CONTENT`	내용 `apple_key_base64.txt`
`P12_PASSWORD` (선택)	비밀번호가 설정된 경우 `.p12` 1) __CAPGO_KEEP_0__ Actions 워크플로우에서 환경 변수 사용

제목 ‘1) 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

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

테스트용 배포 모드

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

등록된 장치에 IPAs를 직접 배포하고 싶습니다 (TestFlight를 사용하지 않습니다)

Enterprise 배포
You don’t have or don’t want to use an App Store Connect API key
You want to collect build artifacts via __CAPGO_KEEP_0__ --output-upload App Store에 제출하지 않고

요구 사항

Ad-hoc builds는 App Store builds보다 요구 사항이 적습니다.

인증서	필요한가요?
배포 인증서 (`.p12`)	Yes
임시 배포 프로파일 (`.mobileprovision`)	네
팀 ID (`--apple-team-id`)	네
앱 스토어 연결 API 키 (`.p8`)	아니오
애플 키 ID / 발급자 ID	아니오

App Store Connect __CAPGO_KEEP_0__ 키가 없으면, 빌드 번호 자동 증가가 타임스탬프 기반 fallback을 사용합니다. 경고를 무시하려면

제목: ad-hoc 배포 프로파일을 생성하는 방법 같은 단계를 따르세요.배포 프로파일 , 하지만 5단계에서 대신 앱 스토어:

로 이동하세요 애플 개발자 프로필
버튼을 클릭하세요 + 버튼
선택하세요 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

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

확장 기능이 있는 앱 (다중 대상 인증)

앱이 확장 기능 (공유 확장 기능, 위젯, 알림 서비스 확장 기능 등)을 포함한다면, 각 확장 대상에는 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"

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

내장된 plist에서 프로파일 이름을 자동으로 추출합니다.
Copy to clipboard
Base64-encodes the file
모든 것을 단일로 저장합니다. CAPGO_IOS_PROVISIONING_MAP 인증 정보

싱글 프로파일에서 마이그레이션

이전 버전에서 사용하셨던 BUILD_PROVISION_PROFILE_BASE64 (싱글 프로파일) 경우:

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

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

이전의 update 이미지

bunx @capgo/cli 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')"

이러한 오류가 발생하는 이유는 프로비저닝 프로파일이 생성된 후에 새로운 기능을 활성화했기 때문입니다. 기존의 프로비저닝 프로파일에는 새로운 기능이 포함되어 있지 않습니다.

이 문제를 해결하려면 프로비저닝 프로파일을 다시 생성해야 합니다.

열기 애플 개발자 포털
정확한 팀을 드롭다운 메뉴에서 선택
버튼을 클릭하세요. Profiles 버튼
재생성하고 싶은 프로비전 프로파일을 찾으세요.
버튼을 클릭하세요. Edit 애플 개발자 프로파일 편집
애플 개발자 프로파일 저장 Save 버튼
클릭하여 Download 버튼
Capgo 네이티브 빌드 설정 명령을 다시 실행하세요. 새로 다운로드한 프로필을 사용하여 다시 실행하세요.

이 문제를 해결해야 합니다.

기타 문제

이미지나 기타 이유로 Capgo 네이티브 빌드, 인증 정보를 설정하거나 앱을 빌드하는 데 문제가 발생한 경우, 지원에 문의하지 마세요. 지원.

iOS 빌드

학습할 내용

학습할 내용

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

앱을 __CAPGO_KEEP_0__로 빌드하기 전에, 우리는 먼저 앱을 설정하고, 수동으로 테스트 플라이트 빌드를 해보아야 합니다. 수동 빌드를 먼저 하는 것은 몇 가지 이점이 있습니다:

배포 인증서 설정

테스트 플라이트로 수동 빌드

테스트 플라이트에 자신을 추가하는 방법

준수 정보 설정

테스트 플라이트 앱을 설치하고 초대장을 수락하세요.

제목 "Capgo Native Build 구성"

팀 ID

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

인증서

배포 프로파일

설정 명령어를 실행 중입니다

제목: CI/CD 설정 (GitHub Actions)

1) 인증 파일을 한 줄의 base64로 변환하세요

2) 저장소 비밀을 만들기

제목 ‘1) GitHub Actions 워크플로우에서 환경 변수 사용’

빌드 실행

테스트용 배포 모드

등록된 장치에 IPAs를 직접 배포하고 싶습니다 (TestFlight를 사용하지 않습니다)

요구 사항

App Store Connect __CAPGO_KEEP_0__ 키가 없으면, 빌드 번호 자동 증가가 타임스탬프 기반 fallback을 사용합니다. 경고를 무시하려면

임시 인증서 저장

임시 빌드 실행

CI/CD에 ad-hoc 빌드

확장 기능이 있는 앱 (다중 대상 인증)

예제: 앱 + 공유 확장 기능

싱글 프로파일에서 마이그레이션

문제 해결

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

기타 문제