🔹 빌드

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

빌드 접근 및 출력

네이티브 클라우드 빌드는 모든 Capgo 계획에서 사용할 수 있습니다. 빌드 자격 증명은 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

저장

Pass --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

옵션:

파라미터	타입	설명
-a	string	API 계정에 연결하기 위한 키
-c	string	비교할 채널. 기본값은 CapacitorUpdater.defaultChannel 또는 공공 기본 채널
—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 키

🚀 Init

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	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—no-analytics	boolean	이 실행에 대해 빌드 온보딩 분석 및 터미널 재생을 비활성화

🔹 요청

npx @capgo/cli@latest build request

Capgo 클라우드에서 네이티브 빌드를 요청하십시오. 이 명령어는 프로젝트 디렉토리를 압축하여 Capgo에 업로드하고 빌드를 처리합니다. 빌드는 앱 스토어로 직접 전송됩니다. Capgo 서버에 인증 정보가 저장되지 않습니다. 빌드가 완료된 후에 삭제됩니다. 빌드를 요청하기 전에 저장해 주십시오.

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

예시:

npx @capgo/cli@latest build request com.example.app --platform ios --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: 애플 ID 이메일 (앱 스토어 연결 API 키 업로드의 대안)
—apple-app-specific-password	string	iOS: 테스트 플라이트 업로드를 위한 앱 스토어 연결 앱 스토어 ID (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: 앱 스토어 연결 앱 ID (앱 스토어 연결 —apple-id 및 —apple-app-specific-password와 함께 필요)
—apple-key-id	string	iOS: 앱 스토어 연결 API 키 ID
—apple-issuer-id	string	iOS: 앱 스토어 연결 발급자 ID
—apple-key-content	string	iOS: Base64-인코딩 앱 스토어 연결 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을 사용하여 빌드 설정을 읽기 (기본값: scheme과 동일)
—ios-distribution	string	iOS: 배포 모드
—ios-provisioning-profile	string	iOS: 배포 프로파일 경로 또는 bundleId=path mapping (반복 가능)
—android-keystore-file	string	Android: Base64로 인코딩된 키스토어 파일
—keystore-key-alias	string	안드로이드: 키스토어 키 별칭
__CAPGO_KEEP_0__	string	안드로이드: 키스토어 키 비밀번호
__CAPGO_KEEP_0__	string	안드로이드: 키스토어 저장소 비밀번호
__CAPGO_KEEP_0__	string	안드로이드: Google Play 서비스 계정 JSON (Base64 인코딩)
—android-flavor	string	안드로이드: 제품 플래버를 빌드하는 데 사용하는 플래버 (예: 프로덕션). 프로젝트에 여러 플래버가 있는 경우 필수입니다.
안드로이드: 릴리즈 상태	string	CLI
__CAPGO_KEEP_0__	string	안드로이드: Google Play 배포 상태 (draft, completed, inProgress, halted). —submit-to-store-review 옵션 없으면 draft. —submit-to-store-review 옵션과 상태 설정 없으면 completed. 우선순위: CLI > env > 저장된 인증서
—in-app-update-priority	string	안드로이드: Google Play 내 앱 업데이트 우선순위 (정수 0–5; 더 높을수록 더 급합니다). 자세한 내용은 https://developer.android.com/guide/playcore/in-app-updates을 참조하세요. 우선순위: CLI > env > 저장된 인증서
—no-playstore-upload	boolean	이 빌드에 대한 Play Store 업로드를 생략합니다 (저장된 플레이 구성 null로 설정). —output-upload 옵션 필요
—submit-to-store-review	boolean	업로드 후 스토어 릴리즈를 검토 요청 대신 draft/inactive 빌드로 남깁니다. 안드로이드에서는 이 기본값은 프로덕션 트랙에 completed 상태로 (—android-track / PLAY_STORE_TRACK 및 —android-release-status / PLAY_STORE_RELEASE_STATUS로 override) 설정됩니다. iOS에서는 처리된 TestFlight 빌드를 App Store 검토에 제출합니다.
—store-release-name	string	스토어 릴리즈 이름/버전 레이블. 안드로이드에서는 Google Play 버전 이름으로 전송하고 iOS에서는 App Store 버전을 만들거나 편집할 때 사용합니다.
—store-release-notes	string	기본 스토어 릴리즈 노트. 안드로이드에서는 이 것을 플레이 차트로그로 사용하고, iOS에서는 기본 앱 스토어 '무엇이 새로운가?' 텍스트로 사용합니다.
__CAPGO_KEEP_0__	string	지역화된 스토어 릴리즈 노트 (반복 가능), 예를 들어 —store-release-notes-locale en-US=“버그 수정” —store-release-notes-locale fr-FR=“수정”.
__CAPGO_KEEP_0__	string	iOS: 외부 베타 배포를 위한 외부 그룹 이름 또는 ID의 쉼표로 구분된 목록입니다.
__CAPGO_KEEP_0__	boolean	iOS: 애플 승인 후 자동으로 앱 스토어 버전을 릴리즈합니다. 기본값은 수동 릴리즈입니다.
__CAPGO_KEEP_0__	boolean	iOS: 애플 승인 후 수동 릴리즈를 기다립니다.
__CAPGO_KEEP_0__	boolean	이 빌드만을 위한 출력 업로드 동작을 오버라이드합니다 (활성화). 우선순위: CLI > 환경변수 > 저장된 자격증명
__CAPGO_KEEP_0__	boolean	이 빌드만에 대한 출력 업로드 동작을 오버라이드합니다 (비활성화). 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 보존	string	이 빌드만에 대한 출력 링크 TTL을 오버라이드합니다 (1시간에서 7일). 예시: 1시간, 6시간, 2일. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 기록	string	성공한 빌드 후, JSON 기록 (jobId, 상태, 출력 URL, QR 코드 ASCII, QR 코드 PNG 경로, 완료 시간)을 경로에 기록합니다. PNG QR code도 그 경로에 붙어있는 suffix와 함께 기록됩니다. .qr.png suffix를 읽어오려면 build last-output.
—캐시 무효화	boolean	빌드 캐시 복원 생략 and —캐시 키
—cache-key	string	— 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을 sync 하기 전에 프로젝트를 업로드하기 전에.
—ai-analytics	boolean	빌드 실패 시, Capgo AI로 로그를 전송합니다. 인터랙티브 터미널에서 이 옵션은 사전 확인을 생략하고 CI에서 이 옵션은 자동 업로드 및 에러 스트림으로 분석 결과를 출력합니다.
—no-prescan	boolean	자동화된 전 빌드 스캔을 생략합니다.
—prescan-ignore-fatal	boolean	빌드 전 스캔을 실행하지만 빌드를 막지 않습니다 (보고서만)
—prescan-skip	string	특정 prescan 체크를 id (반복 또는 쉼표로 구분)으로 건너뛰십시오. 다른 체크는 여전히 실행됩니다.
—prescan-warn	string	특정 prescan 체크를 id (반복 또는 쉼표로 구분)으로 경고로 내리십시오. 체크는 여전히 실행됩니다.
—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	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	사용자 호스팅을 위한 커스텀 Supabase anon 키
—verbose	boolean	세부 로깅과 함께 자세한 출력을 활성화합니다

빌드 캐시: Capgo는 기본적으로 앱당 컴파일된 네이티브 아티팩트 (CocoaPods, Gradle 및 관련 출력)를 저장하고 복원합니다. Capgo를 사용하여 RC 및 프로덕션 캐시를 분리하고 Capgo를 사용하여 한 번만 빌드를 수행합니다. --cache-key or --no-cache CLI 명령어를 사용하여 한 번만 수행할 수 있는 깨끗한 빌드를 위해. API 통합은 통과할 수 있습니다. cache_key or cache_enabled: false 빌드 요청 페이로드에 포함됩니다. 자세히 보기 빌드 캐시 그리고 오류 해결: 잘못된 캐시 복원.

🔹 Sync-ios-version

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

iOS Xcode MARKETING_VERSION을 package.json에서 동기화합니다.

예시:

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

옵션:

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

🔹 프리 스캔

npx @capgo/cli@latest build prescan

프로젝트와 저장된 자격 증명에서 클라우드 빌드가 실패하는 문제를 스캔하고 업로드하기 전에 — 업로드하기 전에. build request이 명령어는 독립적으로 실행되며 (예: CI에서). 이 명령어는 자동으로 내부에서 실행되며 CI에서 standalone로 실행할 수 있습니다. See --skip / --warn Prescan checks

Options:

Param	Options:	Param
Type	string	설명
—path	string	프로젝트 디렉토리의 경로 (기본값: 현재 디렉토리)
-a	string	API 계정에 연결하는 키
--android-플레이어	string	Android: 빌드할 제품 플래버
--ios-배포	string	iOS: 배포 모드를 검증할 것
--json	boolean	기계가 읽을 수 있는 JSON 보고서를 출력
--경고-에러	boolean	경고가 발견되면 0이 아닌 값을 반환 (CI)
--fatal-무시	boolean	진단 모드: 모든 것을 보고 항상 0을 반환합니다.
—스킵	string	특정 체크를 id로 스킵합니다 (반복 가능하거나 쉼표로 구분)
—경고	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

이전의 기록에 의해 작성된 빌드 출력 레코드를 읽습니다. build request --output-record. Prints the full JSON by default, a single field with —field, or the ASCII QR code with —qr. Useful in CI to grab the download URL or QR for posting back to a PR or issue. Examples: 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	JSON 레코드에 의해 —output-record 옵션으로 기록된 경로 (필수)
—field	string	단일 field 출력 (jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion 중 하나)
—qr	boolean	Print the rendered ASCII QR code (shortcut for —field qrCodeAscii)

🔹 인증 정보

🔒 보안:

• 전역적으로 ~/.capgo-credentials/credentials.json 또는 로컬로 .capgo-credentials.json에 저장된 인증 정보
• 빌드 시 Capgo로 전송되지만 영구적으로 저장되지 않음
• 빌드 후 즉시 Capgo에서 삭제
• 빌드 출력은 옵션으로 시간 제한된 다운로드 링크로 업로드할 수 있습니다 📚 문서: https://capgo.app/docs/cli/cloud-build/ios/ https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/ios/ https://capgo.app/docs/cli/cloud-build/android/

🔹 __애플 키__

Alias: asc-key

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

Create an App Store Connect team API key with a guided macOS helper (macOS only). Opens a native window that walks you through Apple’s App Store Connect UI in an embedded browser, auto-captures the Issuer ID + Key ID, intercepts the one-time .p8, validates it against Apple, and saves it to ~/.appstoreconnect/private_keys. Progress statistics are forwarded to Capgo analytics (disable with CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app

Example:

Example:

Options:

Param	타입	설명
-a	string	API 키를 사용하여 계정에 연결
—appId	string	이 앱 iOS 빌드 인증서에 캡처 키를 저장
—local	boolean	프로젝트별 capgo-credentials.json 파일에 저장
—json	boolean	캡처 키 ID / 발급자 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” Multi-target Example (app + widget extension): npn @capgo/cli build credentials save —platform ios
  —ios-인증서 발급 프로파일 ./App.mobileprovision
  —ios-인증서 발급 프로파일 com.example.widget=./Widget.mobileprovision
  npn @capgo/cli build credentials save --platform android
  —keystore ./release.keystore —keystore-alias “my-key”
  —keystore-key-password “key-pass”
  —play-config ./service-account.json 로컬 스토리지 (프로젝트 당) : npm @capgo/cli build credentials save --local --platform ios …

예시:

iOS Example:

설정:

파라미터	형식	설명
—애플리케이션 아이디	string	애플리케이션 아이디 (예: com.example.app) (필수)
—플랫폼	string	플랫폼: ios 또는 android (필수)
—인증서	string	iOS: 인증서 파일(.p12) 경로
—iOS 배포 프로파일	string	iOS: 배포 프로파일 경로 또는 bundleId=path (반복 가능)
—인증서 비밀번호	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없으면 선택 사항)
—apple-key	string	iOS: App Store Connect API 키 위치
—apple-key-id	string	iOS: App Store Connect API 키 ID
—apple-issuer-id	string	iOS: App Store Connect 발급자 ID
—apple-team-id	string	iOS: App Store Connect 팀 ID
—ios-distribution	string	iOS: 배포 모드
—apple-id	string	iOS: 애플 ID 이메일 (앱 스토어 연결 API 키 대체)
—apple-app-specific-password	string	iOS: 애플리케이션 특정 비밀번호 (xxxx-xxxx-xxxx-xxxx) 테스트 플라이트 업로드
—apple-app-id	string	iOS: 앱 스토어 연결 앱 ID (애플 ID와 애플리케이션 특정 비밀번호와 함께 필요)
—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	안드로이드: Play 스토어 서비스 계정 JSON 경로
—android-flavor	string	안드로이드: 제품 플래버를 빌드 (예: 프로덕션). 프로젝트가 여러 플래버를 가질 경우 필수.
—in-app-update-priority	string	안드로이드: Google Play 내 앱 업데이트 우선순위 (정수 0–5; 더 높을수록 더 급박). 생략하면 Play의 기존 값이 유지됩니다.
—local	boolean	프로젝트 루트에 .capgo-credentials.json으로 저장하기 대신 글로벌 ~/.capgo-credentials/에 저장
—output-upload	boolean	Capgo 저장소에 빌드 출력물 (IPA/APK/AAB)을 업로드하고 다운로드 링크를 출력
—no-output-upload	boolean	빌드 출력물 (IPA/APK/AAB)을 Capgo 저장소에 업로드하지 않음
—출력 보존	string	출력 링크 TTL: 1시간에서 7일 (기본값: 1시간). 예시: 1시간, 6시간, 2일
—빌드 번호 증가 생략	boolean	미래 빌드에서 자동 빌드 번호/버전 code 증가를 생략합니다.
—no-skip-build-number-bump	boolean	미래 빌드에서 자동 빌드 번호 증가를 다시 활성화합니다. (기본 동작)
—마케팅 버전 증가 생략	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

옵션:

파라미터	타입	설명
앱 ID	string	애플리케이션 ID (자동으로 capacitor.config에서 추출되며 생략 시 자동으로 추출됨)
—플랫폼	string	플랫폼: ios 또는 android (옵션에서 자동으로 추출됨)
—로컬	boolean	전역 대신 로컬 .capgo-credentials.json을 업데이트합니다.
—인증서	string	P12 인증서 파일 경로
—ios-배포 프로파일	string	배포 프로파일 경로 또는 bundleId=path (반복 가능, 기본적으로 추가됨)
—overwrite-ios-배포 프로파일 맵	boolean	전체 배포 프로파일 맵을 대체하는 대신 병합합니다 (기본: 병합)
—p12-인증서 비밀번호	string	P12 인증서 비밀번호
—apple-key	string	API 앱 스토어 연결 경로 (.p8 파일)
—apple-key-id	string	API 앱 스토어 연결 키 ID
—apple-issuer-id	string	앱 스토어 연결 발급자 ID
—apple-team-id	string	앱 스토어 연결 팀 ID
—apple-id	string	iOS: 앱 스토어 연결 키 대신 앱 스토어 연결 API 키를 사용할 때 앱 스토어 연결 ID 이메일
—apple-app-specific-password	string	iOS: 테스트 플라이트 업로드를 위한 앱 특정 비밀번호 (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: __CAPGO_KEEP_0__ App Store Connect __CAPGO_KEEP_1__ (iOS: __CAPGO_KEEP_2__ 필요하며 —apple-id 및 —apple-app-specific-password와 함께)
—ios-distribution	string	iOS: 배포 모드
—keystore	string	Keystore file path (.keystore or .jks)
—keystore-alias	string	Keystore key alias
—keystore-key-password	string	Keystore key password
—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	빌드 출력 (IPA/APK/AAB)을 Capgo 저장소에 업로드하고 다운로드 링크 출력
—no-output-upload	boolean	빌드 출력 (IPA/APK/AAB)을 Capgo 저장소에 업로드하지 않음
—output-retention	string	출력 링크 TTL: 1시간에서 7일까지. 예시: 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 manage

저장된 빌드 인증서를 상호 작용적으로 관리합니다. 저장된 인증서를浏览하고 구성된 항목을 확인하거나 CI/CD-준비된 .env 파일을 내보내거나 플랫폼의 인증서를 삭제할 수 있습니다. 동일한 TUI를 재사용합니다. capgo init. 예시: npx @capgo/cli 빌드 인증서 관리 npx @capgo/cli 빌드 인증서 관리 —appId com.example.app npx @capgo/cli 빌드 인증서 관리 —appId com.example.app —platform ios npx @capgo/cli 빌드 인증서 관리 —local

옵션:

Param	Type	설명
—appId	string	관리할 앱 ID (선택 사항, 생략 시 선택하도록 유도)
—platform	string	관리할 플랫폼: ios 또는 android (선택 사항, 생략 시 선택하도록 유도)
—local	boolean	Only browse local .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:

옵션:

파라미터	타입	설명
—appId	string	앱 ID (자동으로 capacitor.config에서 추출되며 생략 시 자동으로 추출)
—platform	string	플랫폼 (현재 ios만 지원)
—local	boolean	로컬 .capgo-credentials.json 대신 전환