iOS 빌드

설치

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

학습할 내용

Capgo 네이티브 빌드를 통해 앱을 업로드하는 방법
Capgo 네이티브 빌드에 대한 인증서를 구성하는 방법

준비 사항

Capgo 계정 (무료试用도 시작하기에 충분합니다.)
Capgo에 이미 앱이 등록되어 있습니다 (run bunx @capgo/cli@latest app add 만약에 아니라면
Mac이 필요하지 않습니다: Capgo 빌드는 클라우드에서 앱을 컴파일하고 서명하기 때문에 macOS, Windows 또는 Linux에서 이 작업을 실행할 수 있습니다.
Apple 개발자 계정 ($99/년) (Apple 개발자 계정에 관리자 또는 소유권이 있는 경우 반드시 필요합니다.)
앱이 Xcode에서 성공적으로 빌드되야 합니다 (또는 Capgo 빌드)
Capacitor 앱
앱 아이콘. 앱 스토어에 업로드할 수 없는 앱은 아이콘을 설정하지 않은 앱입니다.

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

애플 계정에 2단계 인증을 활성화하십시오.

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

이 모든 것을 수동으로 할 필요가 없습니다. Capgo의 온보딩은 iOS signing 인증서 (배포 인증서 + 배포 프로파일)와 함께 인증서 및 프로파일을 생성하고 구성합니다. — 이는 권장 경로입니다:

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

수동으로 인증서를 설정하거나 Capgo의 내부 동작을 이해하고 싶은 사람들만 읽으세요.

첫 번째 수동 빌드

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

앱 __CAPGO_KEEP_0__과 관련된 빌드 프로세스와 관련된 문제를 해결할 수 있습니다.
배포 인증서를 로컬 머신에 설정합니다.
You will be able to figure out any issues with the build process linked to your app code

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

배포 인증서 설정

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

애플은 배포 인증서의 최대 수를 3개로 제한하고 있습니다. 3개 이상의 인증서가 있다면 하나를 삭제해야 새로운 인증서를 생성할 수 있습니다. 이 튜토리얼에서는 삭제 과정을 설명하지 않습니다.
1. 클릭하여 + 버튼을 클릭하고 Apple Distribution
2. 인증서가 자동으로 생성됩니다. 목록에서 확인할 수 있습니다. 이전 단계를 확인하여 인증서가 생성되었는지 확인하세요.

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

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

Xcode에서 앱을 열어보세요

실행 bunx cap open ios Capgo의 Codepush와 비교하여 빌드 단계를 진행하면, 앱이 더 빠르게 배포될 수 있습니다. Codepush는 앱을 배포하는 데 사용되는 서비스입니다. Codepush를 사용하면 앱을 배포하는 데 필요한 단계를 줄일 수 있습니다. Codepush를 사용하면 앱을 배포하는 데 필요한 단계를 줄일 수 있습니다.
열기 archive 버튼

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

이름: 앱의 이름 - 앱 스토어에서 표시됩니다
1. Xcode 배포 버튼
2. SKU - 앱의 SKU - 앱을 식별하기 위해 App Store에서 사용하는 SKU입니다.
3. The primary language - 앱의 기본 언어
그 다음, next 버튼
앱 기록 생성이 실패하면 창을 닫고 앱을 다시 압축해 보세요.
업로드를 기다려 주세요.
모든 것이 잘 되었으면 다음 화면을 볼 수 있어야 합니다.
버튼 Done 버튼

앱이 TestFlight에서 보일 것 같지만, 여전히 몇 가지 작업이 남았습니다.

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

첫 번째 것을 시작해 보겠습니다:

TestFlight에 자신을 추가하는 것입니다

iOS Builder App Store Connect 페이지 page
애플 개발자 계정으로 로그인하세요
애플 개발자 계정에서 앱 레코드를 생성할 때 사용한 팀을 선택하세요. 단일 개발자 계정만 있는 경우 이 단계를 건너뛸 수 있습니다.
버튼 Apps 앱 스토어 연결 앱 버튼
앱 스토어 연결 앱 선택
버튼 TestFlight 앱 스토어 연결 앱 버튼
버튼 Internal Testers plus 버튼
새 그룹 만들기

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

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

현재, 그룹에 자신이 보이길 바랍니다.

축하합니다 🎉 TestFlight에 자신을 추가했습니다. 이제 Capgo Native Build을 구성하기 전에 마지막으로 하나의 일을 수행해야 합니다.

규정 준수 정보 설정

현재, 앱이 비표준 암호화 알고리즘 (예: 커스텀 알고리즘)을 사용하지 않는다는 것을 Apple에 약속해야 합니다. 만약 앱이 비표준 암호화를 사용한다면, 다음을 읽는 것을 추천합니다. Apple 문서 비표준 암호화 사용을 처리하는 방법에 대한 설명입니다. 다음 두 가지 방법이 있습니다:

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

첫 번째 방법부터 시작해 보겠습니다.

이전 섹션의 모든 단계를 따르세요. 테스트 플라이트 섹션을 App Store Connect에서 찾으세요.
클릭하세요. Builds -> iOS
비준수 정보가 없는 빌드를 찾으시고 클릭하세요. Manage
앱에 가장 적합한 옵션을 선택하세요.

나는 none그러나 당신의 경우에는 다를 수 있습니다. 그 후 저장을 클릭하세요.
앱이 이제 ready to test

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

iOS 프로젝트를 열어 Info.plist 파일을

다음 키를 추가하세요:

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

파일을 저장

테스트 플라이트 앱 설치 및 초대장 수락

이제 당신은 가장 가까운 준비된 상태에서 테스트 플라이트에서 앱을 테스트할 준비가 되었습니다. 그 전에 다음 것을 수행해야 합니다:

다운로드하는 테스트 플라이트 앱 애플 스토어에서 iOS/iPadOS 기기에서
테스트 플라이트 앱에 대한 초대 수락

테스트 플라이트 앱을 설치하는 방법에 대한 세부 정보는 생략하겠습니다. 앱을 설치하는 방법에 대해 불확실한 경우 구글은 설치 방법에 대한 가이드를 제공하고 있습니다.

초대 수락에 대한 것은 애플에서 이메일을 통해 초대 수락 링크를 보내는 것입니다.

애플에서 초대 수락 링크를 포함한 이메일을 열어야 합니다.
클릭하세요 View in TestFlight 초대 수락
iOS 빌더 Install 버튼
앱을 장치에 설치하세요

Xcode를 사용하여 앱을 이전에 설치한 경우, 다음 화면을 볼 수 있습니다. 버튼을 클릭하세요. install 테스트 플라이트 설치 앱
버튼을 클릭하세요
iOS 빌더 Open 축하합니다 🎉 테스트 플라이트에서 앱 테스트에 대한 초대를 수락했습니다. 이제 __CAPGO_KEEP_0__ 네이티브 빌드를 구성하여 앱을 테스트 플라이트에 제출할 수 있습니다.

Capgo 네이티브 빌드 구성

Capgo

Capgo 네이티브 빌드를 사용하여 앱을 테스트 플라이트에 제출할 수 있도록 하려면 몇 가지 설정을 해야 합니다. 다음은 Capgo CLI에 전달할 항목 목록입니다.

Parameter	설명
`--platform`	빌드할 플랫폼 (`ios`)
`--apple-team-id`	애플 개발자 팀 ID (애플 개발자 포털에서 찾을 수 있음) 애플 개발자 포털)
`--apple-key`	App Store Connect API 키 파일의 경로 (`.p8` 파일)
`--apple-key-id`	App Store Connect API 키의 키 ID
`--apple-issuer-id`	App Store Connect 발급자 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를 찾는 건 매우 쉬워요. 시작하기에 앞서 팀 ID를 알아보겠습니다.

가장 먼저 가야하는 곳은 애플 개발자 계정 그리고 아래로 스크롤
iOS 빌더 Team ID

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

Apple 키로 넘어가겠습니다.

Go to 애플 스토어 연결 사용자 및 접근 페이지

저는 종종 링크가 작동하지 않습니다. 페이지를 다시 로드해 보세요.
정확한 팀을 드롭다운에서 선택하세요
1. 상단 오른쪽에서 이름을 클릭하세요
2. 사용하고 싶은 팀을 클릭하세요
클릭하세요 Integrations 버튼
찾아보세요 issuer

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

버튼을 클릭하여 발급자 복사 copy 애플 스토어 연결 발급자 복사
애플 스토어 연결 키 추가 버튼
버튼을 클릭하여 App manager 클릭하세요 Generate 버튼
키 ID 저장

이 저장해야 할 것입니다 앱 스토어 연결에서 키 ID 복사
__CAPGO_KEEP_0__

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

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

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

인증서

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

그러나 애플은 무한한 지혜로, 인증서를 내보내는 방법은 그들을 만들 때 사용하는 방법과는 상당히 다릅니다 🙃 인증서를 설정하는 방법에 대해 알아보겠습니다:

키 체인 액세스 열기
1. 클릭 Command + Space 검색 바를 열기
2. 검색 Keychain Access
3. 클릭 Keychain Access 앱
선택 login 카테고리 My Certificates 클릭
인증서를 찾으십시오.

인증서의 이름은 Apple Distribution: [Your Name/Company] (your team ID)
인증서 오른쪽 클릭 후 Export
인증서를 .p12 파일

이는 이것은 나중에 필요합니다. 저장되어야 합니다.
1. 인증서 파일 이름을 잘 선택하세요.
2. 파일 형식이 Personal Information Exchange (.p12)
3. 버튼을 클릭하세요. Save 버튼
비밀번호를 묻는 경우, 다음 중 하나를 선택하세요:
- 비밀번호를 입력하지 않고 OK 비밀번호를 설정하세요: 인증서를 비밀번호로 보호하려면 여기에 비밀번호를 설정하세요. 비밀번호가 설정된 파일은
- 옵션을 사용하여 구성 명령을 실행할 때 비밀번호를 제공하면 .p12 파일들은 완전히 Capgo CLI에 의해 지원됩니다. 단지 CLI에서 패스워드를 제공하면 됩니다. --p12-password __CAPGO_KEEP_0__
Mac에 로그인하는 비밀번호를 입력하세요.

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

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

인증서 배포 프로파일

Apple Developer Profiles로 이동하세요.

Go to 상단 우측 코너의 이름을 클릭하세요.
인증서 배포 프로파일
1. 인증서 배포 프로파일
2. 클릭하여 사용할 팀을 선택하세요
올바른 페이지인지 확인하세요 이런 모습이면 좋습니다. 그렇지 않다면 profiles 사이드바에 있는
클릭하여 + 버튼
프로필 유형을 선택하세요 선택 App Store Connect 그리고 클릭하여 Continue 버튼
iOS 앱을 빌드할 앱을 선택하세요

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

애플 개발자 배포 인증서 선택 Continue 버튼

배포 인증서 만료일 선택
프로파일 이름을 지정하고 버튼을 클릭하세요

버튼 Generate 버튼

프로필 이름은 자동으로 Capgo CLI에서 추출되므로 기억할 필요가 없습니다.
프로필을 다운로드하세요

다운로드 프로필을 클릭하세요 Download 주의

다운로드 후 저장해야 합니다 iOS에서 저장해야 합니다. - 나중에 필요할 것입니다.

축하합니다 🎉 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)

이미 완료한 팀 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 키, Apple 키 ID 및 Apple 발급자 ID
`BUILD_CERTIFICATE_BASE64`	내용 `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	생성된 CLI — CLI에서 복사 `.capgo-credentials` 파일
`APPLE_KEY_CONTENT`	내용 `apple_key_base64.txt`
`P12_PASSWORD` (선택 사항)	당신의 `.p12` 비밀번호가 설정된 경우 export 중에

3) GitHub Actions 워크플로우에서 env 변수 사용

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 빌드 경로에서는 App Store Connect/TestFlight에 빌드를 업로드합니다. CI 릴리즈가 또한 App Store 버전과 함께 TestFlight 빌드를 처리하고 App 리뷰에 제출할 경우, App Store Connect __CAPGO_KEEP_0__ 키 자격증서를 포함하여 App Store 버전과 함께 TestFlight 빌드를 첨부하고 App 리뷰에 제출하도록 하십시오. --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, and APP_STORE_CONNECT_TEAM_ID앱 전용 비밀번호 업로드 및 ad_hoc iOS 배포는 검토를 위해 빌드를 제출할 수 없습니다. --store-release-name iOS 버전은 App Store 버전입니다. Capgo이 생략되면 MARKETING_VERSION App Store 버전의 What’s New 텍스트입니다. What’s New 텍스트가 지정되지 않으면 App Store 버전의 What’s New 텍스트가 자동으로 생성됩니다. --store-release-notes iOS 빌더에서 App Store에 표시되는 기본 What's New 텍스트입니다. --store-release-notes-locale "locale=notes" iOS 빌더 --ios-automatic-release entry가 스토어 로케일화를 위해 Override 할 수 있습니다. --no-ios-automatic-release 자동으로 애플 승인 후 릴리즈 하거나 --ios-testflight-groups 수동 릴리즈를 기다릴 수 있습니다.

App Store 리뷰 제출에 필요한 것은 아니지만, 외부 베타 배포를 위해 여전히 사용할 수 있습니다.

By default, Capgo builds iOS apps for App Store distribution (TestFlight + App Store). If you need ad-hoc builds instead (for internal testing or CI artifact collection), you can use the --ios-distribution flag.

어떤 경우에 ad-hoc 모드를 사용해야 하나요?

App Store Connect __CAPGO_KEEP_0__ 키를 사용하지 않거나 사용할 수 없습니다
빌드 아티팩트를 API을 통해 수집하고 싶습니다
App Store에 제출하지 않고 배포하고 싶습니다 --output-upload 요구 사항

Requirements

ad-hoc 빌드는 적게 요구 사항 애플 스토어 빌드보다 적게

인증서	필요한가요?
배포 인증서 (`.p12`)	네
팀 ID (`.mobileprovision`)	네
팀 ID ("`--apple-team-id`)	네
애플 스토어 연결 API 키 ("`.p8`)	No
애플 키 ID / 발급자 ID	아니요

iOS 빌더

같은 단계를 따르세요 프로비저닝 프로파일단계 5에서 Ad Hoc App Store 대신 대신:

Go to 클릭
버튼 + button
선택 Ad Hoc 그리고 Continue 버튼을 클릭하세요
앱과 배포 인증서를 선택하세요
등록하고 싶은 기기를 선택하세요
프로파일 이름을 지어 다운로드하세요

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

App Store 빌드와 비교하여 GitHub Actions에서는 fewer secrets가 필요합니다:

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

앱스 EXTENSIONS (Multi-Target Signing)

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

각 --ios-provisioning-profile CLI: 플래그는 번들 ID를 프로비전 프로파일 파일로 맵핑합니다.

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

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

프로비전 프로파일이 생성된 후에 새로운 기능을 활성화한 것입니다. 이전의 프로비전 프로파일에는 아직 새로운 기능이 포함되어 있지 않습니다.

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

열기 애플 개발자 포털
정확한 팀을 드롭다운 메뉴에서 선택하세요
버튼을 클릭하세요 Profiles 애플 개발자 프로파일 버튼
애플 개발자 프로파일 찾기
iOS 빌더 Edit 버튼
iOS 빌더 Save 버튼
iOS 빌더 Download 버튼
Capgo Native Build 설정 명령 다시 실행 새로 다운로드 한 프로필과 함께 다시 실행하세요.

이 문제는 해결되어야 합니다.

다른 문제

Capgo 네이티브 빌드와 관련된 Capgo 인증 정보 구성 또는 앱 빌드와 관련된 문제가 발생하는 경우, Capgo에 문의해 주세요. 지원.

__CAPGO_KEEP_0__ 네이티브 빌드 계속하기

__CAPGO_KEEP_0__ 네이티브 빌드 iOS 빌드 __CAPGO_KEEP_0__ CI/CD Capgo CI/CD Capgo 네이티브 빌드 Capgo 네이티브 빌드 Capgo 네이티브 빌드 워크플로우를 위한 Capgo 통합(Integrations) Capgo 제품 워크플로우에서 통합. CI/CD CI/CD GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항을 위한.