Skip to content

๐Ÿ“ฑ ์•ฑ

๐Ÿ“ฑ Manage your Capgo app settings and configurations in Capgo Cloud.

โž• ์„ค์น˜, ๋™๊ธฐํ™” ๋ฐ ์†Œ์Šค ๋งˆํฌ๋‹ค์šด ๊ฐ€์ด๋“œ๋ฅผ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค.

โž• ์ถ”๊ฐ€ํ•˜๊ธฐ ์ œ๋ชฉ

๋ณ„์นญ: a

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app add

โž• ์ƒˆ๋กœ์šด ์•ฑ์„ Capgo Cloud์— ์ถ”๊ฐ€ํ•˜์—ฌ ์œ ๋‹ˆํฌํ•œ ์•ฑ ID๋ฅผ com.test.app ํ˜•์‹์œผ๋กœ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์˜ต์…˜์€ config์—์„œ ์ถ”์ธกํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ˆ์‹œ:

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png

์˜ต์…˜:

ํŒŒ๋ผ๋ฏธํ„ฐํƒ€์ž…์„ค๋ช…
-nstringApp name for display in Capgo Cloud
-istringApp icon path for display in Capgo Cloud
-astringAPI key to link to your account
โ€”supa-hoststringCustom Supabase host URL (for self-hosting or Capgo development)
โ€”supa-anonstring์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•œ Supabase ์ต๋ช… ํ‚ค

๐Ÿ—‘๏ธ ์‚ญ์ œ

์‚ญ์ œ
ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app delete

๐Ÿ—‘๏ธ Capgo Cloud์—์„œ ์•ฑ์„ ์‚ญ์ œํ•˜๊ณ , ์˜ต์…˜์œผ๋กœ ๋ฒ„์ „์„ ์‚ญ์ œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ˆ์‹œ:

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app delete com.example.app

์˜ต์…˜:

ParamType์„ค๋ช…
-astringAPI ๊ณ„์ •์— ์—ฐ๊ฒฐํ•  ํ‚ค
โ€”์„œ๋ฒ„ ํ˜ธ์ŠคํŠธstringCustom Supabase host URL (for self-hosting or Capgo development)
โ€”์ต๋ช… ํ‚คstring์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•ด ์‚ฌ์šฉํ•˜๋Š” Custom Supabase ์ต๋ช… ํ‚ค

๐Ÿ“‹ ๋ชฉ๋ก

๋ชฉ๋ก

๋ณ„์นญ: l

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app list

๊ณ„์ •์— ๋“ฑ๋ก๋œ ๋ชจ๋“  ์•ฑ์„ ๋ชฉ๋ก ํ˜•์‹์œผ๋กœ Capgo Cloud์—์„œ ์—ด๋žŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ˆ์‹œ:

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app list

์˜ต์…˜:

ParamType์„ค๋ช…
-astringAPI ํ‚ค๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊ณ„์ •์— ์—ฐ๊ฒฐ
โ€”supa-hoststring์ž์ฒด ํ˜ธ์ŠคํŒ… ๋˜๋Š” Capgo ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ์ปค์Šคํ…€ ์ˆ˜ํŒŒ๋ฒ ์ด์Šค ํ˜ธ์ŠคํŠธ URL
โ€”supa-anonstring์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•œ ์ปค์Šคํ…€ ์ˆ˜ํŒŒ๋ฒ ์ด์Šค ์ต๋ช… ํ‚ค

๐Ÿž Debug

Debug
Terminal window
npx @capgo/cli@latest app debug

๐Ÿž Listen for live update events in Capgo Cloud to debug your app. Optionally target a specific device for detailed diagnostics.

Example:

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

Options:

ParamTypeDescription
Live update ์ด๋ฒคํŠธ๋ฅผ __CAPGO_KEEP_0__ Cloud์—์„œ ์•ฑ ๋””๋ฒ„๊น…์„ ์œ„ํ•ด ์‹ค์‹œ๊ฐ„์œผ๋กœ ๊ฐ์ง€ํ•ฉ๋‹ˆ๋‹ค. ์˜ต์…˜์œผ๋กœ ํŠน์ • ์žฅ์น˜์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋””๋ฒ„๊น…์„ ์œ„ํ•ด ๋Œ€์ƒ์œผ๋กœ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.stringAPI ๊ณ„์ •์— ์—ฐ๊ฒฐํ•˜๋Š” ํ‚ค
-dstring๋””๋ฒ„๊ทธํ•  ํŠน์ • ์žฅ์น˜ ID
โ€”supa-hoststringCustom Supabase host URL (for self-hosting or Capgo development)
โ€”supa-anonstring์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•œ ์ปค์Šคํ…€ Supabase anon ํ‚ค

โš™๏ธ ์„ค์ •

์„ค์ •
ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app setting

โš™๏ธ Capacitor ๊ตฌ์„ฑ์ด ํ”„๋กœ๊ทธ๋žจ์ ์œผ๋กœ ์ˆ˜์ •๋˜๋„๋ก ์„ค์ •. โ€”string ๋˜๋Š” โ€”bool์„ ์‚ฌ์šฉํ•˜์—ฌ ์„ค์ • ๊ฒฝ๋กœ๋ฅผ ์ง€์ •ํ•˜์‹ญ์‹œ์˜ค (์˜ˆ: plugins.CapacitorUpdater.defaultChannel).

์˜ˆ์‹œ:

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "Production"

์˜ต์…˜:

ํŒŒ๋ผ๋ฏธํ„ฐํƒ€์ž…์„ค๋ช…
โ€”boolstring์„ค์ • ๊ฐ’์„ ์ˆ˜์ •ํ•˜๋Š” boolean ๊ฐ’, ์˜ˆ: โ€”bool true
โ€”stringstring์„ค์ • ๊ฐ’์„ ์ˆ˜์ •ํ•˜๋Š” ๋ฌธ์ž์—ด ๊ฐ’, ์˜ˆ: โ€”string โ€œProductionโ€

Alias: s

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app set

โš™๏ธ ๊ธฐ์กด ์•ฑ์˜ ์„ค์ •์„ ์—…๋ฐ์ดํŠธํ•˜๊ธฐ ์œ„ํ•ด Capgo Cloud์˜ ์ด๋ฆ„, ์•„์ด์ฝ˜, ๋˜๋Š” ๋ฒˆ๋“ค ๋ณด๊ด€ ๊ธฐ๊ฐ„๊ณผ ๊ฐ™์€ ์„ค์ •์„ ์ˆ˜์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. 0์˜ ๋ณด๊ด€ ๊ธฐ๊ฐ„์€ ๋ฌดํ•œ ์ €์žฅ์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค.

์˜ˆ์ œ:

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 30

์˜ต์…˜:

ParamType์„ค๋ช…
-nstringCapgo์—์„œ ํ‘œ์‹œ๋˜๋Š” ์•ฑ ์ด๋ฆ„
-istringCapgo Cloud์—์„œ ์‚ฌ์šฉํ•˜๋Š” ์•ฑ ์•„์ด์ฝ˜์œผ๋กœ ์‚ฌ์šฉ๋˜๋Š” ๋กœ์ปฌ ์ด๋ฏธ์ง€ ํŒŒ์ผ ๊ฒฝ๋กœ (png, jpg, webp, svg)
-astringAPI ๊ณ„์ •์— ์—ฐ๊ฒฐํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋˜๋Š” API ํ‚ค
-rstring๊ธฐ์กด ๋ฒˆ๋“ค ๋ณด์กด ์ผ์ˆ˜ (0 = ๋ฌดํ•œ, ๊ธฐ๋ณธ๊ฐ’: 0)
โ€”expose-metadatastringํ”Œ๋Ÿฌ๊ทธ์ธ์— ๋ฒˆ๋“ค ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ (๋งํฌ ๋ฐ ๋Œ“๊ธ€)๋ฅผ ํ‘œ์‹œ (true/false, ๊ธฐ๋ณธ๊ฐ’: false)
โ€”previewboolean์ด ์•ฑ์— ๋Œ€ํ•œ ๋ฒˆ๋“ค ๋ฐ ์ฑ„๋„ ๋ฏธ๋ฆฌ๋ณด๊ธฐ QR ์ฝ”๋“œ๋ฅผ ํ™œ์„ฑํ™”
โ€”no-previewboolean์ด ์•ฑ์˜ ๋ฒˆ๋“ค ๋ฐ ์ฑ„๋„ ๋ฏธ๋ฆฌ๋ณด๊ธฐ QR ์ฝ”๋“œ๋ฅผ ๋น„ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค.
โ€”allow-device-custom-idboolean์ด ์•ฑ์— ๋Œ€ํ•œ ์žฅ์น˜ ๊ณ ์œ  ID๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.
โ€”no-allow-device-custom-idboolean์ด ์•ฑ์— ๋Œ€ํ•œ ์žฅ์น˜ ๊ณ ์œ  ID ์„ค์ •์„ ๊ธˆ์ง€ํ•ฉ๋‹ˆ๋‹ค.
โ€”block-provider-infra-requestsboolean์ด ์•ฑ์˜ ์ œ๊ณต์ž ์ธํ”„๋ผ ์š”์ฒญ์„ ์ฐจ๋‹จํ•ฉ๋‹ˆ๋‹ค.
โ€”no-block-provider-infra-requestsboolean์ด ์•ฑ์˜ ์ œ๊ณต์ž ์ธํ”„๋ผ ์š”์ฒญ์„ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.
โ€”build-timeout-minutesstring๋นŒ๋“œ ์‹œ๊ฐ„ ์ดˆ๊ณผ ๋ถ„ (5-360, ๊ธฐ๋ณธ๊ฐ’: 15)
โ€”ios-store-urlstring์ด ์•ฑ์˜ iOS App Store URL
โ€”android-store-urlstring์ด ์•ฑ์˜ Google Play Store URL
โ€”default-upload-channelstring์ด ์•ฑ์˜ ๊ธฐ๋ณธ ์—…๋กœ๋“œ ์ฑ„๋„ ์ด๋ฆ„
โ€”default-download-channelstring์ด ์•ฑ์˜ ๊ธฐ๋ณธ ๋‹ค์šด๋กœ๋“œ ์ฑ„๋„ ์ด๋ฆ„ (์ฑ„๋„ public=true)
โ€”disable-download-channelsboolean์ด ์•ฑ์˜ Capgo ๋‹ค์šด๋กœ๋“œ ์ฑ„๋„์„ ๋น„ํ™œ์„ฑํ™” (๋ชจ๋“  ์ฑ„๋„ public=false)
โ€”supa-hoststring์ปค์Šคํ…€ Supabase ํ˜ธ์ŠคํŠธ URL (์ž์ฒด ํ˜ธ์ŠคํŒ… ๋˜๋Š” Capgo ๊ฐœ๋ฐœ)
โ€”supa-anonstring์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•œ Custom Supabase anon ํ‚ค