🔹 빌드

🏗️ 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 캡처

persist --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: 앱 스토어 연결에 대한 이메일 주소 (App Store Connect 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 배포	string	iOS: 배포 모드
—iOS 배포 프로파일	string	iOS: 배포 프로파일 경로 또는 bundleId=path mapping (repeatable)
—안드로이드 키스토어 파일	string	안드로이드: Base64-encoded 키스토어 파일
—키스토어 키 별칭	string	안드로이드: 키스토어 키 별칭
—키스토어 키 비밀번호	string	안드로이드: 키스토어 키 비밀번호
—키스토어 저장소 비밀번호	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 > 저장된 인증 정보
—no-playstore-upload	boolean	이 빌드에 대한 플레이 스토어 업로드를 생략합니다 (저장된 플레이 구성 null로 설정). —output-upload이 필요합니다.
—submit-to-store-review	boolean	업로드 후 스토어 릴리즈를 검토 요청 대신 draft/비활성화 빌드로 남겨둡니다. 안드로이드에서는 기본적으로 프로덕션 트랙에 완료된 릴리즈 상태 (—android-track / PLAY_STORE_TRACK 및 —android-release-status / PLAY_STORE_RELEASE_STATUS를 오버라이드하여) 사용합니다. iOS에서는 처리된 테스트 플라이트 빌드를 앱 스토어 검토에 제출합니다.
—store-release-name	string	스토어 릴리즈 이름/버전 레이블. 안드로이드에서는 이 값을 Google Play의 버전 이름으로 전송하고 iOS에서는 App Store 버전을 만들거나 재사용할 때 이 값을 사용합니다.
—store-release-notes	string	기본 스토어 릴리즈 노트. 안드로이드에서는 이 값을 플레이의 변경 로그로 사용하고 iOS에서는 App Store의 What’s New 텍스트로 사용합니다.
—store-release-notes-locale	string	지역화된 스토어 릴리즈 노트 (반복 가능), 예를 들어 —store-release-notes-locale en-US=“버그 수정” —store-release-notes-locale fr-FR=“수정”.
—ios-testflight-groups	string	iOS: optional comma-separated TestFlight external group names or IDs for external beta distribution.
—ios-자동 배포	boolean	iOS: 애플 승인 후 App Store 버전을 자동으로 출시합니다. 기본값은 수동 출시입니다.
—no-ios-자동 배포	boolean	iOS: 애플 승인 후 App Store 버전을 수동으로 출시합니다.
—출력 업로드	boolean	이 빌드만을 위한 출력 업로드 동작을 강제로 활성화합니다. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 업로드 비활성화	boolean	이 빌드만을 위한 출력 업로드 동작을 강제로 비활성화합니다. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 보존	string	이 빌드만을 위한 출력 링크 TTL을 강제로 설정합니다. 예시: 1시간, 6시간, 2일. 우선순위: CLI > 환경변수 > 저장된 인증서
—출력 기록	string	성공적인 빌드 후, JSON 레코드 (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)를 경로에 기록합니다. PNG QR code도 그 경로 옆에 기록됩니다. .qr.png suffix. build last-output.
—no-skip-build-number-bump	boolean	이 빌드에 대해 자동 빌드 번호 증가를 재 활성화 하려면 저장된 자격 증명을 재 정의하세요.
—skip-marketing-version-bump	boolean	앱이 이미 출시된 경우 자동 마케팅 버전 (CFBundleShortVersionString / versionName) 증가를 생략하세요.
—sync-ios-version	boolean	iOS: package.json의 MARKETING_VERSION을 Xcode에서 sync하기 전에 프로젝트를 업로드하기 전에.
—ai-analytics	boolean	빌드 실패 시, Capgo AI로 로그를 보내고 진단을 위해 분석을 출력합니다. 이터렉티브 터미널에서 이 옵션은 앞서의 확인을 생략하고 CI에서 자동 업로드 및 분석을 stderr로 출력합니다.
—no-prescan	boolean	자동 전 빌드 스캔을 생략하세요.
—prescan-ignore-fatal	boolean	빌드 전에 스캔을 실행하지만 빌드가 중단되지 않도록 하세요 (오류만 보고합니다)
—prescan-skip	string	특정 스캔 체크를 생략하세요 (id, 반복 또는 쉼표로 구분). 다른 체크는 여전히 실행됩니다.
—prescan-warn	string	특정 스캔 체크를 경고로 낮추세요 (id, 반복 또는 쉼표로 구분). 체크는 여전히 실행됩니다.
—fail-on-warnings	boolean	빌드 전에 스캔 경고를 오류로 처리하세요
—send-logs-to-support	boolean	CI/CD 빌드 실패 시 자동으로 빌드 로그를 Capgo 지원팀에 업로드합니다 (이메일 필요하지 않습니다). Capgo 지원팀은 이메일로 연락을 취할 것입니다. —ai-analytics와 추가됩니다.
—send-logs	boolean	—send-logs-to-support의 alias입니다 (deprecated)
-a	string	API key to link to your account
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)
—verbose	boolean	Enable verbose output with detailed logging

🔹 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 .

옵션:

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

🔹 🔹 프로젝트 스캔

npx @capgo/cli@latest build prescan

프로젝트와 저장된 자격 증명을 업로드하기 전에 cloud 빌드가 실패하는 문제를 스캔하고 — 업로드하기 전에. build request자격 증명(만료, 암호, 프로필 Pairing), 프로젝트 상태(cap sync, node_modules 레이아웃), 플랫폼 구성 확인. 자동으로 실행되며 CI에서 standalone로 실행합니다. 자세한 내용은 --skip / --warn 프로젝트 스캔은

전체 체크 카탈로그 및

개별 규칙에 대해	옵션 :	설명
—플랫폼	string	목표 플랫폼: ios 또는 android (필수)
—경로	string	프로젝트 디렉토리의 경로 (기본: 현재 디렉토리)
-a	string	API 계정에 연결하는 키
—안드로이드 플래버	string	안드로이드: 빌드에 사용할 제품 플래버
—iOS 배포	string	iOS: 배포 모드를 검증할 것
—JSON	boolean	기계가 읽을 수 있는 JSON 보고서를 출력합니다.
__CAPGO_KEEP_0__	boolean	경고가 발견된 경우 0이 아닌 값을 반환합니다 (CI)
__CAPGO_KEEP_0__	boolean	診断 모드: 모든 것을 보고 항상 0을 반환합니다
__CAPGO_KEEP_0__	string	특정 체크를 생략합니다 (반복 또는 쉼표로 구분)
__CAPGO_KEEP_0__	string	특정 체크를 경고로 내립니다 (반복 또는 쉼표로 구분)
__CAPGO_KEEP_0__	boolean	세부 로깅과 함께 자세한 출력을 활성화합니다
__CAPGO_KEEP_0__	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. 기본적으로 JSON 전체를 출력하고 —field를 사용하여 단일 field를 출력하거나 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

옵션:

파라미터	타입	설명
—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_KEEP_0__-credentials/credentials.json (전역) 또는 .__CAPGO_KEEP_1__-credentials.json (지역)

• Credentials saved to ~/.capgo-credentials/credentials.json (global) or .capgo-credentials.json (local)
• Capgo
• 빌드 후 Capgo에서 즉시 삭제
• 빌드 출력물은 시간 제한된 다운로드 링크로 옵션으로 업로드할 수 있습니다. 📚 문서: iOS 설정: https://capgo.app/docs/cli/cloud-build/ios/ Android 설정: https://capgo.app/docs/cli/cloud-build/android/

🔹 Apple-key

Alias: asc-key

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

App Store Connect 팀 API 키를 macOS 전용 가이드 도우미를 사용하여 macOS에서만 생성하세요. App Store Connect UI 내에 임베디드 브라우저를 통해 Apple의 UI를 walks through합니다. 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 키를 사용하여 계정에 연결
--appId	string	이 앱 iOS 빌드 인증서에 캡처된 키를 저장
--local	boolean	전역 파일 대신 프로젝트별 .capgo-credentials.json 파일에 저장
—json	boolean	JSON 형식으로 캡처된 Key ID / Issuer ID / .p8 경로를 출력합니다.

🔹 저장

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): 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 Local storage (per-project): npx @capgo/cli build credentials save —local —platform ios …

Example:

iOS Example:

옵션:

파라미터	타입	설명
--appId	string	애플리케이션 ID (예: com.example.app) (필수)
--platform	string	플랫폼: ios 또는 android (필수)
--certificate	string	iOS: .p12 인증서 파일 경로
—ios-인증서-프로파일	string	iOS: 인증서 프로파일 경로 또는 bundleId=path (반복 가능)
—p12-비밀번호	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없으면 선택 사항)
—apple-키	string	iOS: .p8 App Store Connect API 키 경로
—apple-키-아이디	string	iOS: App Store Connect API 키 ID
—apple-발급자-아이디	string	iOS: App Store Connect 발급자 ID
—apple-팀-아이디	string	iOS: App Store Connect 팀 ID
—ios-배포	string	iOS: 배포 모드
—애플-아이디	string	iOS: 애플 ID 이메일 (App Store Connect API 키 대체)
—애플-앱-특정-패스워드	string	iOS: 테스트 플라이트 업로드를 위한 앱 특정 패스워드 (xxxx-xxxx-xxxx-xxxx)
—애플-앱-아이디	string	iOS: 앱 스토어 연결 앱 아이디 (애플 아이디와 앱 특정 패스워드와 함께 필요)
—keystore	string	안드로이드: Keystore 파일 경로 (.keystore 또는 .jks)
—keystore-alias	string	안드로이드: Keystore 키 별칭
---keystore-key-password	string	안드로이드: Keystore 키 비밀번호
---keystore-store-password	string	안드로이드: Keystore 저장소 비밀번호
---play-config	string	안드로이드: Play 스토어 서비스 계정 JSON의 경로
---android-flavor	string	안드로이드: 빌드할 제품의 맛집 (예: 프로덕션). 프로젝트가 여러 맛집을 가지고 있다면 필수입니다.
---in-app-update-priority	string	안드로이드: 구글 플레이 내 앱 업데이트 우선순위 (정수 0–5; 더 높을수록 더 급합니다). 생략하면 Play의 기존 값이 유지됩니다.
---local	boolean	프로젝트 루트의 .capgo-credentials.json에 저장하기 대신 전역 ~/.capgo-credentials/에 저장합니다.
—출력 업로드	boolean	빌드 출력 (IPA/APK/AAB)을 Capgo 저장소에 업로드하고 다운로드 링크를 출력합니다.
—출력 업로드 비활성화	boolean	빌드 출력 (IPA/APK/AAB)을 Capgo 저장소에 업로드하지 않습니다.
—출력 보존	string	출력 링크 TTL: 1시간에서 7일 (기본: 1시간). 예시: 1시간, 6시간, 2일
—빌드 번호 증가 건너뛰기	boolean	미래 빌드에서 자동 빌드 번호/버전 code 증가를 건너뛰세요.
—빌드 번호 증가 건너뛰기 비활성화	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 # 특정 앱 목록

옵션:

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

🔹 Clear

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

옵션:

Param	Type	설명
—앱 아이디	string	앱 아이디를 지우려면 (선택 사항, 모든 앱을 지우면 omitted)
—플랫폼	string	클리어할 플랫폼: ios 또는 android (선택 사항, 모든 플랫폼을 지우면 omitted)
—로컬	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에서 추출되며 생략 시 omitted)
—platform	string	플랫폼: ios 또는 android (옵션에서 자동으로 추출)
—local	boolean	지역 capgo-credentials.json을 업데이트하는 대신 전역
—certificate	string	P12 인증서 파일 경로
—ios-provisioning-profile	string	설정 프로파일 경로 또는 bundleId=path (반복 가능, 기본적으로 추가)
—overwrite-ios-provisioning-map	boolean	전체 설정 프로파일 대신 병합하는 대신 대체 (기본: 병합)
—p12-password	string	P12 인증서 암호
—apple-key	string	App Store Connect API 키 (.p8 파일) 경로
—apple-key-id	string	App Store Connect API 키 ID
—apple-issuer-id	string	App Store Connect 발급자 ID
—apple-team-id	string	애플 스토어 연결 팀 ID
—애플 아이디	string	iOS: 앱 스토어 연결 API 키 대신 앱 스토어 연결 이메일을 위한 앱별 암호 업로드 (대안)
—애플 앱별 암호	string	iOS: 테스트 플라이트 업로드를 위한 앱별 암호 (xxxx-xxxx-xxxx-xxxx)
—애플 앱 아이디	string	iOS: 앱 스토어 연결 앱 아이디 (애플 아이디와 앱별 암호, —apple-app-specific-password와 함께 필요)
—iOS 배포	string	iOS: 배포 모드
—키스토어	string	키스토어 파일 경로 (.keystore 또는 .jks)
—키스토어 별명	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_1__	string	__CAPGO_KEEP_2__
__CAPGO_KEEP_3__	string	__CAPGO_KEEP_4__
__CAPGO_KEEP_5__	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 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

옵션:

파라미터	타입	설명
앱 ID	string	애플리케이션 ID 관리 (선택 사항, 생략 시 선택하도록 유도)
— 플랫폼	string	관리할 플랫폼: ios 또는 android (선택 사항, 생략 시 선택하도록 유도)
— 로컬	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:

옵션:

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