📱 앱

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

➕ 추가

Alias: a

npx @capgo/cli@latest app add

➕ com.test.app 형식의 고유 앱 ID를 사용하여 Capgo Cloud에 새 앱을 추가합니다. 옵션을 지정하지 않으면 config 값을 기반으로 자동 설정됩니다.

Example:

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 key
—supa-host	string	커스텀 Supabase host URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)

📋 목록

Alias: l

npx @capgo/cli@latest app list

📋 Capgo Cloud에 등록된 모든 앱 목록을 표시합니다.

Example:

npx @capgo/cli@latest app list

옵션:

파라미터	타입	설명
-a	string	계정 연결을 위한 API 키
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon 키 (셀프 호스팅용)

🐞 디버그

npx @capgo/cli@latest app debug

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

예시:

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

옵션:

파라미터	타입	설명
-a	string	계정 연결을 위한 API key
-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”

⚙️ 설정

Alias: s

npx @capgo/cli@latest app set

⚙️ Capgo Cloud에 있는 기존 앱의 이름, 아이콘, 번들 보관 기간 등의 설정을 변경합니다. 보관 기간을 0으로 설정하면 무제한으로 저장됩니다.

Example:

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	이 app에 대한 커스텀 device ID 설정 비허용
—block-provider-infra-requests	boolean	이 앱의 provider infrastructure 요청을 차단합니다
—no-block-provider-infra-requests	boolean	이 앱의 provider infrastructure 요청을 허용합니다
—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 channel 이름
—default-download-channel	string	이 앱의 기본 다운로드 채널 이름 (채널 public=true 설정)
—disable-download-channels	boolean	이 앱의 Capgo 다운로드 채널 비활성화 (모든 채널 public=false 설정)
—supa-host	string	커스텀 Supabase 호스트 URL (셀프 호스팅 또는 Capgo 개발용)
—supa-anon	string	커스텀 Supabase anon key (셀프 호스팅용)