🔹 build

🏗️ Capgo Cloud를 통해 iOS/Android Native Build를 관리하세요.

빌드 액세스 및 출력

Native cloud builds는 모든 Capgo 플랜에서 사용할 수 있습니다. 빌드 인증 정보는 Capgo 서버에 저장되지 않으며, 빌드 시에만 사용된 후 즉시 삭제됩니다. 빌드 결과물은 선택적으로 유효 기간이 있는 다운로드 링크와 함께 upload할 수 있습니다.

인증 정보 우선 저장

npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform ios
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform android

CI에서 출력 URL 캡처하기

통과 --output-record 다운로드 URL과 QR code을 유지하려면 다음을 사용하세요: build last-output 읽으려면:

npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.json
npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl

🔹 필수 사항

npx @capgo/cli@latest build needed

🧭 Native Build가 필요하면 “yes”를 출력하고 code 1로 종료합니다. 그렇지 않으면 “no”를 출력하고 code 0으로 종료합니다. 명령이 실패하면 code 2로 종료됩니다.

예시:

npx @capgo/cli@latest build needed com.example.app --channel production --verbose

옵션:

파라미터	타입	설명
-a	string	계정 연결을 위한 API 키
-c	string	비교 대상 채널. 기본값은 CapacitorUpdater.defaultChannel 또는 공개 기본 채널입니다.
—package-json	string	모노레포용 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포용 node_modules 디렉토리 경로 (쉼표로 구분)
--verbose	boolean	상세 로그가 포함된 verbose 출력을 활성화합니다
--supa-host	string	커스텀 Supabase host URL (self-hosting 또는 Capgo 개발용)
--supa-anon	string	커스텀 Supabase anon key (self-hosting용)

🚀 Init

별칭: onboarding

npx @capgo/cli@latest build init

빌드 인증 정보를 대화형으로 설정합니다 (iOS: 인증서 및 프로필 자동화; Android: keystore + Google OAuth를 통해 GCP 서비스 계정 및 Play Console 초대 권한 부여)

옵션:

파라미터	타입	설명
-a	string	계정 연결을 위한 API 키
-p	string	온보딩할 플랫폼(ios 또는 android). 생략하면 네이티브 폴더가 하나일 때 자동 감지하고, 아니면 사용자에게 묻습니다.
--supa-host	string	커스텀 Supabase host URL (self-hosting 또는 Capgo 개발용)
—no-analytics	boolean	이번 실행에서 build onboarding analytics와 terminal replay를 비활성화합니다.

🔹 요청

npx @capgo/cli@latest build request

Capgo Cloud에 Native Build를 요청합니다. 이 명령은 프로젝트 디렉토리를 zip 파일로 압축하여 빌드를 위해 Capgo에 upload합니다. 빌드가 완료되면 앱 스토어로 직접 전송됩니다. 인증 정보는 Capgo 서버에 저장되지 않으며 빌드 후 즉시 삭제됩니다. 빌드를 요청하기 전에 정보를 저장해 두세요:

npx @capgo/cli build credentials save --appId APP_ID --platform ios

예시:

npx @capgo/cli@latest build request com.example.app --platform ios --path .

옵션:

파라미터	타입	설명
—path	string	빌드할 프로젝트 디렉토리 경로 (기본값: 현재 디렉토리)
—node-modules	string	모노레포용 node_modules 디렉토리 경로 (쉼표로 구분)
—platform	string	대상 플랫폼: ios 또는 android (필수)
—build-mode	string	빌드 모드: debug 또는 release (기본값: release)
—build-certificate-base64	string	iOS: Base64로 인코딩된 .p12 인증서
—p12-password	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없는 경우 생략 가능)
—apple-id	string	iOS: 앱 전용 비밀번호 업로드를 위한 Apple ID 이메일 (API 키 대신 사용 가능)
—apple-app-specific-password	string	iOS: TestFlight 업로드를 위한 앱 전용 비밀번호 (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: App Store Connect 앱 숫자 ID (__apple-id__ 및 __apple-app-specific-password__와 함께 사용 필수)
—apple-key-id	string	iOS: App Store Connect API Key ID
—apple-issuer-id	string	iOS: App Store Connect Issuer ID
—apple-key-content	string	iOS: Base64로 인코딩된 App Store Connect API 키 (.p8)
—app-store-connect-team-id	string	iOS: App Store Connect Team ID
—ios-scheme	string	iOS: 빌드할 Xcode scheme (기본값: App)
—ios-target	string	iOS: 빌드 설정을 읽어올 Xcode target (기본값: scheme과 동일)
—xcode-version	string	iOS: 지정한 Xcode 버전이 설치된 환경에서 빌드 (예: 26, 26.0.1, 27). 메이저 버전 지정 시 마이너 버전은 무관함. 기본값: 모든 환경. 우선순위: CLI > 환경 변수 (CAPGO_IOS_XCODE_VERSION) > 저장된 자격 증명
—ios-distribution	string	iOS: Distribution 모드
—ios-provisioning-profile	string	iOS: 프로비저닝 프로파일 경로 또는 bundleId=path 매핑 (중복 사용 가능)
—android-keystore-file	string	Android: Base64로 인코딩된 keystore 파일
—keystore-key-alias	string	Android: Keystore 키 별칭(alias)
—keystore-key-password	string	Android: Keystore 키 비밀번호
—keystore-store-password	string	Android: Keystore 저장소 비밀번호
—play-config-json	string	Android: Base64로 인코딩된 Google Play 서비스 계정 JSON
--android-flavor	string	Android: 빌드할 Product flavor (예: production). 프로젝트에 여러 flavor가 있는 경우 필수입니다.
--android-track	string	Android: 이번 upload에 적용할 Google Play 트랙 (internal, alpha, beta, production). --submit-to-store-review 미사용 시 기본값: internal. --submit-to-store-review 사용 시 트랙 미지정 시: production. 우선순위: CLI > env > 저장된 credentials
--android-release-status	string	Android: Google Play 출시 상태 (draft, completed, inProgress, halted). —submit-to-store-review가 없으면 기본값: draft. —submit-to-store-review 사용 시 상태를 지정하지 않으면: completed. 우선순위: CLI > env > 저장된 자격 증명
--in-app-update-priority	string	Android: 이번 릴리스의 Google Play 인앱 업데이트 우선순위 (정수 0–5; 높을수록 더 긴급). 참고: https://developer.android.com/guide/playcore/in-app-updates. 우선순위: CLI > env > 저장된 자격 증명
--no-playstore-upload	boolean	이번 빌드의 Play Store 업로드를 건너뜁니다 (저장된 play 설정을 null로 처리). —output-upload가 필요합니다.
—submit-to-store-review	boolean	업로드 후 빌드를 draft/비활성 상태로 두지 않고, 스토어 출시를 리뷰에 제출합니다. Android에서는 기본적으로 release_status가 completed인 production 트랙으로 제출됩니다 (—android-track / PLAY_STORE_TRACK 및 —android-release-status / PLAY_STORE_RELEASE_STATUS로 재정의 가능). iOS에서는 처리된 TestFlight 빌드를 App Store 리뷰에 제출합니다.
—store-release-name	string	스토어 출시 이름/버전 라벨. Android는 이를 Google Play의 version_name으로 전송하며, iOS는 편집 가능한 버전을 생성하거나 재사용할 때 App Store 버전으로 사용합니다.
—store-release-notes	string	기본 스토어 출시 노트입니다. Android에서는 Play 스토어 변경 사항으로 사용되며, iOS에서는 App Store의 '새로운 기능' 텍스트의 대체값으로 사용됩니다.
—store-release-notes-locale	string	언어별 스토어 출시 노트(중복 사용 가능). 예: —store-release-notes-locale en-US="Bug fixes" —store-release-notes-locale ko-KR="버그 수정".
—ios-testflight-groups	string	iOS: 외부 베타 배포를 위한 TestFlight 외부 그룹 이름 또는 ID를 쉼표로 구분하여 입력합니다(선택 사항).
—ios-automatic-release	boolean	iOS: Apple 승인 후 App Store 버전을 자동으로 출시합니다. 기본값은 수동 출시입니다.
—no-ios-automatic-release	boolean	iOS: Apple 승인 후 App Store 버전을 수동 출시 대기 상태로 유지합니다.
—output-upload	boolean	이번 빌드에 대해서만 결과물 업로드 동작을 재정의합니다 (활성화). 우선순위: CLI > env > 저장된 자격 증명
—no-output-upload	boolean	이번 빌드에 대해서만 결과물 업로드 동작을 재정의합니다 (비활성화). 우선순위: CLI > env > 저장된 자격 증명
—output-retention	string	이번 빌드에 대해서만 결과물 링크 TTL을 재정의합니다 (1h ~ 7d). 예시: 1h, 6h, 2d. 우선순위: CLI > env > 저장된 자격 증명
—output-record	string	빌드 성공 후, 지정된 경로에 JSON 레코드(jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)를 기록합니다. 또한 해당 경로에 code 접미사가 붙은 PNG QR 코드도 함께 저장됩니다. .qr.png 기록된 필드는 다음 명령어로 다시 읽을 수 있습니다: build last-output.
—no-cache	boolean	빌드 캐시 복원 건너뛰기 및 이번 빌드에 대한 새로운 캐시 항목을 저장하지 않습니다. 빌드 캐시는 앱별로 기본 활성화되어 있습니다.
—cache-key	string	환경, 브랜치 또는 Android flavor별로 빌드 캐시를 분할합니다 (예: prod, staging). 앱당 하나의 공용 기본 캐시를 사용하려면 생략하세요.
—no-skip-build-number-bump	boolean	저장된 자격 증명을 무시하고 이번 빌드에 대해서만 빌드 번호 자동 증가를 다시 활성화합니다.
—skip-marketing-version-bump	boolean	앱이 이미 출시된 경우 마케팅 버전(CFBundleShortVersionString / versionName)의 자동 증가를 건너뜁니다.
—sync-ios-version	boolean	iOS: 프로젝트를 업로드하기 전에 package.json의 Xcode MARKETING_VERSION을 동기화합니다.
—ai-analytics	boolean	빌드 실패 시 로그를 Capgo AI로 전송하여 진단합니다. 대화형 터미널에서는 사전 확인 절차를 건너뛰며, CI 환경에서는 자동으로 업로드한 뒤 분석 결과를 stderr에 출력합니다.
—no-prescan	boolean	자동 빌드 전 스캔을 건너뜁니다
—prescan-ignore-fatal	boolean	pre-build 스캔을 실행하되 빌드를 차단하지는 않습니다 (리포트만)
—prescan-skip	string	id로 특정 prescan 체크를 건너뜁니다 (반복 지정 또는 쉼표로 구분). 다른 체크는 계속 실행됩니다.
—prescan-warn	string	id로 특정 prescan 체크를 경고로 낮춥니다 (반복 지정 또는 쉼표로 구분). 체크는 계속 실행됩니다.
—fail-on-warnings	boolean	prescan 경고를 fatal로 처리합니다
—send-logs-to-support	boolean	CI/CD 빌드 실패 시 빌드 로그를 Capgo 지원팀으로 자동 업로드합니다 (이메일 불필요). Capgo 지원팀에 알림이 전송되고 이메일로 후속 안내가 진행됩니다. —ai-analytics에 추가로 적용됩니다.
—send-logs	boolean	—send-logs-to-support의 deprecated 별칭입니다
-a	string	계정 연결을 위한 API 키
--supa-host	string	커스텀 Supabase host URL (self-hosting 또는 Capgo 개발용)
--supa-anon	string	커스텀 Supabase anon key (self-hosting용)
--verbose	boolean	상세 로그가 포함된 verbose 출력을 활성화합니다

빌드 캐시: 기본적으로 Capgo는 앱별로 컴파일된 Native Build 아티팩트(CocoaPods, Gradle 및 관련 출력물)를 복구하고 저장합니다. --cache-key 를 사용하여 RC와 프로덕션 캐시를 분리할 수 있으며, --no-cache 를 사용하면 일회성 클린 빌드가 가능합니다. API 통합 환경에서는 cache_key 또는 cache_enabled: false 를 빌드 요청 페이로드에 전달할 수 있습니다. 자세한 내용은 빌드 캐시 및 문제 해결: 잘못된 캐시 복구.

🔹 Sync-ios-version

npx @capgo/cli@latest build sync-ios-version

package.json의 MARKETING_VERSION을 로컬 iOS Xcode 프로젝트에 동기화합니다.

예시:

npx @capgo/cli@latest build sync-ios-version --path .

옵션:

파라미터	타입	설명
—path	string	프로젝트 디렉토리 경로 (기본값: 현재 디렉토리)
—check	boolean	체크만 수행하며, MARKETING_VERSION이 일치하지 않으면 0이 아닌 종료 코드를 반환합니다.

🔹 Prescan

npx @capgo/cli@latest build prescan

업로드 전, 클라우드 빌드 실패를 유발할 수 있는 프로젝트 및 저장된 자격 증명의 문제를 스캔합니다. 자격 증명(만료, 비밀번호, 프로필 페어링), 프로젝트 상태(cap sync, node_modules 구조), 플랫폼 설정을 확인합니다. 다음 내에서 자동으로 실행됩니다: build request; 이 명령은 단독(예: CI 환경)으로 실행할 수 있습니다. 자세한 내용은 Prescan 검사 전체 체크 항목 목록과 개별 규칙을 --skip / --warn 확인하는 방법을 참조하세요.

옵션:

파라미터	타입	설명
—platform	string	대상 플랫폼: ios 또는 android (필수)
—path	string	프로젝트 디렉토리 경로 (기본값: 현재 디렉토리)
-a	string	계정 연결을 위한 API 키
—android-flavor	string	Android: 빌드에 사용할 product flavor
—ios-dist	string	iOS: 검증할 distribution mode
—json	boolean	기계 판독이 가능한 JSON 형식으로 리포트 출력
—fail-on-warnings	boolean	경고 발생 시 종료 코드를 non-zero로 반환 (CI용)
—ignore-fatal	boolean	진단 모드: 모든 내용을 보고하지만 종료 코드는 항상 0으로 반환
—skip	string	ID를 지정하여 특정 체크 항목 건너뛰기 (중복 사용 또는 쉼표로 구분)
—warn	string	ID를 지정하여 특정 체크 항목을 경고로 하향 조정 (중복 사용 또는 쉼표로 구분)
--verbose	boolean	상세 로그가 포함된 verbose 출력을 활성화합니다
--supa-host	string	커스텀 Supabase host URL (self-hosting 또는 Capgo 개발용)
--supa-anon	string	커스텀 Supabase anon key (self-hosting용)

🔹 Last-output

npx @capgo/cli@latest build last-output

이전 빌드에서 생성된 빌드 출력 기록을 읽어옵니다. build request --output-record. 기본적으로 전체 JSON을 출력하며, —field 옵션으로 특정 필드만, 또는 —qr 옵션으로 ASCII QR code를 출력할 수 있습니다. CI 환경에서 다운로드 URL이나 QR 코드를 가져와 PR이나 Issue에 남길 때 유용합니다. 예시: npx @capgo/cli build last-output —path /tmp/build.json npx @capgo/cli build last-output —path /tmp/build.json —field outputUrl npx @capgo/cli build last-output —path /tmp/build.json —qr

옵션:

파라미터	타입	설명
—path	string	—output-record 명령어로 생성된 JSON 레코드의 경로 (필수)
—field	string	특정 필드 하나만 출력 (jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion 중 선택)
—qr	boolean	렌더링된 ASCII QR code 출력 (—field qrCodeAscii의 단축 명령어)

🔹 Credentials

로컬 머신에 저장된 빌드 credentials를 관리합니다. 🔒 보안 안내:

• Credentials는 ~/.capgo-credentials/credentials.json (글로벌) 또는 .capgo-credentials.json (로컬)에 저장됩니다
• 빌드 시 Capgo로 전송되지만, 절대 영구 저장되지 않습니다
• Capgo에서 빌드 직후 즉시 삭제됩니다
• 빌드 결과물은 기간 한정 다운로드 링크를 위해 선택적으로 업로드할 수 있습니다 📚 DOCUMENTATION: iOS 설정: https://capgo.app/docs/cli/cloud-build/ios/ Android 설정: https://capgo.app/docs/cli/cloud-build/android/

🔹 Apple-key

별칭: asc-key

npx @capgo/cli@latest build credentials apple-key

macOS 전용 가이드 도우미를 사용하여 App Store Connect 팀 API 키를 생성합니다. 내장 브라우저를 통해 Apple의 App Store Connect UI를 안내하는 네이티브 창이 열리며, Issuer ID와 Key ID를 자동으로 캡처하고, 일회용 .p8 파일을 가로채 Apple에서 검증한 뒤 ~/.appstoreconnect/private_keys에 저장합니다. 진행 통계는 Capgo analytics로 전송됩니다 (CAPGO_DISABLE_TELEMETRY__로 비활성화 가능). npx @capgo/cli build credentials apple-key —appId com.example.app

예시:

Example:

옵션:

파라미터	타입	설명
-a	string	계정 연결을 위한 API 키
—appId	string	캡처된 키를 해당 앱의 iOS build credentials에 저장합니다
—local	boolean	글로벌 파일 대신 프로젝트별 .capgo-credentials.json에 저장합니다
—json	boolean	캡처된 Key ID / Issuer ID / .p8 경로를 JSON 형식으로 출력합니다

🔹 저장

npx @capgo/cli@latest build credentials save

iOS 또는 Android용 빌드 인증 정보를 로컬에 저장합니다. 인증 정보 저장 위치:

• ~/.capgo-credentials/credentials.json (기본값, 글로벌)
• 프로젝트 루트의 .capgo-credentials.json (--local 플래그 사용 시) ⚠️ 빌드 전 필수 사항: 빌드를 요청하기 전에 반드시 인증 정보를 저장해야 합니다. 🔒 이 인증 정보는 Capgo 서버에 영구적으로 저장되지 않습니다. 빌드가 완료되면 즉시 삭제됩니다. 📚 설정 가이드: iOS: https://capgo.app/docs/cli/cloud-build/ios/ Android: https://capgo.app/docs/cli/cloud-build/android/ npx @capgo/cli build credentials save —platform ios
  —certificate ./cert.p12 —p12-password “password”
  —ios-provisioning-profile ./profile.mobileprovision
  —apple-key ./AuthKey.p8 —apple-key-id “KEY123”
  —apple-issuer-id “issuer-uuid” —apple-team-id “team-id” 멀티 타겟 예시 (앱 + 위젯 익스텐션): npx @capgo/cli build credentials save —platform ios
  —ios-provisioning-profile ./App.mobileprovision
  —ios-provisioning-profile com.example.widget=./Widget.mobileprovision
  … npx @capgo/cli build credentials save —platform android
  —keystore ./release.keystore —keystore-alias “my-key”
  —keystore-key-password “key-pass”
  —play-config ./service-account.json 로컬 저장소 (프로젝트별): npx @capgo/cli build credentials save —local —platform ios …

예시:

iOS Example:

옵션:

파라미터	타입	설명
—appId	string	App ID (예: com.example.app) (필수)
—platform	string	Platform: ios 또는 android (필수)
—certificate	string	iOS: .p12 인증서 파일 경로
—ios-provisioning-profile	string	iOS: 프로비저닝 프로파일 경로 또는 bundleId=path (중복 사용 가능)
—p12-password	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없는 경우 생략 가능)
—apple-key	string	iOS: .p8 App Store Connect API 키 경로
—apple-key-id	string	iOS: App Store Connect API Key ID
—apple-issuer-id	string	iOS: App Store Connect Issuer ID
—apple-team-id	string	iOS: App Store Connect Team ID
—ios-distribution	string	iOS: 배포 모드
—apple-id	string	iOS: 앱 전용 암호 업로드용 Apple ID 이메일 (App Store Connect API 키 대신 사용)
—apple-app-specific-password	string	iOS: TestFlight 업로드용 앱 전용 암호 (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: App Store Connect 숫자 앱 ID (—apple-id 및 —apple-app-specific-password와 함께 필수)
—keystore	string	Android: keystore 파일 경로 (.keystore 또는 .jks)
—keystore-alias	string	Android: Keystore 키 별칭
—keystore-key-password	string	Android: Keystore 키 비밀번호
—keystore-store-password	string	Android: Keystore 저장소 비밀번호
—play-config	string	Android: Play Store 서비스 계정 JSON 경로
—android-flavor	string	Android: 빌드할 Product flavor (예: production). 프로젝트에 여러 flavor가 있는 경우 필수입니다.
—in-app-update-priority	string	Android: 향후 릴리스의 Google Play 인앱 업데이트 우선순위 (정수 0–5; 높을수록 긴급). 생략하면 Play의 기존 값을 그대로 둡니다.
—local	boolean	글로벌 ~/.capgo-credentials/ 대신 프로젝트 루트의 .capgo-credentials.json에 저장
—output-upload	boolean	빌드 결과물(IPA/APK/AAB)을 Capgo 스토리지에 업로드하고 다운로드 링크를 출력
—no-output-upload	boolean	빌드 결과물(IPA/APK/AAB)을 Capgo 스토리지에 업로드하지 마세요
—output-retention	string	출력 링크 TTL: 1h~7d (기본값: 1h). 예시: 1h, 6h, 2d
—skip-build-number-bump	boolean	향후 빌드에서 빌드 번호/버전 code 자동 증가를 건너뜁니다
—no-skip-build-number-bump	boolean	빌드 번호 자동 증가를 다시 활성화합니다 (기본 동작)
—skip-marketing-version-bump	boolean	앱이 이미 출시된 경우 향후 빌드에서 마케팅 버전 자동 증가를 건너뜁니다
—no-skip-marketing-version-bump	boolean	마케팅 버전 자동 증가를 다시 활성화합니다 (기본 동작)

📋 목록

npx @capgo/cli@latest build credentials list

저장된 build credentials 목록을 보여줍니다 (비밀번호는 마스킹 처리됨). 현재 저장된 credentials(global 및 local 모두 포함)를 확인합니다. 예시: npx @capgo/cli build credentials list # 모든 앱 목록 표시 npx @capgo/cli build credentials list —appId com.example.app # 특정 앱 목록 표시

옵션:

파라미터	타입	설명
—appId	string	목록을 표시할 App ID (생략 시 전체 목록 표시)
—local	boolean	로컬 .capgo-credentials.json 파일의 인증 정보만 표시

🔹 Clear

npx @capgo/cli@latest build credentials clear

저장된 build credentials를 삭제합니다. 스토리지에서 credentials를 제거합니다. 특정 credentials를 대상으로 하려면 —appId와 —platform을 사용하세요. 예시: npx @capgo/cli build credentials clear # 모든 앱 삭제 (global) npx @capgo/cli build credentials clear —local # 로컬 credentials 삭제 npx @capgo/cli build credentials clear —appId com.example.app —platform ios

옵션:

파라미터	타입	설명
—appId	string	삭제할 App ID (생략 시 모든 앱 삭제)
—platform	string	삭제할 플랫폼: ios 또는 android (생략 시 모든 플랫폼 삭제)
—local	boolean	글로벌 대신 로컬 .capgo-credentials.json에서 삭제

🔹 업데이트

npx @capgo/cli@latest build credentials update

모든 정보를 다시 입력할 필요 없이 특정 자격 증명만 업데이트합니다. 변경하려는 필드만 제공하여 기존 자격 증명을 업데이트하세요. 제공된 옵션을 통해 플랫폼이 자동으로 감지됩니다. 예시: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks

옵션:

파라미터	타입	설명
—appId	string	App ID (capacitor.config에 생략 시 자동 감지)
—platform	string	Platform: ios 또는 android (옵션에서 자동 감지)
—local	boolean	글로벌 대신 로컬 .capgo-credentials.json 업데이트
—certificate	string	P12 인증서 파일 경로
—ios-provisioning-profile	string	Provisioning profile 경로 또는 bundleId=path (중복 지정 가능, 기본값은 병합)
—overwrite-ios-provisioning-map	boolean	기존 프로비저닝 맵을 병합하지 않고 전체를 교체 (기본값: merge)
—p12-password	string	P12 인증서 비밀번호
—apple-key	string	App Store Connect API 키 경로 (.p8 파일)
—apple-key-id	string	App Store Connect API Key ID
—apple-issuer-id	string	App Store Connect Issuer ID
—apple-team-id	string	App Store Connect Team ID
—apple-id	string	iOS: 앱 전용 암호 업로드용 Apple ID 이메일 (App Store Connect API 키 대신 사용)
—apple-app-specific-password	string	iOS: TestFlight 업로드용 앱 전용 암호 (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: App Store Connect 숫자 앱 ID (—apple-id 및 —apple-app-specific-password와 함께 필수)
—ios-distribution	string	iOS: 배포 모드
—keystore	string	keystore 파일 경로 (.keystore 또는 .jks)
—keystore-alias	string	Keystore 키 별칭
—keystore-key-password	string	Keystore 키 비밀번호
—keystore-store-password	string	Keystore 저장소 비밀번호
—play-config	string	Google Play 서비스 계정 JSON 경로
—android-flavor	string	Android: 빌드할 Product flavor (예: production). 프로젝트에 여러 flavor가 있는 경우 필수입니다.
—in-app-update-priority	string	Android: 향후 릴리스를 위한 Google Play 인앱 업데이트 우선순위 (정수 0–5; 높을수록 긴급함).
—output-upload	boolean	빌드 결과물(IPA/APK/AAB)을 Capgo 스토리지에 업로드하고 다운로드 링크를 출력
—no-output-upload	boolean	빌드 결과물(IPA/APK/AAB)을 Capgo 스토리지에 업로드하지 마세요
—output-retention	string	출력 링크 TTL: 1h~7d. 예시: 1h, 6h, 2d
—skip-build-number-bump	boolean	향후 빌드에서 빌드 번호/버전 code 자동 증가를 건너뜁니다
—no-skip-build-number-bump	boolean	빌드 번호 자동 증가를 다시 활성화합니다 (기본 동작)
—skip-marketing-version-bump	boolean	앱이 이미 출시된 경우 향후 빌드에서 마케팅 버전 자동 증가를 건너뜁니다
—no-skip-marketing-version-bump	boolean	마케팅 버전 자동 증가를 다시 활성화합니다 (기본 동작)

🔹 관리

npx @capgo/cli@latest build credentials manage

저장된 빌드 인증 정보를 대화형으로 관리합니다. 저장된 인증 정보를 확인하고, 설정 내용을 보거나, CI/CD용 .env 파일을 내보내고, 특정 플랫폼의 인증 정보를 삭제할 수 있습니다. 다음의 TUI를 사용합니다: capgo init. 예시: npx @capgo/cli build credentials manage npx @capgo/cli build credentials manage —appId com.example.app npx @capgo/cli build credentials manage —appId com.example.app —platform ios npx @capgo/cli build credentials manage —local

옵션:

파라미터	타입	설명
—appId	string	관리할 App ID (선택 사항, 생략 시 선택 프롬프트 표시)
—platform	string	관리할 플랫폼: ios 또는 android (선택 사항, 생략 시 선택 프롬프트 표시)
—local	boolean	로컬 .capgo-credentials.json 파일만 탐색

🔹 Migrate

npx @capgo/cli@latest build credentials migrate

기존 provisioning profile을 새로운 multi-target 형식으로 마이그레이션합니다. BUILD_PROVISION_PROFILE_BASE64를 CAPGO_IOS_PROVISIONING_MAP으로 변환합니다. Xcode 프로젝트에서 메인 bundle ID를 자동으로 찾아냅니다. npx @capgo/cli build credentials migrate —platform ios

예시:

Example:

옵션:

파라미터	타입	설명
—appId	string	App ID (capacitor.config에서 생략 시 자동 감지)
—platform	string	Platform (ios만 지원)
—local	boolean	글로벌 대신 로컬 .capgo-credentials.json에서 마이그레이션