🔹 빌드

🏗️ Capgo iOS/Android 빌드를 관리하세요.

🚀 Init

Alias: onboarding

npx @capgo/cli@latest build init

iOS 빌드 인증 정보를 상호 작용적으로 설정하세요 (인증서 및 프로파일이 자동으로 생성됩니다). macOS에서 App Store Connect API 키를 생성하는 데 도움이 됩니다.

🔹 Request

npx @capgo/cli@latest build request

Capgo Cloud에서 네이티브 빌드를 요청하세요. 이 명령은 프로젝트 디렉토리를 압축하고 Capgo에 업로드하여 빌드합니다. 빌드는 직접 앱 스토어로 전송됩니다. 🔒 보안: Capgo 서버에 인증 정보를 저장하지 않습니다. 빌드 완료 후 자동으로 삭제됩니다. 빌드 출력은 선택적으로 시간 제한된 다운로드 링크로 업로드할 수 있습니다. 📋 필수 조건: 먼저 인증 정보를 저장하세요: npx @capgo/cli build credentials save --appId <app-id> --platform <ios|android>

예시:

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

옵션:

Param	Type	설명
—path	string	프로젝트 빌드 디렉토리의 경로 (기본값: 현재 디렉토리)
—platform	string	빌드 대상 플랫폼: ios 또는 android (필수)
—build-mode	string	빌드 모드: 디버그 또는 릴리즈 (기본: 릴리즈)
__CAPGO_KEEP_0__	string	iOS: Base64로 인코딩된 .p12 인증서
__CAPGO_KEEP_0__	string	iOS: 인증서 비밀번호 (인증서에 비밀번호가 없으면 선택 사항)
iOS: 앱 스토어 연결 __CAPGO_KEEP_0__ 키 대체	string	iOS: Apple ID email for app-specific password uploads (alternative to App Store Connect API key)
iOS: 앱 스토어 연결 앱 아이디 (필수: —apple-id와 —apple-app-specific-password와 함께)	string	iOS: 앱 스토어 연결 앱 키 아이디
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	iOS: 애플 앱 스토어 연결(App Store Connect) API 키 ID(Key ID)
—apple-issuer-id	string	iOS: 애플 앱 스토어 커넥트 발급자 ID
—사용자 인증서 콘텐츠—	string	iOS: Base64-인코딩 App Store Connect API 키 (.p8)
애플 스토어 연결 팀 ID	string	iOS: 애플 스토어 커넥트 팀 ID
iOS 스키마	string	iOS: Xcode scheme으로 빌드 (기본: App)
iOS 대상	string	iOS: Xcode 대상으로 빌드 설정 읽기 (기본값: 스키마와 동일)
iOS 배포	string	iOS: 배포 모드
—ios-provisioning-profile	string	iOS: Provisioning profile 경로 또는 bundleId=path mapping (반복 가능)
—android-keystore-file	string	Android: Base64-encoded 키 스토어 파일
—keystore-key-alias	string	Android: 키 스토어 키 별칭
—keystore-key-password	string	Android: 키 스토어 키 비밀번호
—keystore-store-password	string	Android: 키 스토어 저장소 비밀번호
—play-config-json	string	안드로이드: Base64-encoded Google Play 서비스 계정 JSON
—안드로이드 플래버	string	안드로이드: 제품 플래버를 빌드하기 위한 (예: 프로덕션). 프로젝트가 여러 플래버를 가지고 있다면 필수입니다.
—플레이스토어 업로드 생략	boolean	이 빌드에 대한 플레이 스토어 업로드를 생략합니다 (저장된 플레이 구성 null로 설정). —output-upload이 필요합니다.
—output-upload	boolean	이 빌드에 대한 출력 업로드 동작을 오버라이드합니다 (활성화). 우선순위: CLI > 환경 > 저장된 자격증명
—no-output-upload	boolean	이 빌드에 대한 출력 업로드 동작을 오버라이드합니다 (비활성화). 우선순위: CLI > 환경 > 저장된 자격증명
—출력 보존	string	이 빌드에 대한 출력 링크 TTL을 오버라이드합니다 (1시간에서 7일). 예시: 1시간, 6시간, 2일. 우선순위: CLI > 환경 > 저장된 자격증명
—빌드 번호 업데이트를 생략	boolean	자동 빌드 번호/버전 code 증가를 생략합니다. 프로젝트 파일에 이미 있는 버전을 사용합니다.
—no-skip-build-number-bump	boolean	이 빌드에만 자동 빌드 번호 증가를 다시 활성화하기 위해 저장된 자격증명을 재활용합니다.
-a,	string	API 계정에 연결하기 위한 키
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위해 사용하는 커스텀 Supabase anon 키
—verbose	boolean	세부 로깅과 함께 자세한 출력을 활성화합니다.

🔹 Credentials

npx @capgo/cli@latest build credentials

컴퓨터에 저장된 빌드 인증 정보를 관리하세요. 🔒 보안:

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

https://__CAPGO_KEEP_0__.app/docs/builder/android/

__CAPGO_KEEP_0__를 사용 중이라면 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__와 연결하세요. Capgo CI/CD의 제품 워크플로우에서 Capgo CI/CD를 연결하세요. Capgo Native Builds의 제품 워크플로우에서 Capgo Native Builds를 연결하세요. Capgo Integrations의 제품 워크플로우에서 Capgo Integrations를 연결하세요. for the product workflow in Capgo Native Builds, Capgo Integrations Capgo CI/CD를 통해 계속 진행하세요. __CAPGO_KEEP_0__를 사용 중이라면 __CAPGO_KEEP_0__ CI/CD의 제품 워크플로우에서 __CAPGO_KEEP_0__ CI/CD를 연결하세요. GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항을 위해.