๐น ๋น๋
์ค์น ๋จ๊ณ์ ์ด ํ๋ฌ๊ทธ์ธ์ ์ ์ฒด ๋งํฌ๋ค์ด ๊ฐ์ด๋๊ฐ ํฌํจ๋ AI ์ค์ ๋ช ๋ น์ด๋ฅผ ๋ณต์ฌํ์ธ์.
๐๏ธ Capgo iOS/Android ๋ค์ดํฐ๋ธ ๋น๋๋ฅผ ๊ด๋ฆฌํ์ธ์.
๋น๋ ์ ๊ทผ ๋ฐ ์ถ๋ ฅ
โ๋น๋ ์ ๊ทผ ๋ฐ ์ถ๋ ฅโ ์น์ Capgo ์๋ฒ์ ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ด ์ ์ฅ๋์ง ์์ต๋๋ค. ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ ๋น๋๋ง ์ฌ์ฉํ๊ณ ์ญ์ ๋ฉ๋๋ค. ๋น๋ ์ถ๋ ฅ์ ์ต์ ์ผ๋ก ์๊ฐ ์ ํ๋ ๋ค์ด๋ก๋ ๋งํฌ์ ํจ๊ป ์ ๋ก๋ํ ์ ์์ต๋๋ค.
__CAPGO_KEEP_0__ ์๋ฒ์ ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ด ์ ์ฅ๋์ง ์์ต๋๋ค. ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ ๋น๋๋ง ์ฌ์ฉํ๊ณ ์ญ์ ๋ฉ๋๋ค. ๋น๋ ์ถ๋ ฅ์ ์ต์ ์ผ๋ก ์๊ฐ ์ ํ๋ ๋ค์ด๋ก๋ ๋งํฌ์ ํจ๊ป ์ ๋ก๋ํ ์ ์์ต๋๋ค.
__CAPGO_KEEP_0__ ์๋ฒ์ ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ด ์ ์ฅ๋์ง ์์ต๋๋ค. ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ ๋น๋๋ง ์ฌ์ฉํ๊ณ ์ญ์ ๋ฉ๋๋ค. ๋น๋ ์ถ๋ ฅ์ ์ต์ ์ผ๋ก ์๊ฐ ์ ํ๋ ๋ค์ด๋ก๋ ๋งํฌ์ ํจ๊ป ์ ๋ก๋ํ ์ ์์ต๋๋ค.npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidํฐ๋ฏธ๋ ์ฐฝ
ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌCI์์ ์ถ๋ ฅ URL ์บก์ฒ --output-record to persist the download URL and QR code, then use build last-output ์ฝ๊ธฐ ์ํด:
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrl๐น ํ์ํ
์ ๋ชฉ์ด โ ๐น Neededโ์ธ ์น์ npx @capgo/cli@latest build needed๐งญ native ๋น๋๊ฐ ํ์ํ๋ฉด โyesโ๋ฅผ ์ถ๋ ฅํ๊ณ code 1๋ก ์ข ๋ฃ; ๊ทธ๋ ์ง ์์ผ๋ฉด โnoโ๋ฅผ ์ถ๋ ฅํ๊ณ code 0์ผ๋ก ์ข ๋ฃ. ๋ช ๋ น ์คํจ ์ code 2๋ก ์ข ๋ฃ.
์์:
npx @capgo/cli@latest build needed com.example.app --channel production --verbose์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| -a | string | API ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ํค |
| -c | string | ๋น๊ตํ ์ฑ๋. ๊ธฐ๋ณธ๊ฐ์ CapacitorUpdater.defaultChannel ๋๋ ๊ณต๊ณต ๊ธฐ๋ณธ ์ฑ๋ |
| โpackage-json | string | ๋ชจ๋ ธ๋ ํฌ์ package.json ํ์ผ ๊ฒฝ๋ก (์ผํ๋ก ๊ตฌ๋ถ) |
| โnode-modules | string | ๋ชจ๋ ธ๋ ํฌ์ node_modules ๋๋ ํฐ๋ฆฌ ๊ฒฝ๋ก (์ผํ๋ก ๊ตฌ๋ถ) |
| โverbose | boolean | verbose ๋ก๊ทธ๋ฅผ ์์ธํ ์ถ๋ ฅํ๋๋ก ํ์ฑํํฉ๋๋ค. |
| โsupa-host | string | ์์ฒด ํธ์คํ ๋๋ ๊ฐ๋ฐ์ ์ํด ์ฌ์ฉํ๋ Supabase ํธ์คํธ URL (๊ธฐ๋ณธ๊ฐ: Capgo) |
| โsupa-anon | string | ์์ฒด ํธ์คํ ์ ์ํด ์ฌ์ฉํ๋ Supabase anon ํค |
๐ Init
๐ InitAlias: onboarding
npx @capgo/cli@latest build initiOS: ์ธ์ฆ์ + ํ๋กํ์ผ ์๋ํ; Android: ํค์คํ ์ด + Google OAuth GCP ์๋น์ค ๊ณ์ ๋ฐ Play Console ์ด๋
Options:
| Param | Type | ์ค๋ช |
|---|---|---|
| -a | string | API ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ํค |
| -p | string | ์จ๋ณด๋ฉํ ํ๋ซํผ (ios ๋๋ android). ์๋ต ์, ios์ android ํด๋ ์ค ํ๋๋ง ์กด์ฌํ ๋ ์๋์ผ๋ก ๊ฐ์งํ๊ณ , ๊ทธ๋ ์ง ์์ผ๋ฉด ์ฌ์ฉ์์๊ฒๆ็คบํฉ๋๋ค. |
| โsupa-host | string | ์ฌ์ฉ์ ์ ์ Supabase ํธ์คํธ URL (์์ฒด ํธ์คํ ๋๋ Capgo ๊ฐ๋ฐ์ฉ) |
| โno-analytics | boolean | ์ด ์คํ์ ๋ํด ๋น๋ ์จ๋ณด๋ฉ ๋ถ์ ๋ฐ ํฐ๋ฏธ๋ ์ฌ์์ ๋นํ์ฑํํฉ๋๋ค. |
๐น Request
๐น ์์ฒญnpx @capgo/cli@latest build requestCapgo ํด๋ผ์ฐ๋์์ ๋ค์ดํฐ๋ธ ๋น๋๋ฅผ ์์ฒญํ์ธ์. ์ด ๋ช ๋ น์ด๋ ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ๋ฅผ ์์ถํ๊ณ Capgo์ ์ ๋ก๋ํ์ฌ ๋น๋ํฉ๋๋ค. ๋น๋๋ ์ฑ ์คํ ์ด๋ก ์ง์ ์ ์ก๋ฉ๋๋ค. Capgo ์๋ฒ์ ์ธ์ฆ ์ ๋ณด๊ฐ ์ ์ฅ๋์ง ์์ต๋๋ค. ๋น๋๊ฐ ์๋ฃ๋ ํ ์ญ์ ๋ฉ๋๋ค. ๋น๋๋ฅผ ์์ฒญํ๊ธฐ ์ ์ ์ ์ฅํ์ธ์.
npx @capgo/cli build credentials save --appId APP_ID --platform ios์์:
npx @capgo/cli@latest build request com.example.app --platform ios --path .์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ์ ๊ฒฝ๋ก๋ฅผ ์ง์ ํ์ฌ ๋น๋ํฉ๋๋ค (๊ธฐ๋ณธ๊ฐ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| โnode-modules | string | ๋ชจ๋ ธ๋ ํฌ์ node_modules ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก๋ฅผ ์ง์ ํฉ๋๋ค (์ผํ๋ก ๊ตฌ๋ถ) |
| โplatform | string | ๋ชฉํ ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โbuild-mode | string | ๋น๋ ๋ชจ๋: debug ๋๋ release (๊ธฐ๋ณธ๊ฐ: release) |
| โbuild-certificate-base64 | string | iOS: Base64๋ก ์ธ์ฝ๋ฉ๋ .p12 ์ธ์ฆ์ |
| โp12-password | string | iOS: ์ธ์ฆ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์ ํ ์ฌํญ) |
| โapple-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ API ํค ๋์ ์ฑ ์คํ ์ด ์ฐ๊ฒฐ API ์ด๋ฉ์ผ์ ์ฌ์ฉํ์ฌ ์ฑ ์คํ ์ด ์ฐ๊ฒฐ API ๋น๋ฐ๋ฒํธ ์ ๋ก๋ (๋์) |
| โapple-app-specific-password | string | iOS: ํ ์คํธ ํ๋ผ์ดํธ ์ ๋ก๋๋ฅผ ์ํ ์ฑ ์คํ ์ด ์ฐ๊ฒฐ __CAPGO_KEEP_0__ ์ฑ ์คํ ์ด ์ฐ๊ฒฐ __CAPGO_KEEP_0__ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ __CAPGO_KEEP_0__ ์ฑ id (์ ํ๋ฆฌ์ผ์ด์ ์คํ ์ด ์ฐ๊ฒฐ __CAPGO_KEEP_0__ id์ ํจ๊ป ํ์) |
| โapple-key-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ API ํค ID |
| โapple-issuer-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ __CAPGO_KEEP_0__ ๋ฐ๊ธ์ ID |
| โapple-key-content | string | iOS: Base64-encoded App Store Connect API key (.p8) |
| โ์ ํ ์คํ ์ด ์ฐ๊ฒฐ ํ ID | string | iOS: ์ ํ ์คํ ์ด ์ฐ๊ฒฐ ํ ID |
| โiOS ์คํค๋ง | string | iOS: Xcode ์คํค๋ง๋ฅผ ๋น๋ํ๊ธฐ ์ํด (๊ธฐ๋ณธ: ์ฑ) |
| โiOS ๋น๋ ๋์ | string | iOS: Xcode ๋น๋ ์ค์ ์ ์ฝ๊ธฐ ์ํด ์ฌ์ฉํ๋ ๋์ (๊ธฐ๋ณธ: ์คํค๋ง์ ๋์ผ) |
| โiOS ๋ฐฐํฌ ๋ชจ๋ | string | iOS: ๋ฐฐํฌ ๋ชจ๋ |
| โiOS ๋ฐฐํฌ ํ๋กํ์ผ | string | iOS: ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path ๋งคํ (๋ฐ๋ณต ๊ฐ๋ฅ) |
| โ์๋๋ก์ด๋ ํค ์คํ ์ด ํ์ผ | string | ์๋๋ก์ด๋: Base64 ์ธ์ฝ๋ฉ ํค์คํ ์ด ํ์ผ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค์คํ ์ด ํค ๋ณ์นญ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค์คํ ์ด ํค ๋น๋ฐ๋ฒํธ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค์คํ ์ด ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: Base64 ์ธ์ฝ๋ฉ Google Play ์๋น์ค ๊ณ์ JSON |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ๋น๋ํ ์ ํ ํ๋๋ฒ (์: ํ๋ก๋์ ). ํ๋ก์ ํธ์ ์ฌ๋ฌ ํ๋๋ฒ๊ฐ ์๋ค๋ฉด ํ์์ ๋๋ค. |
| __CAPGO_KEEP_0__ | string | Android: Google Play in-app ์ ๋ฐ์ดํธ ์ฐ์ ์์ (์ ์ 0โ5; ๋ ๋์ ์ฐ์ ์์) https://developer.android.com/guide/playcore/in-app-updates. ํ๊ฒฝ > ์ ์ฅ๋ ์ธ์ฆ์ > CLI |
| โno-playstore-upload | boolean | ์ด ๋น๋์ ๋ํ ํ๋ ์ด ์คํ ์ด ์ ๋ก๋๋ฅผ ์๋ตํฉ๋๋ค (์ ์ฅ๋ ํ๋ ์ด ๊ตฌ์ฑ์ด null๋ก ์ค์ ๋ฉ๋๋ค). โoutput-upload์ด ํ์ํฉ๋๋ค. |
| โsubmit-to-store-review | boolean | ์ ๋ก๋ ํ ์คํ ์ด ๋ฆด๋ฆฌ์ฆ๋ฅผ ๋ฆฌ๋ทฐ์ ์ ์ถํ๋ ๋์ draft/๋นํ์ฑํ ๋น๋๋ก ๋จ๊น๋๋ค. Android๋ ํ๋ ์ด ๋ฆด๋ฆฌ์ฆ๋ฅผ ์๋ฃ ํ์ํ๊ณ iOS๋ ์ฒ๋ฆฌ๋ ํ ์คํธ ํ๋ผ์ดํธ ๋น๋๋ฅผ ์ฑ ์คํ ์ด ๋ฆฌ๋ทฐ์ ์ ์ถํฉ๋๋ค. |
| โstore-release-name | string | ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ์ด๋ฆ/๋ฒ์ ๋ ์ด๋ธ. Android๋ ์ด ๊ฐ์ Google Play์ version_name์ผ๋ก ์ ์กํ๊ณ iOS๋ ํธ์ง ๊ฐ๋ฅํ ๋ฒ์ ์ ๋ง๋ค๊ฑฐ๋ ์ฌ์ฌ์ฉํ ๋ App Store์ ๋ฒ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โstore-release-notes | string | ๊ธฐ๋ณธ ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ. Android๋ ์ด ๊ฐ์ ํ๋ ์ด์ ๋ณ๊ฒฝ ๋ก๊ทธ๋ก ์ฌ์ฉํ๊ณ iOS๋ ๊ธฐ๋ณธ App Store์ 'Whatโs New' ํ ์คํธ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โstore-release-notes-locale | string | ๊ตญ์ ํ๋ ์คํ ์ด ๋ฆด๋ฆฌ์ค ๋ ธํธ (๋ฐ๋ณต ๊ฐ๋ฅ), ์๋ฅผ ๋ค์ด โstore-release-notes-locale en-US=โ๋ฒ๊ทธ ์์ โ โstore-release-notes-locale fr-FR=โ์์ โ. |
| โios-testflight-๊ทธ๋ฃน | string | iOS: ์ธ๋ถ ๋ฒ ํ ๋ฐฐํฌ๋ฅผ ์ํด ์ธ๋ถ ๊ทธ๋ฃน ์ด๋ฆ ๋๋ ID๋ฅผ ์ผํ๋ก ๊ตฌ๋ถํ์ฌ ์ง์ ํฉ๋๋ค. |
| โios-์๋ ๋ฆด๋ฆฌ์ค | boolean | iOS: ์ ํ ์น์ธ ํ ์ฑ ์คํ ์ด ๋ฒ์ ์ ์๋์ผ๋ก ๋ฆด๋ฆฌ์คํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ ์๋ ๋ฆด๋ฆฌ์ค์ ๋๋ค. |
| โno-ios-์๋ ๋ฆด๋ฆฌ์ค | boolean | iOS: ์ ํ ์น์ธ ํ ์ฑ ์คํ ์ด ๋ฒ์ ์ ๊ธฐ๋ค๋ฆฌ๋ฉฐ ์๋ ๋ฆด๋ฆฌ์ค๋ฅผ ์ ์งํฉ๋๋ค. |
| โ์ถ๋ ฅ ์ ๋ก๋ | boolean | ์ด ๋น๋๋ง์ ์ํด ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ค๋ฒ๋ผ์ด๋ํฉ๋๋ค (ํ์ฑํ). ์ฐ์ ์์: CLI > ํ๊ฒฝ > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โ์ถ๋ ฅ ์ ๋ก๋ ๋นํ์ฑํ | boolean | ์ด ๋น๋๋ง์ ์ํด ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ค๋ฒ๋ผ์ด๋ํฉ๋๋ค (๋นํ์ฑํ). ์ฐ์ ์์: CLI > ํ๊ฒฝ > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โ์ถ๋ ฅ ๋ณด์กด | string | ์ด ๋น๋๋ง์ ์ํด ์ถ๋ ฅ ๋งํฌ TTL์ Overrideํฉ๋๋ค. ์์: 1์๊ฐ, 6์๊ฐ, 2์ผ. ์ฐ์ ์์: CLI > ํ๊ฒฝ๋ณ์ > ์ ์ฅ๋ ์ธ์ฆ์ |
| โoutput-record | string | ๋น๋๊ฐ ์ฑ๊ณต์ ์ผ๋ก ์๋ฃ๋๋ฉด, JSON ๋ ์ฝ๋(jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)๋ฅผ ์ง์ ๋ ๊ฒฝ๋ก์ ๊ธฐ๋กํฉ๋๋ค. PNG QR code๋ ๊ทธ ๊ฒฝ๋ก์ ๋ถ์ด ์์ต๋๋ค. .qr.png suffix. ๋ ์ฝ๋ ํ๋๋ฅผ ๋ค์ ์ฝ์ผ๋ ค๋ฉด build last-output. |
| โno-skip-build-number-bump | boolean | ์ด ๋น๋๋ง์ ์ํด ์ ์ฅ๋ ์ธ์ฆ์๋ฅผ ์ฌํ์ฉํ์ฌ ์๋ ๋น๋ ๋ฒํธ ์ฆ๊ฐ๋ฅผ ์ฌ ํ์ฑํํฉ๋๋ค. |
| โskip-marketing-version-bump | boolean | ์ฑ์ด ์ด๋ฏธ ์ถ์๋์์ ๋ ์๋ ๋ง์ผํ ๋ฒ์ (CFBundleShortVersionString / versionName) ์ฆ๊ฐ๋ฅผ ์๋ตํฉ๋๋ค. |
| โsync-ios-version | boolean | iOS: ๋น๋ ์ package.json์ MARKETING_VERSION์ Xcode์์ syncํฉ๋๋ค. |
| โai-analytics | boolean | ๋น๋ ์คํจ ์, Capgo AI๋ก ๋ก๊ทธ๋ฅผ ์ ์กํ์ฌ ์ง๋จํฉ๋๋ค. ์ธํฐ๋ํฐ๋ธ ํฐ๋ฏธ๋์์๋ ์ฌ์ ํ์ธ์ ์๋ตํ๊ณ CI์์๋ ์๋ ์ ๋ก๋ ๋ฐ ๋ถ์์ stderr์ ์ถ๋ ฅํฉ๋๋ค. |
| โno-prescan | boolean | ์๋ ๋น๋ ์ค์บ์ ์๋ตํฉ๋๋ค. |
| โprescan-ignore-fatal | boolean | ๋น๋ ์ค๋จ์ ํผํ๋ฉด์ ๋น๋ ์ค์บ์ ์งํํฉ๋๋ค. |
| โfail-on-warnings | boolean | ๋น๋ ์ค์บ ๊ฒฝ๊ณ ๋ฅผ ๋น๋ ์คํจ๋ก ์ฒ๋ฆฌํฉ๋๋ค. |
| โsend-logs-to-support | boolean | CI/CD ๋น๋ ์คํจ ์ ์๋์ผ๋ก Capgo ์ง์ํ์ ๋น๋ ๋ก๊ทธ๋ฅผ ์ ์กํฉ๋๋ค. ์ด๋ฉ์ผ์ด ํ์ํ์ง ์์ต๋๋ค. Capgo ์ง์ํ์ ์ด๋ฉ์ผ๋ก ์ฐ๋ฝ์ ์ทจํ ๊ฒ์ ๋๋ค. โai-analytics์ ํจ๊ป ์ฌ์ฉํ ์ ์์ต๋๋ค. |
| โsend-logs | boolean | โsend-logs-to-support์ alias์ ๋๋ค. |
| -a | string | API ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ํค์ ๋๋ค. |
| โsupa-host | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| โsupa-anon | string | ์ฌ์ฉ์ ์ ์ Supabase ์ต๋ช ํค (์์ฒด ํธ์คํ ์ฉ) |
| โverbose | boolean | ์ธ๋ถ ๋ก๊น ๊ณผ ํจ๊ป ์์ธํ ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค. |
๐น Sync-ios-version
Sync-ios-versionnpx @capgo/cli@latest build sync-ios-versionpackage.json์ MARKETING_VERSION์ ๋ก์ปฌ iOS Xcode์ ๋๊ธฐํํฉ๋๋ค.
์์:
npx @capgo/cli@latest build sync-ios-version --path .์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ๊ฐ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| โcheck | boolean | ์ฒดํฌ๋ง; MARKETING_VERSION์ด ๋๊ธฐํ๋์ง ์์ ๊ฒฝ์ฐ 0์ด ์๋ ๊ฐ์ ๋ฐํ |
๐น ์ด๊ธฐ ์ค์บ
๐น ์ด๊ธฐ ์ค์บ ์น์ npx @capgo/cli@latest build prescan__CAPGO_KEEP_0__ ํ๋ก์ ํธ์ ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช
์ ์
๋ก๋ํ๊ธฐ ์ ์ ์คํจํ ํด๋ผ์ฐ๋ ๋น๋๋ฅผ ์คํจํ๋ ๋ฌธ์ ๋ฅผ ์ค์บํ์ญ์์ค.
์๊ฒฉ ์ฆ๋ช
(๋ง๋ฃ, ์ํธ, ํ๋กํ pair๋ง), ํ๋ก์ ํธ ์ํ(cap sync, node_modules ๋ ์ด์์), ํ๋ซํผ ๊ตฌ์ฑ ํ์ธ. ์๋์ผ๋ก ๋ด๋ถ์์ ์คํ๋๋ฉฐ build request; ์ด ๋ช
๋ น์ด๋ CI์์ standalone๋ก ์คํํฉ๋๋ค.
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โplatform | string | ๋์ ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| -a | string | API ํค๋ฅผ ํด๋ฆญํ์ฌ ๊ณ์ ์ ์ฐ๊ฒฐํ์ธ์. |
| โandroid-flavor | string | ์๋๋ก์ด๋: ๋น๋์ ์ฌ์ฉํ ์ ํ ๋ง์ ์ง์ ํฉ๋๋ค. |
| โios-dist | string | iOS: ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ์ํด ์ฌ์ฉํ ๋ฐฐํฌ ๋ชจ๋๋ฅผ ์ง์ ํฉ๋๋ค. |
| โjson | boolean | ๊ธฐ๊ณ๊ฐ ์ฝ์ ์ ์๋ JSON ๋ณด๊ณ ์๋ฅผ ์ถ๋ ฅํฉ๋๋ค. |
| โfail-on-warnings | boolean | ๊ฒฝ๊ณ ๊ฐ ๋ฐ๊ฒฌ๋๋ฉด 0์ด ์๋ ๊ฐ์ ๋ฐํํฉ๋๋ค (CI) |
| โignore-fatal | boolean | ๋๋ฒ๊ทธ ๋ชจ๋: ํญ์ 0์ ๋ฐํํ์ง๋ง ๋ชจ๋ ๊ฒ์ ๋ณด๊ณ ํฉ๋๋ค. |
| โverbose | boolean | ์์ธ ๋ก๊น ์ ํฌํจํ ์์ธํ ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค. |
| โsupa-host | string | ์์ฒด ํธ์คํ ๋๋ ๊ฐ๋ฐ์ ์ํด ์ฌ์ฉํ๋ Supabase ํธ์คํธ URL (๊ฐ๋ฐ์ฉ Capgo) |
| โsupa-anon | string | ์์ฒด ํธ์คํ ์ ์ํด ์ฌ์ฉํ๋ Supabase anon ํค |
๐น Last-output
โ ๐น Last-outputโ ์ ๋ชฉ์ ์น์ npx @capgo/cli@latest build last-output์ด์ ๋น๋ ์ถ๋ ฅ ๊ธฐ๋ก์ ์ฝ์ต๋๋ค. build request --output-record.
Prints the full JSON by default, a single field with โfield, or the ASCII QR
code with โqr. Useful in CI to grab the download URL or QR for posting back
to a PR or issue.
Examples:
npx @capgo/cli build last-output โpath /tmp/build.json
npx @capgo/cli build last-output โpath /tmp/build.json โfield outputUrl
npx @capgo/cli build last-output โpath /tmp/build.json โqr
Options:
| Param | Type | ์ค๋ช |
|---|---|---|
| โpath | string | JSON ๊ธฐ๋ก์ โoutput-record๋ก ๊ธฐ๋กํ ๊ฒฝ๋ก (ํ์) |
| โfield | string | ๋จ์ผ field๋ฅผ ์ถ๋ ฅ (๋ค์ ์ค ํ๋: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| โqr | boolean | ASCII QR code๋ฅผ ์ถ๋ ฅ (โfield qrCodeAscii์ ๋จ์ถ) |
๐น ์ธ์ฆ ์ ๋ณด
๐น ์ธ์ฆ ์ ๋ณด__CAPGO_KEEP_0__
- Credentials saved to ~/.capgo-credentials/credentials.json (global) or .capgo-credentials.json (local)
- Capgo
- Capgo
- __CAPGO_KEEP_0__ https://capgo.app/docs/cli/cloud-build/ios/ __CAPGO_KEEP_1__ capgo.app/docs/cli/cloud-build/ios/
๐น __CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/android/
__CAPGO_KEEP_0____CAPGO_KEEP_1__ asc-key
npx @capgo/cli@latest build credentials apple-keyApp Store Connect ํ API ํค๋ฅผ ๊ฐ์ด๋๋ macOS ๋์ฐ๋ฏธ๋ฅผ ์ฌ์ฉํ์ฌ macOS ์ ์ฉ์ผ๋ก ์์ฑํ์ธ์. App Store Connect UI์ ๋ด์ฅ ๋ธ๋ผ์ฐ์ ์์ Apple์ UI๋ฅผ walks throughํ๋ ๋ค์ดํฐ๋ธ ์ฐฝ์ ์ด์ด, Issuer ID + Key ID๋ฅผ ์๋์ผ๋ก ์บก์ฒํ๊ณ , one-time .p8๋ฅผ ์ค๊ฐ์ๆช่ทํ๊ณ , Apple๊ณผ ์ ํจ์ฑ์ ๊ฒ์ฌํ๊ณ , ~/.appstoreconnect/private_keys์ ์ ์ฅํฉ๋๋ค. progress statistics๋ Capgo ๋ถ์ (disable with CAPGO_DISABLE_TELEMETRY)๋ก ์ ๋ฌ๋ฉ๋๋ค. npx @capgo/cli build credentials apple-key โappId com.example.app
์์:
Example:์ค์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| -a | string | API ํค๋ฅผ ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํด |
| appId | string | __CAPGO_KEEP_0__ ์ฑ iOS ๋น๋ ์ธ์ฆ์์ ์ ์ฅ |
| โlocal | boolean | capgo-credentials.json ํ์ผ ๋์ ์ ์ญ ํ์ผ์ ์ ์ฅ |
| โjson | boolean | ์บก์ฒ๋ ํค ID / ๋ฐ๊ธ์ ID / .p8 ๊ฒฝ๋ก๋ฅผ JSON ํ์์ผ๋ก ์ถ๋ ฅ |
๐น ์ ์ฅ
๐น ์ ์ฅnpx @capgo/cli@latest build credentials saveiOS ๋๋ Android์ ๋น๋ ์ธ์ฆ์๋ฅผ ์ง์ญ ์ ์ฅ์์ ์ ์ฅํ์ญ์์ค. ์ธ์ฆ์๋ ๋ค์ ์์น์ ์ ์ฅ๋ฉ๋๋ค.
- ~/capgo-credentials/credentials.json (๊ธฐ๋ณธ, ์ ์ญ)
- capgo-credentials.json (ํ๋ก์ ํธ ๋ฃจํธ, โlocal ํ๋๊ทธ ์ฌ์ฉ)
โ ๏ธ ๋น๋ํ๊ธฐ ์ ์ ๋ฐ๋์ ์ธ์ฆ์๋ฅผ ์ ์ฅํ์ญ์์ค.
๐ ์ด ์ธ์ฆ์๋ Capgo ์๋ฒ์ ์๊ตฌ์ ์ผ๋ก ์ ์ฅ๋์ง ์์ต๋๋ค.
๋น๋๊ฐ ์๋ฃ๋๋ฉด ์ฆ์ ์ญ์ ๋ฉ๋๋ค.
๐ ์ค์ ๊ฐ์ด๋:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
์๋๋ก์ด๋: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save โplatform ios
โ์ธ์ฆ์ ./cert.p12 โp12-์ํธ โpasswordโ
โios-๋ฐฐํฌ ํ๋กํ์ผ ./profile.mobileprovision
โ์ ํ ํค ./AuthKey.p8 โ์ ํ ํค ์์ด๋ โKEY123โ
โapple-issuer-id โissuer-uuidโ โapple-team-id โteam-idโ Multi-target Example (app + widget extension): npx @capgo/cli build credentials save โplatform ios
๋ค์ค ๋์ ์์ (์ฑ + ์์ ฏ ํ์ฅ):
npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ build credentials save โplatform ios
โฆ npx @capgo/cli build credentials save โplatform android
โios-๋ฐฐํฌ ํ๋กํ์ผ com.example.widget=./Widget.mobileprovision
โ__CAPGO_KEEP_0__-key-password โ__CAPGO_KEEP_1__โ
โplay-config ./service-account.json Local storage (per-project): npx @capgo/cli build credentials save โlocal โplatform ios โฆ
์์:
iOS Example:์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| โappId | string | ์ฑ ID (์: com.example.app) (ํ์) |
| โํ๋ซํผ | string | ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โ์ธ์ฆ์ | string | iOS: .p12 ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| โios-๋ฐฐํฌ ํ๋กํ์ผ | string | iOS: ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path (๋ฐ๋ณต ๊ฐ๋ฅ) |
| โp12-๋น๋ฐ๋ฒํธ | string | iOS: ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์ ํ ์ฌํญ) |
| โ์ ํ-ํค | string | iOS: .p8 App Store Connect API ํค ๊ฒฝ๋ก |
| โ์ ํ-ํค-์์ด๋ | string | iOS: App Store Connect API Key ID |
| โ์ ํ-์ด์์ด-์์ด๋ | string | iOS: App Store Connect ๋ฐ๊ธ์ ID |
| __CAPGO_KEEP_0__ | string | iOS: App Store Connect ํ ID |
| โios-distribution | string | iOS: ๋ฐฐํฌ ๋ชจ๋ |
| โapple-id | string | iOS: ์ ํ ID ์ด๋ฉ์ผ (App Store Connect API ํค ๋์ฒด) |
| โapple-app-specific-password | string | iOS: ํ ์คํธ ํ๋ผ์ดํธ ์ ๋ก๋๋ฅผ ์ํ ์ฑ ํน์ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: App Store Connect ์ฑ ID (์ ํ ID์ ์ฑ ํน์ ๋น๋ฐ๋ฒํธ์ ํจ๊ป ํ์) |
| โkeystore | string | ์๋๋ก์ด๋: ํค ์คํ ์ด ํ์ผ ๊ฒฝ๋ก (.keystore ๋๋ .jks) |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค ์คํ ์ด ํค ๋ณ์นญ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค ์คํ ์ด ํค ๋น๋ฐ๋ฒํธ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํค ์คํ ์ด ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ํ๋ ์ด ์คํ ์ด ์๋น์ค ๊ณ์ JSON ํ์ผ ๊ฒฝ๋ก |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ๋น๋ํ ์ ํ ํ๋๋ฒ (์: ํ๋ก๋์ ). ํ๋ก์ ํธ์ ์ฌ๋ฌ ํ๋๋ฒ๊ฐ ์๋ ๊ฒฝ์ฐ ํ์ |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: Google Play ๋ด ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (0โ5; ๋ ๋์์๋ก ๋ ๊ธํจ). ์๋ตํ๋ฉด Play์ ๊ธฐ์กด ๊ฐ์ด ์ ์ง๋ฉ๋๋ค. |
| โlocal | boolean | ํ๋ก์ ํธ ๋ฃจํธ์ .capgo-credentials.json ํ์ผ๋ก ์ ์ฅํ๊ธฐ ๋์ ์ ์ญ ~/.capgo-credentials/์ ์ ์ฅํฉ๋๋ค. |
| โoutput-upload | boolean | Capgo ์ ์ฅ์์ ๋น๋ ์ถ๋ ฅ๋ฌผ (IPA/APK/AAB)์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ๋ฅผ ์ถ๋ ฅํฉ๋๋ค. |
| โno-output-upload | boolean | ๋น๋ ์ถ๋ ฅ๋ฌผ (IPA/APK/AAB)์ Capgo ์ ์ฅ์์ ์ ๋ก๋ํ์ง ์์ต๋๋ค. |
| โoutput-retention | string | ์ถ๋ ฅ ๋งํฌ TTL: 1์๊ฐ์์ 7์ผ (๊ธฐ๋ณธ: 1์๊ฐ). ์์: 1์๊ฐ, 6์๊ฐ, 2์ผ |
| โskip-build-number-bump | boolean | ๋ฏธ๋ ๋น๋์์ ์๋ ๋น๋ ๋ฒํธ/๋ฒ์ code ์ฆ๊ฐ๋ฅผ ์๋ตํฉ๋๋ค. |
| โno-skip-build-number-bump | boolean | ์๋ ๋น๋ ๋ฒํธ ์ฆ๊ฐ๋ฅผ ์ฌ ํ์ฑํ (๊ธฐ๋ณธ ๋์) |
| โskip-marketing-version-bump | boolean | ์ฑ์ด ์ด๋ฏธ ์ถ์๋ ๊ฒฝ์ฐ ๋ฏธ๋ ๋น๋์์ ์๋ ๋ง์ผํ ๋ฒ์ ์ ์ ์๋ตํฉ๋๋ค. |
| โno-skip-marketing-version-bump | boolean | ์๋ ๋ง์ผํ ๋ฒ์ ์ ์ ์ฌ ํ์ฑํ (๊ธฐ๋ณธ ๋์) |
๐ ๋ชฉ๋ก
๋ชฉ๋ก ์ ๋ชฉ โ ๐ Listโnpx @capgo/cli@latest build credentials list์ ์ฅ๋ ๋น๋ ์๊ฒฉ ์ฆ๋ช ๋ชฉ๋ก (๋น๋ฐ๋ฒํธ๊ฐ ๊ฐ๋ ค์ง). ํ์ฌ ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช (์ ์ญ ๋ฐ ์ง์ญ ๋ชจ๋)์ ๋ณด์ฌ์ค๋๋ค. ์์: npx @capgo/cli build credentials list # ๋ชจ๋ ์ฑ ๋ชฉ๋ก npx @capgo/cli build credentials list โappId com.example.app # ํน์ ์ฑ ๋ชฉ๋ก
์ต์ :
| ํ๋ผ๋ฏธํฐ: | ํ์ | ์ค๋ช |
|---|---|---|
| โappId | string | ์ฑ ID๋ฅผ ๋ชฉ๋ก์ ์ถ๊ฐ (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ์ฑ์ ๋ชฉ๋ก์ ์ถ๊ฐ) |
| โlocal | boolean | ๋ก์ปฌ capgo-credentials.json์์๋ง ์ธ์ฆ ์ ๋ณด๋ฅผ ๋ชฉ๋ก์ ์ถ๊ฐ |
๐น Clear
โ ๐น Clearโ๋ผ๋ ์ ๋ชฉ์ ์น์ npx @capgo/cli@latest build credentials clear์ ์ฅ๋ ๋น๋ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ญ์ ํฉ๋๋ค. ์ ์ฅ์์์ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ญ์ ํฉ๋๋ค. โappId ๋ฐ โplatform์ ์ฌ์ฉํ์ฌ ํน์ ์ธ์ฆ ์ ๋ณด๋ฅผ ๋์์ผ๋กํฉ๋๋ค. ์์: npx @capgo/cli build credentials clear # ์ ์ญ์์ ๋ชจ๋ ์ฑ์ ์ญ์ ํฉ๋๋ค. npx @capgo/cli build credentials clear โlocal # ๋ก์ปฌ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ญ์ ํฉ๋๋ค. npx @capgo/cli build credentials clear โappId com.example.app โplatform ios
์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| โappId | string | ํด๋ฆฌ์ดํ ์ฑ ID (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ์ฑ์ ํด๋ฆฌ์ด) |
| โplatform | string | ํด๋ฆฌ์ดํ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ํ๋ซํผ์ ํด๋ฆฌ์ด) |
| โlocal | boolean | ์ง์ญ capgo-credentials.json์์ ํด๋ฆฌ์ดํ๊ธฐ ๋์ ๊ธ๋ก๋ฒ์์ ํด๋ฆฌ์ด |
๐น ์ ๋ฐ์ดํธ
โ ๐น Updateโ ์น์ npx @capgo/cli@latest build credentials updateํน์ ์ธ์ฆ์๋ฅผ ์ ๋ฐ์ดํธํ๋ ค๋ฉด ๋ชจ๋ ์ธ์ฆ์๋ฅผ ๋ค์ ์ ๊ณตํ์ง ์์๋ ๋ฉ๋๋ค. ๊ธฐ์กด ์ธ์ฆ์๋ฅผ ์ ๋ฐ์ดํธํ๋ ค๋ฉด ๋ณ๊ฒฝํ๊ณ ์ถ์ field๋ง ์ ๊ณตํ๋ฉด ๋ฉ๋๋ค. ํ๋ซํผ์ ์ ๊ณตํ ์ต์ ์ผ๋ก๋ถํฐ ์๋์ผ๋ก ๊ฐ์ง๋ฉ๋๋ค. ์์: npx @capgo/cli build credentials update โios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update โlocal โkeystore ./new-keystore.jks
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โappId | string | ์ฑ ID (์๋์ผ๋ก capacitor.config์์ ๊ฐ์ง๋ฉ๋๋ค. ์๋ต ์) |
| โplatform | string | ํ๋ซํผ: ios ๋๋ android (์๋์ผ๋ก ๊ฐ์ง๋ฉ๋๋ค. ์ ๊ณตํ ์ต์ ) |
| โlocal | boolean | ์ ์ญ ๋์ ๋ก์ปฌ .capgo-credentials.json์ ์ ๋ฐ์ดํธํฉ๋๋ค. |
| โ์ธ์ฆ์ | string | __CAPGO_KEEP_0__ ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| โios-๋ฐฐํฌ ํ๋กํ์ผ | string | ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path (๋ฐ๋ณต ๊ฐ๋ฅ, ๊ธฐ๋ณธ์ ์ผ๋ก ์ถ๊ฐ) |
| โoverwrite-ios-๋ฐฐํฌ ํ๋กํ์ผ ๋งต | boolean | ๋ฐฐํฌ ํ๋กํ์ผ ๋งต์ ๋ชจ๋ ๋์ฒดํ๋ ๋์ ๋ณํฉ (๊ธฐ๋ณธ: ๋ณํฉ) |
| โp12-์ํธ | string | P12 ์ธ์ฆ์ ์ํธ |
| โ์ ํ ํค | string | API App Store Connect ํค (.p8 ํ์ผ ๊ฒฝ๋ก) |
| โ์ ํ ํค ์์ด๋ | string | App Store Connect API ํค ์์ด๋ |
| โapple-issuer-id | string | ์ ํ๋ฆฌ์ผ์ด์ ์คํ ์ด ์ฐ๊ฒฐ ๋ฐ๊ธ์ ID |
| โapple-team-id | string | ์ ํ๋ฆฌ์ผ์ด์ ์คํ ์ด ์ฐ๊ฒฐ ํ ID |
| โapple-id | string | iOS: ์ฑ๋ณ ์ํธ ์ ๋ก๋๋ฅผ ์ํ ์ ํ ID ์ด๋ฉ์ผ (์ ํ๋ฆฌ์ผ์ด์ ์คํ ์ด ์ฐ๊ฒฐ API ํค ๋์ฒด) |
| โapple-app-specific-password | string | iOS: ํ ์คํธ ํ๋ผ์ดํธ ์ ๋ก๋๋ฅผ ์ํ ์ฑ๋ณ ์ํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ ์ฑ ID (์ ํ๋ฆฌ์ผ์ด์ ์คํ ์ด ์ฐ๊ฒฐ ID์ โapple-id, โapple-app-specific-password ํ์) |
| โios-distribution | string | iOS: ๋ฐฐํฌ ๋ชจ๋ |
| โํค์คํ ์ด | string | ํค์คํ ์ด ํ์ผ ๊ฒฝ๋ก (.keystore or .jks) |
| โํค์คํ ์ด-alias | string | ํค์คํ ์ด ํค ๋ณ์นญ |
| โํค์คํ ์ด-ํค-ํจ์ค์๋ | string | ํค์คํ ์ด ํค ํจ์ค์๋ |
| โํค์คํ ์ด-์คํ ์ด-ํจ์ค์๋ | string | ํค์คํ ์ด ์ ์ฅ์ ํจ์ค์๋ |
| โํ๋ ์ด-๊ตฌ์ฑ | string | ๊ตฌ๊ธ ํ๋ ์ด ์๋น์ค ๊ณ์ JSON ๊ฒฝ๋ก |
| โ์๋๋ก์ด๋-ํ๋ ์ด๋ฒ | string | ์๋๋ก์ด๋: ์ ํ ํ๋ ๋ฒ๋ฅผ ๋น๋ (์: ํ๋ก๋์ ). ํ๋ก์ ํธ์ ์ฌ๋ฌ ํ๋ ๋ฒ๊ฐ ์๋ ๊ฒฝ์ฐ ํ์. |
| ์ฑ ๋ด ์ ๋ฐ์ดํธ ์ฐ์ ์์ | string | ์๋๋ก์ด๋: Google Play ์ฑ ๋ด ์ ๋ฐ์ดํธ ์ฐ์ ์์ (0-5; ๋ ๋์์๋ก ๋ ๊ธํจ) |
| ์ถ๋ ฅ ์ ๋ก๋ | boolean | ๋น๋ ์ถ๋ ฅ (IPA/APK/AAB)์ Capgo ์ ์ฅ์์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ ์ถ๋ ฅ |
| ์ถ๋ ฅ ์ ๋ก๋ ๋ฏธ์ ๋ก๋ | boolean | ๋น๋ ์ถ๋ ฅ (IPA/APK/AAB)์ Capgo ์ ์ฅ์์ ์ ๋ก๋ํ์ง ์์ |
| ์ถ๋ ฅ ์ ํจ ์๊ฐ | string | ์ถ๋ ฅ ๋งํฌ ์ ํจ ์๊ฐ: 1์๊ฐ์์ 7์ผ. ์์: 1์๊ฐ, 6์๊ฐ, 2์ผ |
| ๋น๋ ๋ฒํธ ์ฆ๊ฐ ๊ฑด๋๋ฐ๊ธฐ | boolean | ๋ฏธ๋ ๋น๋์์ ์๋ ๋น๋ ๋ฒํธ/๋ฒ์ code ์ฆ๊ฐ๋ฅผ ๊ฑด๋๋ |
| ๋น๋ ๋ฒํธ ์ฆ๊ฐ ๊ฑด๋๋ฐ๊ธฐ ํด์ | boolean | ์๋ ๋น๋ ๋ฒํธ ์ฆ๊ฐ๋ฅผ ์ฌ ํ์ฑํ (๊ธฐ๋ณธ ๋์) |
| โ์๋ ๋ง์ผํ ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ๊ฑด๋ ๋ฐ๊ธฐ | boolean | ์ฑ์ด ์ด๋ฏธ ์ถ์๋์์ ๋ ๋ฏธ๋ ๋น๋์์ ์๋ ๋ง์ผํ ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ๊ฑด๋ ๋ฐ์ธ์ |
| โ๋ง์ผํ ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ๊ฑด๋ ๋ฐ๊ธฐ | boolean | ๋ฏธ๋ ๋น๋์์ ์๋ ๋ง์ผํ ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ์ฌ ํ์ฑํ (๊ธฐ๋ณธ ๋์) |
๐น ๊ด๋ฆฌ
๊ด๋ฆฌ ์น์ npx @capgo/cli@latest build credentials manage์ ์ฅ๋ ๋น๋ ์ธ์ฆ์๋ฅผ ์ํธ ์์ฉ์ ์ผ๋ก ๊ด๋ฆฌํฉ๋๋ค.
์ ์ฅ๋ ์ธ์ฆ์๋ฅผๆต่งํ๊ณ , ๊ตฌ์ฑ๋ ํญ๋ชฉ์ ํ์ธํ๊ณ , CI/CD ์ค๋น๋ .env ํ์ผ์ ๋ด๋ณด๋ด๊ฑฐ๋, ํ๋ซํผ์ ์ธ์ฆ์๋ฅผ ์ญ์ ํ ์ ์์ต๋๋ค. ๋์ผํ TUI๋ฅผ ์ฌ์ฌ์ฉํฉ๋๋ค.
์์:
npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ build credentials manage
npx @__CAPGO_KEEP_2__/__CAPGO_KEEP_3__ build credentials manage โappId com.example.app
npx @__CAPGO_KEEP_4__/__CAPGO_KEEP_5__ build credentials manage โappId com.example.app โplatform ios
npx @__CAPGO_KEEP_6__/__CAPGO_KEEP_7__ build credentials manage โlocal capgo init.
Examples:
npx @capgo/cli build credentials manage
npx @capgo/cli build credentials manage โappId com.example.app
npx @capgo/cli build credentials manage โappId com.example.app โplatform ios
npx @capgo/cli build credentials manage โlocal
ํ๋ผ๋ฏธํฐ
| โ__CAPGO_KEEP_0__ | ํ์ | ์ค๋ช |
|---|---|---|
| โappId | string | __CAPGO_KEEP_0__ ์ฑ ID๋ฅผ ๊ด๋ฆฌ (์ ํ ์ฌํญ, ์๋ต ์ ์ ํํ๋๋ก ์ ๋) |
| โplatform | string | ๊ด๋ฆฌํ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ต ์ ์ ํํ๋๋ก ์ ๋) |
| โlocal | boolean | ๋ก์ปฌ capgo-credentials.json๋ง ๋ธ๋ผ์ฐ์ง |
๐น ์ด๋
๐น ์ด๋ ์น์ npx @capgo/cli@latest build credentials migratelegacy ํ๋ก๋น์ ํ๋กํ์ผ์ ์๋ก์ด ๋ค์ค ๋ชฉํ ํ์์ผ๋ก ๋ง์ด๊ทธ๋ ์ด์ ํฉ๋๋ค. BUILD_PROVISION_PROFILE_BASE64์ CAPGO_IOS_PROVISIONING_MAP์ผ๋ก ๋ณํํฉ๋๋ค. Xcode ํ๋ก์ ํธ์์ ์๋์ผ๋ก ๋ฉ์ธ ๋ฒ๋ค ID๋ฅผ ๋ฐ๊ฒฌํฉ๋๋ค. npx @capgo/cli build credentials migrate โplatform ios
์์:
Example:์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โappId | string | ์ฑ ID (์๋์ผ๋ก capacitor.config์์ ์ถ์ถ๋๊ฑฐ๋ ์๋ต ์) |
| โplatform | string | ํ๋ซํผ (ios๋ง ์ง์) |
| โ๋ก์ปฌ | boolean | ๊ธ๋ก๋ฒ ๋์ ๋ก์ปฌ capgo-credentials.json์ผ๋ก ๋ง์ด๊ทธ๋ ์ด์ ํ์ธ์ |