iOS 빌드

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

iOS 앱을 TestFlight 및 App Store에 제출하는 방법을 Capgo의 전용 Mac 인프라를 사용하여 학습합니다.

학습할 내용

Capgo Native 빌드를 통해 앱을 업로드하는 방법을 학습합니다.
Capgo Native 빌드에 대한 인증서를 구성하는 방법을 학습합니다.

준비물

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

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

2단계 인증을 앱 등록을 위한 애플 계정에 활성화하세요.

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

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

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

아래의 수동 walkthrough는 온보딩을 Capgo가 직접 수행하는 것을 이해하고 싶거나, 인증서를 직접 설정하고 싶은 사람들만 사용하십시오.

첫 번째 수동 빌드

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

배포 인증서를 로컬 머신에 설치합니다
앱 스토어 레코드를 생성합니다 (아직 생성하지 않은 경우)
빌드 프로세스와 관련된 앱 code의 문제를 해결할 수 있습니다

빌드 프로세스를 시작하기 전에, 로컬 머신에 배포 인증서가 설치되어 있어야 합니다. 이것은 매우 복잡하지만, 아래에 설명하겠습니다.

배포 인증서 설정

Xcode 열기
클릭 Xcode -> Settings... 단축키를 사용할 수도 있습니다 Cmd + ,
가장 Accounts
Apple Developer 계정에 추가된 Apple 계정을 찾으세요
배포할 앱을 사용할 팀을 찾으세요
클릭하여 Manage Certificates... 버튼
리스트에 배포 인증서가 보이게 하세요
보이지 않으면 새로운 인증서를 생성해야 합니다

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

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

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

Xcode에서 앱을 열어보세요.

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

Xcode 도구栏 product -> archive 버튼
__CAPGO_KEEP_0__을 완료하기까지 기다립니다.
__CAPGO_KEEP_1__을 클릭하세요. Distribute App __CAPGO_KEEP_2__
__CAPGO_KEEP_3__을 선택하세요. TestFlight Internal Only __CAPGO_KEEP_4__으로 배포 방법을 선택하고 __CAPGO_KEEP_5__을 클릭하세요. Distribute __CAPGO_KEEP_6__으로 Xcode TestFlight 내부 배포 방법
다음 필드를 입력하세요:

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

TestFlight에 자신을 추가하세요.

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

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

테스트 플라이트에 자신을 추가하는 것입니다.

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

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

리스트에서 자신을 찾고 이름 옆에 체크박스를 선택하세요. (자신을 찾을 수 없다면 페이지를 새로 고침해 보세요) 그 다음에 Add 버튼을 클릭하세요.
그룹에 자신이 추가되었는지 확인하세요.

이제 그룹에 자신을 확인할 수 있습니다.

축하합니다 🎉 TestFlight에 자신을 추가했습니다. 이제 Capgo Native Build을 구성하기 전에 마지막으로 하나의 작업이 남았습니다.

준수 정보 설정

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

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

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

이전 섹션에서 설명한 단계를 따라 TestFlight 섹션을 App Store Connect에서 찾으세요.
Click on Builds -> iOS
Find the build with missing compliance information and click on Manage
Select the option that best describes your app

내 앱에 대해 가장 적합한 옵션을 선택하세요. noneFor me, this is
App Store Connect에서 불만족하는 정보를 저장하세요. ready to test

App Store Connect에서 테스트 준비가 완료되었습니다.

As for the second one, here are the steps: Info.plist 파일

__CAPGO_KEEP_0__ 키를 추가하세요.

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

파일을 저장하세요.

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

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

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

TestFlight 앱을 기기에 설치하는 방법에 대한 세부 정보는 생략하겠습니다. 앱을 설치하는 방법에 대해 불확실한 경우, Google은 설치 방법에 대한 훌륭한 안내서를 제공하고 있습니다.

초대 수락에 대한 자세한 내용은 Apple에서 이메일을 통해 초대 수락 링크를 보내드립니다.

Apple에서 초대 수락 링크를 포함한 이메일을 열어주세요.
버튼을 클릭하세요. View in TestFlight 초대 수락 버튼
버튼 Install 버튼
앱을 장치에 설치하세요

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

Capgo Native Build를 구성하세요

Capgo Native Build 구성

Capgo Native Build을 구성해야 하는 몇 가지 사항이 있습니다. 앱을 TestFlight에 제출하고 빌드할 수 있습니다. Capgo CLI에 전달할 항목의 목록입니다.

Parameter	Description
`--platform`	__CAPGO_KEEP_0__을 위한 플랫폼 (`ios`)
`--apple-team-id`	애플 개발자 팀 ID ( 애플 개발자 포털)
`--apple-key`	API Key 파일의 경로 (`.p8` 파일)
`--apple-key-id`	API Key의 Key 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를 찾는 건 매우 쉬워요.

Apple Developer Account로 가서 아래로 스크롤 팀 ID를 찾으세요.
and scroll down Team ID

애플 키, 애플 키 ID 및 애플 발급자 ID

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

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

링크가 작동하지 않는 경우 페이지를 다시 로드해 주세요.
팀을 선택해 주세요.
1. 상단 우측에 있는 이름을 클릭해 주세요.
2. 사용하고 싶은 팀을 클릭해 주세요.
팀 선택 Integrations 버튼
주의: issuer

이것은 나중에 필요할 것입니다 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ copy __CAPGO_KEEP_0__
애플 스토어 연결 플러스 버튼
키 이름을 설정하고 접근 권한을 설정하고 App manager __CAPGO_KEEP_0__ Generate 버튼 클릭
__CAPGO_KEEP_0__ ID를 저장하세요.

이 __CAPGO_KEEP_1__을 저장하세요. - 나중에 필요합니다. App Store Connect에서 키 ID를 복사하세요.
주의

__CAPGO_KEEP_1__ 저장되어야 합니다 - 나중에 필요할 것입니다

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

축하합니다 🎉 애플 키, 애플 키 ID 및 애플 이슈어 ID를 생성했습니다.

인증서

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

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

Keychain Access를 열기
1. Click Command + Space 검색 바를 열기
2. Search for Keychain Access
3. Click on the Keychain Access app
Select the login category and click on the My Certificates button
인증서를 목록에서 찾으세요

The certificate should be named Apple Distribution: [Your Name/Company] (your team ID)
인증서 오른쪽 클릭 후 Export
인증서를 .p12 파일

이 저장되어야 함 - 나중에 필요합니다
1. 인증서 파일의 좋은 이름을 선택하십시오
2. 파일 형식이 설정되어 있는지 확인하세요. Personal Information Exchange (.p12)
3. 버튼을 클릭하세요. Save 버튼
비밀번호를 묻는 경우, 다음 중 하나를 선택할 수 있습니다:
- 비밀번호를 생략 (간단성의 sake에 권장): 비밀번호를 입력하지 않고 OK 비밀번호를 설정: 인증서를 비밀번호로 보호하고 싶다면, 여기에 비밀번호를 설정할 수 있습니다. 비밀번호가 설정된
- 파일은 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__에 의해 완전히 지원됩니다. - 비밀번호를 제공하기 위해 .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password 키체인 액세스 인증서 저장 비밀번호 대화창
Keychain Access save certificate dialog

Mac에 로그인하는 데 사용하는 비밀번호를 입력하세요. 그런 다음 "button."을 클릭하세요. Allow "button."

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

프로비전 프로파일

Apple에서 마지막으로 필요한 것을 얻기 위해, 이제 프로비전 프로파일을 내보내야 합니다.

Apple Developer Profiles로 이동하세요. 팀을 선택하세요.
상단 우측에 있는 이름을 클릭하세요.
1. 사용하고 싶은 팀을 클릭하세요.
2. __CAPGO_KEEP_0__
정확한 페이지에 있으십니까? 페이지가 이렇게 보이지 않으면 profiles 메뉴에 있는
프로필을 클릭하세요. + 버튼
프로필 유형을 선택하세요. 선택 App Store Connect 및 Continue 버튼
애플을 빌드하고 싶은 앱을 선택하세요.

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

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

__CAPGO_KEEP_0__
프로파일 이름을 지어주고 버튼을 클릭하세요.

__CAPGO_KEEP_0__ Generate __CAPGO_KEEP_0__

Capgo CLI의 프로필 이름은 자동으로 추출됩니다. — 기억할 필요가 없습니다.
프로필 다운로드

다운로드 프로필을 클릭하세요. 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)

__CAPGO_KEEP_0__이미 완료되었습니다. 팀 ID, Apple 키, Apple 키 ID 및 Apple 발급자 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`	Your Capgo API 토큰
`APP_STORE_CONNECT_TEAM_ID`	팀 ID 팀 ID
`APPLE_KEY_ID`	키 ID 애플 키, 애플 키 ID 및 애플 이슈어 ID
`APPLE_ISSUER_ID`	이수어 ID 애플 키, 애플 키 ID 및 애플 발급자 ID
`BUILD_CERTIFICATE_BASE64`	내용 `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	CLI에서 복사한 내용 `.capgo-credentials` 파일
`APPLE_KEY_CONTENT`	내용 `apple_key_base64.txt`
`P12_PASSWORD` (선택)	비밀번호가 설정된 경우 `.p12` 3) __CAPGO_KEEP_0__ Actions 워크플로우에서 환경 변수 사용

제목이 '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 }}

Running the build

이제 첫 번째 빌드를 실행할 준비가 되었습니다.

Run the following command to build your app:

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

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

앱 스토어 리뷰 제출

정상 App Store 빌드 경로는 App Store Connect / TestFlight에 빌드를 업로드합니다. CI 릴리스가 TestFlight 빌드를 App Store 버전과 함께 첨부하고 App 리뷰에 제출해야 하는 경우, App Store Connect __CAPGO_KEEP_0__ 키 자격 증명( , )을 전달하여 App Store Connect __CAPGO_KEEP_0__ 키 자격 증명( , )을 전달합니다. --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 키 자격 증명( , )이 필요합니다. App Store Connect API 키 자격 증명( , )이 필요합니다.APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENTApp Store Connect __CAPGO_KEEP_0__ 키 자격 증명( , )이 필요합니다. APP_STORE_CONNECT_TEAM_IDApp Store 버전입니다. Xcode 프로젝트에서 __CAPGO_KEEP_0__을 읽지 않으면 ad_hoc App Store 버전입니다. Xcode 프로젝트에서 __CAPGO_KEEP_0__을 읽지 않으면 --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION 스토어 로컬라이제이션을 위해 App Store What's New 텍스트를 오버라이드할 수 있습니다. --store-release-notes App Store Connect __CAPGO_KEEP_0__ 키 자격 증명( , )이 필요합니다. --store-release-notes-locale "locale=notes" App Store 버전입니다. Xcode 프로젝트에서 __CAPGO_KEEP_0__을 읽지 않으면 --ios-automatic-release Apple 승인 후 자동으로 배포하거나 --no-ios-automatic-release 수동으로 배포를 기다립니다. --ios-testflight-groups App Store 리뷰 제출을 위해는 필요하지 않지만 외부 베타 배포가 가능합니다.

내부 테스트 또는 CI 아티팩트 수집을 위해 ad-hoc 빌드를 필요로 하는 경우

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

__CAPGO_KEEP_1__ ad-hoc mode 사용하는 시점

__CAPGO_KEEP_2__ 장치에 IPA를 직접 배포하고 싶습니다 (TestFlight 사용하지 않음)
App Store Connect API 키를 사용하지 않거나 사용하지 않으려면
__CAPGO_KEEP_3__를 통해 빌드 아티팩트를 수집하고 싶습니다 --output-upload App Store에 제출하지 않고

__CAPGO_KEEP_4__

ad-hoc 빌드는 __CAPGO_KEEP_5__ App Store 빌드보다 더 좋습니다:

인증 정보	필요한가요?
인증서 (`.p12`)	Yes
어드혹 배포 프로파일 (`.mobileprovision`)	Yes
팀 ID (`--apple-team-id`)	Yes
App Store Connect API 키 (`.p8`)	No
Apple 키 ID / 발급자 ID	No

Creating an ad-hoc provisioning profile

Follow the same steps as Provisioning profile but in step 5, select Ad Hoc instead of App Store:

Go to Apple Developer Profiles
Click the + button
Select 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 필요하지 않습니다.

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__를 수집하기 위해 IPA를 빌드 아티팩트로 추가하세요. --output-upload:

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

__CAPGO_KEEP_0__

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은 repeatable --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:

모바일 프로비전 파일을 읽습니다.
프로비전 파일 내부의 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 기능이 포함되어 있지 않습니다.

오류가 발생하는 경우가 있습니다.

__CAPGO_KEEP_0__

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

이러한 문제는 새로운 기능을 활성화한 후 배포 프로파일이 생성된 후에 발생합니다. 배포 프로파일이 생성된 시점에는 새로운 기능이 포함되지 않았습니다.

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

Open Apple Developer Portal
선택한 팀이 올바른 팀인지 확인하세요.
선택한 팀이 올바른 팀인지 확인하세요. Profiles button
배포 프로파일을 다시 생성하고 싶은 프로파일을 찾으세요.
선택한 팀이 올바른 팀인지 확인하세요. Edit 버튼
버튼을 클릭하세요. Save 버튼
버튼을 클릭하세요. Download 버튼
Capgo 네이티브 빌드 설정 명령을 다시 실행하세요. 새로 다운로드 한 프로필과 함께. 이 문제를 해결할 수 있습니다.

기타 문제들.

Other issues

어떤 이유로든 Capgo 네이티브 빌드, 인증 정보를 설정하거나 앱을 빌드하는 문제가 있으시면, Capgo를 통해 언제든지 연락해 주세요. 지원.

iOS 빌드에서 계속

CI/CD 자동화 계획을 위해 사용하시는 경우, __CAPGO_KEEP_0__ CI/CD와 연결하세요. __CAPGO_KEEP_0__ CI/CD에서 __CAPGO_KEEP_0__ CI/CD 제품 워크플로우와 연결하세요. __CAPGO_KEEP_0__ 네이티브 빌드에서 __CAPGO_KEEP_0__ 네이티브 빌드 제품 워크플로우와 연결하세요. Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo 통합 제품 워크플로우에서 Capgo 통합을 위해 CI/CD 통합 CI/CD 통합의 구현 세부 정보를 위해 GitHub 액션 통합 GitHub 액션 통합의 구현 세부 정보를 위해

iOS 빌드

학습할 내용

준비물

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

첫 번째 수동 빌드

배포 인증서 설정

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

테스트 플라이트에 자신을 추가하는 것입니다.

준수 정보 설정

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

Capgo Native Build 구성

팀 ID

애플 키, 애플 키 ID 및 애플 발급자 ID

인증서

프로비전 프로파일

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

CI/CD 설정 (GitHub Actions)

1) 인증 파일을 단일 줄 base64로 변환하기

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

제목이 '3) GitHub Actions 워크플로우에서 환경 변수 사용'인 섹션

Running the build

앱 스토어 리뷰 제출

내부 테스트 또는 CI 아티팩트 수집을 위해 ad-hoc 빌드를 필요로 하는 경우

__CAPGO_KEEP_1__ ad-hoc mode 사용하는 시점

__CAPGO_KEEP_4__

Creating an ad-hoc provisioning profile

Ad-hoc 인증서 저장

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

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

예시: 앱 + 공유 확장 프로그램

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

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

오류가 발생하는 경우가 있습니다.

Other issues

iOS 빌드에서 계속