🔹 빌드

🏗️ Capgo Cloud를 통해 네이티브 iOS/Android 빌드를 관리하세요.

빌드 접근 및 출력

네이티브 클라우드 빌드 요청은 현재 제한된 베타 상태이며 접근이 제한되어 있습니다. 빌드 자격 증명은 Capgo 서버에 저장되지 않습니다: 빌드만 사용하고 삭제됩니다. 빌드 출력은 옵션으로 시간 제한된 다운로드 링크와 함께 업로드할 수 있습니다.

자격 증명을 저장하세요

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 빌드가 필요하면 "yes"를 출력하고 code 1로 종료; 그렇지 않으면 "no"를 출력하고 code 0으로 종료. 명령어 실패는 code 2로 종료.

예시:

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

옵션:

Param	Type	설명
-a	string	API 키를 사용하여 계정에 연결
-c	string	Capacitor 업데이터의 기본 채널 또는 공공 기본 채널을 기준으로 하는 채널
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—verbose	boolean	세부 로깅과 함께 자세한 출력을 활성화합니다.
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위해 사용하는 커스텀 Supabase anon 키

🚀 초기화

Alias: onboarding

npx @capgo/cli@latest build init

iOS: 인증서 + 프로파일 자동화; Android: 키스토어 + Google OAuth GCP 서비스 계정 및 Play Console 초대

Options:

Param	Type	설명
-a	string	API 계정에 연결하는 키
-p	string	플랫폼을 선택하세요 (ios 또는 android). 만약 하나의 네이티브 폴더만 존재하면 자동으로 감지하지만, 그렇지 않으면 사용자에게提示합니다.
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—no-analytics	boolean	이 빌드에서 빌드 온보딩 분석 및 터미널 재생을 비활성화합니다.

🔹 요청

npx @capgo/cli@latest build request

Request a native build from Capgo Cloud. This command will zip your project directory and upload it to Capgo for building. The build will be processed and sent directly to app stores. Credentials are never stored on Capgo servers; they are deleted after the build. Save them before requesting a build:

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: 앱 스토어 연결 API 키 대신 앱 스토어 연결 이메일
—apple-app-specific-password	string	iOS: 테스트 플라이트 업로드를 위한 앱 스토어 연결 앱 스토어 비밀번호 (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 키 ID
—apple-issuer-id	string	iOS: App Store Connect 발급자 ID
—apple-key-content	string	iOS: Base64 인코딩 App Store Connect API 키 (.p8)
—app-store-connect-team-id	string	iOS: App Store Connect 팀 ID
—ios-scheme	string	iOS: Xcode scheme을 빌드하기 위한 (기본: App)
—ios-target	string	iOS: Xcode target for reading build settings (default: same as scheme)
—ios-distribution	string	iOS: 배포 모드
—ios-provisioning-profile	string	iOS: 인증서 프로파일 경로 또는 bundleId=path mapping (반복 가능)
—android-keystore-file	string	안드로이드: Base64 인코딩 키스토어 파일
—keystore-key-alias	string	안드로이드: 키스토어 키 별칭
—keystore-key-password	string	안드로이드: 키스토어 키 비밀번호
—keystore-store-password	string	안드로이드: Keystore 저장소 암호
—play-config-json	string	안드로이드: Google Play 서비스 계정 JSON (Base64 인코딩)
—android-flavor	string	안드로이드: 빌드할 제품 맛집 (예: 프로덕션). 프로젝트가 여러 맛집을 가지고 있다면 필수입니다.
—android-track	string	안드로이드: 업로드할 Google Play 트랙 (내부, 알파, 베타, 프로덕션). —submit-to-store-review 옵션 없이 기본값은 내부입니다. —submit-to-store-review 옵션과 트랙을 설정하지 않으면 프로덕션입니다. 우선순위: CLI > 환경 변수 > 저장된 자격증명
—android-release-status	string	안드로이드: Google Play 릴리스 상태 (draft, completed, inProgress, halted). —submit-to-store-review 옵션 없이 기본값은 draft입니다. —submit-to-store-review 옵션과 상태를 설정하지 않으면 completed입니다. 우선순위: CLI > 환경 변수 > 저장된 자격증명
—in-app-update-priority	string	안드로이드: Google Play 내 앱 업데이트 우선순위 (0-5 사이의 정수; 더 높을수록 더 급합니다). 자세한 내용은 https://developer.android.com/guide/playcore/in-app-updates. 우선순위: CLI > env > 저장된 인증 정보
—playstore 업로드를 생략합니다	boolean	이 빌드에 대한 플레이 스토어 업로드를 생략합니다 (저장된 플레이 구성이 null이 됩니다). —output-upload가 필요합니다.
—스토어 리뷰 제출	boolean	업로드 후 스토어 릴리스를 리뷰 제출 대신 드래프트/비활성화 빌드로 남깁니다. 안드로이드에서는 기본적으로 프로덕션 트랙에 완료된 릴리스 상태 (—android-track / PLAY_STORE_TRACK 및 —android-release-status / PLAY_STORE_RELEASE_STATUS를 오버라이드하여) 사용합니다. iOS에서는 처리된 테스트 플라이트 빌드를 앱 스토어 리뷰에 제출합니다.
—스토어 릴리스 이름	string	스토어 릴리스 이름/버전 레이블입니다. 안드로이드에서는 이 이름을 구글 플레이 버전 이름으로 전송하고 iOS에서는 앱 스토어 버전을 만들거나 편집할 때 사용합니다.
—스토어 릴리스 설명	string	기본 스토어 릴리스 설명입니다. 안드로이드에서는 이 설명을 플레이 변경 로그로 사용하고 iOS에서는 편집 가능한 버전을 만들거나 편집할 때 기본 앱 스토어 '무엇이 새로운가' 텍스트로 사용합니다.
—스토어 릴리스 설명 지역	string	지역화된 스토어 릴리스 설명 (반복 가능), 예를 들어 —store-release-notes-locale en-US=“버그 수정” —store-release-notes-locale fr-FR=“수정”.
—iOS 테스트 플라이트 그룹	string	iOS: optional comma-separated TestFlight external group names or IDs for external beta distribution.
—ios-자동 배포	boolean	iOS: Apple 승인 후 App Store 버전을 자동으로 출시합니다. 기본값은 수동 출시입니다.
—no-ios-자동 배포	boolean	iOS: Apple 승인 후 App Store 버전을 수동으로 출시합니다.
—출력 업로드	boolean	이 빌드만을 위한 출력 업로드 동작을 강제로 활성화합니다. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 업로드 비활성화	boolean	이 빌드만을 위한 출력 업로드 동작을 강제로 비활성화합니다. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 보존	string	이 빌드만을 위한 출력 링크 TTL을 강제로 설정합니다 (1시간에서 7일까지). 예시: 1시간, 6시간, 2일. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 기록	string	성공적인 빌드 후, JSON 레코드 (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)를 경로에 기록합니다. PNG QR code도 해당 경로에 붙어있는 서식으로 기록됩니다. .qr.png 필드를 다시 읽기 위해 build last-output.
—no-cache	boolean	빌드 캐시 복원 생략 이 빌드에 새로운 캐시 항목을 저장하지 마십시오. 빌드 캐시는 앱당 기본적으로 활성화됩니다. —cache-key
환경, branch 또는 Android flavor (예시)	string	—no-skip-build-number-bump prod, staging이 빌드에만 자동 빌드 번호 증가를 재 활성화하기 위해 저장된 자격 증명을 재 정의합니다.
—skip-marketing-version-bump	boolean	그리고
이 빌드에 새로운 캐시 항목을 저장하지 마십시오. 빌드 캐시는 앱당 기본적으로 활성화됩니다.	boolean	자동 마케팅 버전 업데이트를 생략합니다 (CFBundleShortVersionString / versionName).
—sync-ios-version	boolean	iOS: Xcode MARKETING_VERSION을 package.json에서 가져와 프로젝트를 업로드하기 전에 업데이트합니다.
—ai-analytics	boolean	빌드 실패 시 로그를 Capgo AI로 전송하여 진단합니다. 인터랙티브 터미널에서는 사전 확인을 생략하고 CI에서는 자동 업로드 및 에러스트림으로 분석 결과를 출력합니다.
—no-prescan	boolean	자동 전제 빌드 스캔을 생략합니다.
—prescan-ignore-fatal	boolean	전제 빌드 스캔을 실행하지만 빌드를 차단하지 않습니다 (보고서만)
—prescan-skip	string	특정 전제 빌드 스캔을 생략합니다 (id를 반복하거나 쉼표로 구분). 다른 스캔은 여전히 실행됩니다.
—prescan-warn	string	특정 prescan 체크를 warning으로 다운그레이드 하세요 (반복 또는 쉼표로 구분). 체크는 여전히 실행됩니다.
—fail-on-warnings	boolean	prescan 경고를 치명적인 것으로 처리
—send-logs-to-support	boolean	CI/CD 빌드 실패 시 자동으로 빌드 로그를 Capgo 지원에 업로드합니다 (이메일이 필요하지 않습니다). Capgo 지원은 이메일로 연락을 취할 것입니다. —ai-analytics와 추가적인 옵션입니다.
—send-logs	boolean	—send-logs-to-support의 deprecated alias
-a	string	API 계정에 연결하는 키
—supa-host	string	Self-hosting 또는 Capgo 개발을 위한 Custom Supabase 호스트 URL
—supa-anon	string	사용자 정의 Supabase 익명 키 (자체 호스팅)
—verbose	boolean	세부 로깅을 포함한 자세한 출력을 활성화합니다.

빌드 캐시: Capgo은 기본적으로 앱당 compiled native artifacts (CocoaPods, Gradle 및 관련 출력)를 저장하고 복원합니다. 사용 --cache-key 캐시를 유지하고 프로덕션 캐시와 RC 캐시를 분리하려면 사용하세요. __CAPGO_KEEP_0__ 통합은 --no-cache for a one-off clean build. API integrations can pass cache_key 을 사용하여 한 번만 빌드할 때 캐시를 깨끗하게합니다. __CAPGO_KEEP_0__ 통합은 cache_enabled: false 또는 을 사용하여 캐시를 복원합니다. 캐시 및.

🔹 iOS 버전 동기화

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

package.json에서 MARKETING_VERSION을 가져와 iOS Xcode의 로컬 버전을 동기화합니다.

예시:

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

옵션:

파라미터	타입	설명
—경로	string	프로젝트 디렉토리의 경로 (기본값: 현재 디렉토리)
—체크	boolean	체크만; MARKETING_VERSION이 동기화되지 않은 경우 0이 아닌 값을 반환

🔹 초기 스캔

npx @capgo/cli@latest build prescan

자격 증명(만료, 암호, 프로필 pair링), 프로젝트 상태(cap sync, node_modules 레이아웃), 플랫폼 구성 확인. build request; 이 명령어는 CI에서 실행할 때 자동으로 실행되지만 standalone로 실행할 수 있습니다. 초기 스캔 확인 체크 카탈로그 전체를 확인하고 사용하는 방법을 --skip / --warn 개별 규칙.

옵션:

Param	Type	설명
—플랫폼	string	목표 플랫폼: ios 또는 android (필수)
—경로	string	프로젝트 디렉토리의 경로 (기본: 현재 디렉토리)
-a	string	API 계정에 연결하기 위한 키
—안드로이드 플래버	string	안드로이드: 제품 플래버를 사용할 빌드
—ios-dist	string	iOS: 배포 모드를 유효성 검사에 사용
—json	boolean	기계가 읽을 수 있는 JSON 보고서를 출력
—fail-on-warnings	boolean	경고가 발견되면 0이 아닌 값을 반환 (CI)
—ignore-fatal	boolean	디버그 모드: 항상 0을 반환하고 모든 것을 보고
—skip	string	특정 체크를 생략 (반복 또는 쉼표로 구분)
—warn	string	특정 체크를 경고로 내리기 (반복 또는 쉼표로 구분된 id)
—verbose	boolean	상세 로깅을 포함한 자세한 출력을 활성화합니다.
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키

🔹 마지막 출력

npx @capgo/cli@latest build last-output

__CAPGO_KEEP_0__ build request --output-record. 기본적으로 JSON 전체를 출력하거나 —field 옵션으로 단일 field를 출력하거나, —qr 옵션으로 ASCII QR code을 출력합니다. CI에서 다운로드 URL 또는 QR를 PR 또는 이슈에 다시 게시하기 위해 사용할 수 있습니다. 예시: 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

Options:

Param	Type	설명
—path	string	JSON 기록을 —output-record 옵션으로 기록한 JSON 파일의 경로 (필수)
—field	string	단일 field를 출력 (다음 중 하나: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion)
—qr	boolean	ASCII QR code을 출력 (—field qrCodeAscii와 동일한 단축어)

🔹 Credentials

컴퓨터에 저장된 빌드 인증 정보를 관리합니다. 🔒 보안:

• 인증 정보는 ~/.capgo-credentials/credentials.json (전역) 또는 .capgo-credentials.json (지역)에 저장됩니다.
• 빌드 시 Capgo로 전송되지만 영구적으로 저장되지 않습니다.
• 빌드 후 Capgo에서 즉시 삭제됩니다.
• 빌드 출력물은 옵션으로 시간 제한된 다운로드 링크로 업로드할 수 있습니다. 📚 문서: 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

App Store Connect 팀 API 키를 macOS 가이드 도우미 (macOS만)로 생성하세요. App Store Connect UI 내부 브라우저에 Apple의 UI를 내장하고, Issuer ID + Key ID를 자동으로 캡처하고, .p8를 한 번만 사용하고, Apple과 유효성을 검사하고, ~/.appstoreconnect/private_keys에 저장합니다. progress statistics는 Capgo 분석 (CAPGO_DISABLE_TELEMETRY로 비활성화)로 전달됩니다. npx @capgo/cli build credentials apple-key —appId com.example.app

예시:

Example:

옵션:

Param	Type	설명
-a	string	API 키를 계정에 연결하기 위해 사용합니다
—앱 아이디	string	이 앱 iOS 빌드 인증서에 캡처된 키를 저장하세요
—로컬	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-인증서.json 파일을 프로젝트 루트에 저장 (—local 플래그와 함께) ⚠️ 빌드하기 전에 반드시 인증서를 저장해야 합니다. 🔒 이 인증서는 Capgo 서버에 영구적으로 저장되지 않습니다. 이 인증서는 빌드가 완료되면 즉시 삭제됩니다. 📚 설정 가이드: iOS: https://capgo.app/docs/cli/cloud-build/ios/ 안드로이드: https://capgo.app/docs/cli/cloud-build/android/ npx @capgo/cli build credentials save —platform ios
  —인증서 ./cert.p12 —p12 암호 “password”
  —iOS 배포 프로파일 ./profile.mobileprovision
  —apple 키 ./AuthKey.p8 —apple 키 ID “KEY123”
  —apple-issuer-id “issuer-uuid” —apple-team-id “team-id” Multi-target Example (app + widget extension): npx @capgo/cli build credentials save —platform ios
  멀티 타겟 예제 (앱 + 위젯 확장):
  npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ build credentials save —platform ios
  —iOS 배포 프로파일 ./App.mobileprovision —iOS 배포 프로파일 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 Local storage (per-project): npx @capgo/cli build credentials save —local —platform ios …

Example:

iOS Example:

Options:

Param	Type	Description
—appId	string	앱 ID (예: com.example.app) (필수)
—플랫폼	string	플랫폼: ios 또는 android (필수)
—인증서	string	iOS: .p12 인증서 파일 경로
—ios-배포-프로파일	string	iOS: 배포 프로파일 경로 또는 bundleId=path (반복 가능)
—p12-비밀번호	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없으면 선택 사항)
—애플-키	string	iOS: App Store Connect API 키 경로
—애플-키-아이디	string	iOS: App Store Connect API 키 ID
__CAPGO_KEEP_0__	string	iOS: App Store Connect 발급자 ID
__CAPGO_KEEP_0__	string	iOS: App Store Connect 팀 ID
iOS: 배포 모드	string	iOS: 애플 ID 이메일 (App Store Connect __CAPGO_KEEP_0__ 키 대안)
iOS: 테스트 플라이트 업로드를 위한 앱 특정 비밀번호 (xxxx-xxxx-xxxx-xxxx)	string	iOS: Apple ID email for app-specific password uploads (alternative to App Store Connect API key)
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
—keystore	string	안드로이드: Keystore 파일 경로 (.keystore 또는 .jks)
—keystore-alias	string	안드로이드: Keystore 키 별칭
—keystore-key-password	string	안드로이드: Keystore 키 비밀번호
—keystore-store-password	string	안드로이드: Keystore 저장소 비밀번호
—play-config	string	안드로이드: Play Store 서비스 계정 JSON 파일 경로
—android-flavor	string	안드로이드: 빌드할 제품 맛집 (예: 프로덕션). 프로젝트에 여러 맛집이 있는 경우 필수
—in-app-update-priority	string	Android: Google Play in-app update 우선순위 (정수 0–5; 더 높을수록 더 급합니다). 생략하면 Play의 기존 값이 유지됩니다.
—local	boolean	프로젝트 루트의 .capgo-credentials.json에 저장하기 대신 글로벌 ~/.capgo-credentials/에 저장합니다.
—output-upload	boolean	빌드 출력물 (IPA/APK/AAB)을 Capgo 저장소에 업로드하고 다운로드 링크를 출력합니다.
—no-output-upload	boolean	빌드 출력물 (IPA/APK/AAB)을 Capgo 저장소에 업로드하지 않습니다.
—output-retention	string	출력 링크 TTL: 1시간에서 7일 (기본: 1시간). 예시: 1시간, 6시간, 2일
—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

저장된 빌드 자격 증명 목록 (비밀번호가 가려짐). 현재 저장된 자격 증명(전역 및 지역 모두)을 보여줍니다. 예시: npx @capgo/cli build credentials list # 모든 앱 목록 npx @capgo/cli build credentials list —appId com.example.app # 특정 앱 목록

옵션:

파라미터	타입	설명
—appId	string	앱 ID를 목록에 추가 (선택 사항, 생략 시 모든 앱을 목록에 추가)
—local	boolean	로컬 .capgo-credentials.json 에서만 인증서를 목록에 추가

🔹 지우기

npx @capgo/cli@latest build credentials clear

저장된 빌드 인증서를 지우세요. 저장소에서 인증서를 지우세요. —appId 및 —platform를 사용하여 특정 인증서를 대상으로하세요. 예시: npx @capgo/cli build credentials clear # 전역에서 모든 앱 지우기 npx @capgo/cli build credentials clear —local # 로컬 인증서 지우기 npx @capgo/cli build credentials clear —appId com.example.app —platform ios

옵션:

파라미터	타입	설명
—appId	string	클리어할 앱 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

옵션:

Param	Type	설명
—appId	string	앱 ID (자동으로 capacitor.config에서 감지됩니다. 생략 시)
—platform	string	플랫폼: ios 또는 android (옵션에서 자동으로 감지됩니다)
—local	boolean	국내 capgo-credentials.json을 업데이트하기보다는 전역
—인증서	string	P12 인증서 파일 경로
—ios-배포 프로파일	string	배포 프로파일 경로 또는 bundleId=path (반복 가능, 기본적으로 추가)
—ios-배포 프로파일 매핑을 덮어쓰기	boolean	대체 매핑 대신 병합 (기본: 병합)
—P12 인증서 비밀번호	string	P12 인증서 비밀번호
—애플 키	string	애플 스토어 연결 API 키 (.p8 파일) 경로
—애플 키 ID	string	애플 스토어 연결 API 키 ID
—apple-issuer-id	string	애플 스토어 연결 발급자 ID
—apple-team-id	string	애플 스토어 연결 팀 ID
—apple-id	string	iOS: 앱 스토어 연결 API 키 대신 앱 스토어 연결 이메일을 사용하는 앱 특정 비밀번호 업로드 (대안)
—apple-app-specific-password	string	iOS: 테스트 플라이트 업로드를 위한 앱 특정 비밀번호 (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: 앱 스토어 연결 앱 ID (애플 ID와 앱 특정 비밀번호와 함께 사용)
—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: 제품 플래버를 빌드하십시오 (예: 프로덕션). 프로젝트가 여러 플래버를 가지고 있다면 필수입니다.
—in-app-update-priority	string	Android: Google Play 내 앱 업데이트 우선순위 (0–5의 정수; 더 높을수록 더 급합니다).
—output-upload	boolean	Capgo 저장소에 빌드 출력 (IPA/APK/AAB)을 업로드하고 다운로드 링크를 출력합니다.
—no-output-upload	boolean	Capgo 저장소에 빌드 출력 (IPA/APK/AAB)을 업로드하지 않습니다.
—output-retention	string	출력 링크 TTL: 1시간에서 7일까지. 예시: 1시간, 6시간, 2일
—skip-build-number-bump	boolean	자동 빌드 번호/버전 code 증가를 미룹니다.
—no-skip-build-number-bump	boolean	자동 빌드 번호 증가를 재 활성화 (기본 동작)
—마케팅 버전 업데이트를 생략	boolean	앱이 이미 출시된 경우 미래 빌드에서 자동 마케팅 버전 업데이트를 생략
—마케팅 버전 업데이트를 생략하지 않기	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

옵션:

Param	Type	설명
—appId	string	관리할 앱 ID (선택 사항, 생략 시 선택하도록 유도)
—platform	string	관리할 플랫폼: ios 또는 android (선택 사항, 생략 시 선택하도록 유도)
—local	boolean	로컬 capgo-credentials.json만 탐색

🔹 이동

npx @capgo/cli@latest build credentials migrate

기존의 다중 목표 형식으로의 전환 프로비전 프로파일을 마이그레이션합니다. BUILD_PROVISION_PROFILE_BASE64을 CAPGO_IOS_PROVISIONING_MAP으로 변환합니다. Xcode 프로젝트에서 자동으로 메인 번들 ID를 발견합니다. npx @capgo/cli build credentials migrate —platform ios

예시:

Example:

옵션:

Param	Type	설명
—appId	string	앱 ID (자동으로 capacitor.config에서 추출되거나 생략 시)
—platform	string	플랫폼 (iOS만 지원)
—로컬	boolean	로컬 capgo-credentials.json 대신 전역에서 마이그레이션