Skip to content

๐Ÿ”น ๋นŒ๋“œ

๐Ÿ—๏ธ Capgo Cloud๋ฅผ ํ†ตํ•ด ๋„ค์ดํ‹ฐ๋ธŒ iOS/Android ๋นŒ๋“œ๋ฅผ ๊ด€๋ฆฌํ•˜์„ธ์š”.

Alias: onboarding

ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest build init

iOS ๋นŒ๋“œ ์ธ์ฆ์„œ ๋ฐ ํ”„๋กœํŒŒ์ผ์„ ์ž๋™์œผ๋กœ ์ƒ์„ฑํ•˜์—ฌ interactively ์„ค์ •

ํ„ฐ๋ฏธ๋„ ์ฐฝ
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 .

์˜ต์…˜:

__CAPGO_KEEP_0____CAPGO_KEEP_1____CAPGO_KEEP_2__
โ€”pathstringํ”„๋กœ์ ํŠธ ๋นŒ๋“œ ๋””๋ ‰ํ† ๋ฆฌ์˜ ๊ฒฝ๋กœ (๊ธฐ๋ณธ๊ฐ’: ํ˜„์žฌ ๋””๋ ‰ํ† ๋ฆฌ)
โ€”platformstring๋ชฉํ‘œ ํ”Œ๋žซํผ: ios ๋˜๋Š” android (ํ•„์ˆ˜)
โ€”build-modestring๋นŒ๋“œ ๋ชจ๋“œ: debug ๋˜๋Š” release (๊ธฐ๋ณธ๊ฐ’: release)
โ€”build-certificate-base64stringiOS: Base64๋กœ ์ธ์ฝ”๋”ฉ๋œ .p12 ์ธ์ฆ์„œ
โ€”p12-passwordstringiOS: ์ธ์ฆ์„œ ๋น„๋ฐ€๋ฒˆํ˜ธ (์ธ์ฆ์„œ์— ๋น„๋ฐ€๋ฒˆํ˜ธ๊ฐ€ ์—†์œผ๋ฉด ์„ ํƒ ์‚ฌํ•ญ)
โ€”apple-idstringiOS: Apple ID ์ด๋ฉ”์ผ
โ€”apple-app-specific-passwordstringiOS: ์•ฑ ํŠน์ • ๋น„๋ฐ€๋ฒˆํ˜ธ
โ€”apple-key-idstringiOS: App Store Connect API ํ‚ค ID
โ€”apple-issuer-idstringiOS: App Store Connect ๋ฐœ๊ธ‰์ž ID
โ€”apple-key-contentstringiOS: App Store Connect API ํ‚ค (.p8) Base64 ์ธ์ฝ”๋”ฉ
__CAPGO_KEEP_0__stringiOS: ์• ํ”Œ ์Šคํ† ์–ด ์—ฐ๊ฒฐ ํŒ€ ID
__CAPGO_KEEP_0__stringiOS: Xcode๋ฅผ ์œ„ํ•œ ๋นŒ๋“œ ์Šคํ‚ค๋งˆ (๊ธฐ๋ณธ๊ฐ’: ์•ฑ)
__CAPGO_KEEP_0__stringiOS: Xcode ๋นŒ๋“œ ์„ค์ •์„ ์ฝ๊ธฐ ์œ„ํ•œ ํƒ€๊ฒŸ (๊ธฐ๋ณธ๊ฐ’: ์Šคํ‚ค๋งˆ์™€ ๋™์ผ)
__CAPGO_KEEP_0__stringiOS: ๋ฐฐํฌ ๋ชจ๋“œ
__CAPGO_KEEP_0__stringiOS: ๋ฐฐํฌ ํ”„๋กœํŒŒ์ผ ๊ฒฝ๋กœ ๋˜๋Š” bundleId=path ๋งคํ•‘ (๋ฐ˜๋ณต ๊ฐ€๋Šฅ)
__CAPGO_KEEP_0__stringAndroid: Base64๋กœ ์ธ์ฝ”๋”ฉ๋œ ํ‚ค์Šคํ† ์–ด ํŒŒ์ผ
โ€”__CAPGO_KEEP_0__-key-aliasstring์•ˆ๋“œ๋กœ์ด๋“œ: Keystore ํ‚ค ๋ณ„์นญ
โ€”__CAPGO_KEEP_0__-key-passwordstring์•ˆ๋“œ๋กœ์ด๋“œ: Keystore ํ‚ค ๋น„๋ฐ€๋ฒˆํ˜ธ
โ€”__CAPGO_KEEP_0__-store-passwordstring์•ˆ๋“œ๋กœ์ด๋“œ: Keystore ์ €์žฅ์†Œ ๋น„๋ฐ€๋ฒˆํ˜ธ
โ€”__CAPGO_KEEP_0__-config-jsonstring์•ˆ๋“œ๋กœ์ด๋“œ: Google Play ์„œ๋น„์Šค ๊ณ„์ • JSON (Base64 ์ธ์ฝ”๋”ฉ)
โ€”__CAPGO_KEEP_1__string์•ˆ๋“œ๋กœ์ด๋“œ: ๋นŒ๋“œํ•  ์ œํ’ˆ ๋ง›์ง‘ (์˜ˆ: ํ”„๋กœ๋•์…˜). ํ”„๋กœ์ ํŠธ๊ฐ€ ์—ฌ๋Ÿฌ ๋ง›์ง‘์„ ๊ฐ€์ง€๊ณ  ์žˆ๋‹ค๋ฉด ํ•„์ˆ˜.
โ€”__CAPGO_KEEP_2__boolean์ด ๋นŒ๋“œ์— Play Store ์—…๋กœ๋“œ๋ฅผ ์ƒ๋žตํ•ฉ๋‹ˆ๋‹ค (์ €์žฅ๋œ Play Config๋ฅผ null๋กœ ๋งŒ๋“ญ๋‹ˆ๋‹ค). โ€”output-upload๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
โ€”์ถœ๋ ฅ ์—…๋กœ๋“œboolean์ด ๋นŒ๋“œ๋งŒ์„ ์œ„ํ•œ ์ถœ๋ ฅ ์—…๋กœ๋“œ ๋™์ž‘์„ ์˜ค๋ฒ„๋ผ์ด๋“œํ•ฉ๋‹ˆ๋‹ค. ์šฐ์„ ์ˆœ์œ„: CLI > ํ™˜๊ฒฝ๋ณ€์ˆ˜ > ์ €์žฅ๋œ ์ธ์ฆ์„œ
โ€”์ถœ๋ ฅ ์—…๋กœ๋“œ ๋น„ํ™œ์„ฑํ™”boolean์ด ๋นŒ๋“œ๋งŒ์„ ์œ„ํ•œ ์ถœ๋ ฅ ์—…๋กœ๋“œ ๋™์ž‘์„ ์˜ค๋ฒ„๋ผ์ด๋“œํ•ฉ๋‹ˆ๋‹ค. ์šฐ์„ ์ˆœ์œ„: CLI > ํ™˜๊ฒฝ๋ณ€์ˆ˜ > ์ €์žฅ๋œ ์ธ์ฆ์„œ
โ€”์ถœ๋ ฅ ๋ณด์กดstring์ด ๋นŒ๋“œ๋งŒ์„ ์œ„ํ•œ ์ถœ๋ ฅ ๋งํฌ TTL์„ ์˜ค๋ฒ„๋ผ์ด๋“œํ•ฉ๋‹ˆ๋‹ค. ์˜ˆ์‹œ: 1์‹œ๊ฐ„, 6์‹œ๊ฐ„, 2์ผ. ์šฐ์„ ์ˆœ์œ„: CLI > ํ™˜๊ฒฝ๋ณ€์ˆ˜ > ์ €์žฅ๋œ ์ธ์ฆ์„œ
โ€”๋นŒ๋“œ ๋ฒˆํ˜ธ ์ฆ๊ฐ€ ์ƒ๋žตboolean์ž๋™ ๋นŒ๋“œ ๋ฒˆํ˜ธ/๋ฒ„์ „ code ์ฆ๊ฐ€๋ฅผ ์ƒ๋žตํ•ฉ๋‹ˆ๋‹ค. ํ”„๋กœ์ ํŠธ ํŒŒ์ผ์— ์ด๋ฏธ ์žˆ๋Š” ๋ฒ„์ „์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
โ€”๋นŒ๋“œ ๋ฒˆํ˜ธ ์ฆ๊ฐ€ ๋น„ํ™œ์„ฑํ™”boolean์ด ๋นŒ๋“œ๋งŒ์„ ์œ„ํ•œ ์ €์žฅ๋œ ์ธ์ฆ์„œ๋ฅผ ์˜ค๋ฒ„๋ผ์ด๋“œํ•˜์—ฌ ์ž๋™ ๋นŒ๋“œ ๋ฒˆํ˜ธ ์ฆ๊ฐ€๋ฅผ ์žฌ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค.
-a,stringAPI ๊ณ„์ •์— ์—ฐ๊ฒฐํ•˜๋Š” ํ‚ค
โ€”__CAPGO_KEEP_0__-ํ˜ธ์ŠคํŠธstringCustom Supabase host URL (for self-hosting or Capgo development)
โ€”__CAPGO_KEEP_0__-์ต๋ช…string์ž์ฒด ํ˜ธ์ŠคํŒ…์„ ์œ„ํ•ด ์‚ฌ์šฉํ•˜๋Š” ์ปค์Šคํ…€ Supabase ์ต๋ช… ํ‚ค
โ€”verboseboolean์ƒ์„ธ ๋กœ๊น…๊ณผ ํ•จ๊ป˜ ์ž์„ธํ•œ ์ถœ๋ ฅ์„ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ”น ์ธ์ฆ ์ •๋ณด

์ธ์ฆ ์ •๋ณด
ํ„ฐ๋ฏธ๋„ ์ฐฝ
npx @capgo/cli@latest build credentials

๋กœ์ปฌ ๋จธ์‹ ์— ์ €์žฅ๋œ ๋นŒ๋“œ ์ธ์ฆ ์ •๋ณด๋ฅผ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. ๐Ÿ”’ ๋ณด์•ˆ:

  • ์ธ์ฆ ์ •๋ณด๊ฐ€ ~/.capgo-credentials/credentials.json (์ „์—ญ) ๋˜๋Š” .capgo-credentials.json (๋กœ์ปฌ) ์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.
  • When building, sent to Capgo but NEVER stored permanently
  • Capgo์—์„œ ์ „์†ก๋˜๋ฉฐ, ๋นŒ๋“œ ์‹œ ์˜๊ตฌ์ ์œผ๋กœ ์ €์žฅ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • Deleted from __CAPGO_KEEP_0__ immediately after build https://capgo.app/docs/cli/cloud-build/ios/ Build outputs may optionally be uploaded for time-limited download links ๐Ÿ“š DOCUMENTATION: iOS setup: https://capgo.app/docs/cli/cloud-build/android/

https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/ios/

https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/ios/

Android setup: https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/android/ Keep going from build Capgo CI/CD ์ œํ’ˆ ์›Œํฌํ”Œ๋กœ์šฐ์— ๋Œ€ํ•œ Capgo CI/CD์— ๋Œ€ํ•œ Capgo ๋„ค์ดํ‹ฐ๋ธŒ ๋นŒ๋“œ ์ œํ’ˆ ์›Œํฌํ”Œ๋กœ์šฐ์— ๋Œ€ํ•œ Capgo ๋„ค์ดํ‹ฐ๋ธŒ ๋นŒ๋“œ์— ๋Œ€ํ•œ Capgo ํ†ตํ•ฉ ์ œํ’ˆ ์›Œํฌํ”Œ๋กœ์šฐ์— ๋Œ€ํ•œ Capgo ํ†ตํ•ฉ์— ๋Œ€ํ•œ CI/CD ํ†ตํ•ฉ CI/CD ํ†ตํ•ฉ์— ๋Œ€ํ•œ ๊ตฌํ˜„ ์„ธ๋ถ€ ์‚ฌํ•ญ, ๋ฐ GitHub ์•ก์…˜ ํ†ตํ•ฉ์— ๋Œ€ํ•œ ๊ตฌํ˜„ ์„ธ๋ถ€ ์‚ฌํ•ญ for the implementation detail in GitHub Actions Integration.