📱 앱

📱 Capgo Cloud에서 Capgo 앱 설정과 구성을 관리하세요.

➕ 추가

별칭: a

npx @capgo/cli@latest app add

➕ com.test.app 형식의 고유한 앱 ID로 Capgo Cloud에 새 앱을 추가합니다. 제공하지 않은 옵션은 config에서 유추할 수 있습니다.

예시:

npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png

옵션:

파라미터	유형	설명
-n	string	Capgo Cloud에 표시될 앱 이름
-i	string	Capgo Cloud에 표시될 앱 아이콘 경로
-a	string	계정에 연결할 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

🗑️ 삭제

npx @capgo/cli@latest app delete

🗑️ Capgo Cloud에서 앱을 삭제합니다. 특정 버전을 지정하여 해당 bundle만 삭제할 수 있습니다.

예시:

npx @capgo/cli@latest app delete com.example.app

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

📋 목록

별칭: l

npx @capgo/cli@latest app list

📋 Capgo Cloud에 내 계정으로 등록된 모든 앱을 나열합니다.

예시:

npx @capgo/cli@latest app list

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

🐞 디버그

npx @capgo/cli@latest app debug

🐞 live update Cloud에서 Capgo 이벤트를 수신하여 앱을 디버깅하세요. 상세 진단을 위해 특정 기기를 대상으로 지정할 수 있습니다.

예시:

npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID

옵션:

파라미터	유형	설명
-a	string	계정에 연결할 API 키
-d	string	디버깅할 특정 디바이스 ID
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

⚙️ 설정

npx @capgo/cli@latest app setting

⚙️ Capacitor 설정을 프로그래밍 방식으로 수정합니다. —string 또는 —bool로 설정 경로(예: plugins.CapacitorUpdater.defaultChannel)를 지정하세요.

예시:

npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "Production"

옵션:

파라미터	유형	설명
—bool	string	수정할 설정의 boolean 값, 예: —bool true
—string	string	수정할 설정의 string 값, 예: —string “Production”

⚙️ 설정

별칭: s

npx @capgo/cli@latest app set

⚙️ Capgo Cloud의 기존 앱 설정(이름, 아이콘, bundle 보존 기간 등)을 업데이트합니다. 0은 무제한 저장을 의미합니다.

예시:

npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 30

옵션:

파라미터	유형	설명
-n	string	Capgo Cloud에 표시될 앱 이름
-i	string	Capgo Cloud에서 앱 아이콘으로 사용할 로컬 이미지 파일 경로 (png, jpg, webp, svg)
-a	string	계정에 연결할 API 키
-r	string	오래된 bundle 보관 일수 (0 = 무제한, 기본값: 0)
—expose-metadata	string	plugin에 bundle metadata(link 및 comment) 노출 (true/false, 기본값: false)
—preview	boolean	이 app에 대한 bundle 및 channel preview QR 코드 활성화
—no-preview	boolean	이 app에 대한 bundle 및 channel preview QR 코드 비활성화
—allow-device-custom-id	boolean	기기에서 이 app에 대한 커스텀 device ID 설정 허용
—no-allow-device-custom-id	boolean	이 앱의 커스텀 디바이스 ID 사용을 허용하지 않음
—block-provider-infra-requests	boolean	이 앱의 프로바이더 인프라 요청을 차단
—no-block-provider-infra-requests	boolean	이 앱의 프로바이더 인프라 요청을 허용
—build-timeout-minutes	string	Native Build 타임아웃 시간(분) (5-360, 기본값: 15)
—ios-store-url	string	이 앱의 iOS App Store URL
—android-store-url	string	이 앱의 Google Play Store URL
—default-upload-channel	string	이 앱의 기본 upload 채널 이름
—default-download-channel	string	이 앱의 기본 download 채널 이름 (채널 public=true 설정)
—disable-download-channels	boolean	이 앱의 Capgo download 채널 비활성화 (모든 채널 public=false 설정)
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)