๐น ๋น๋
์ด ํ๋ฌ๊ทธ์ธ์ ์ค์น ๋จ๊ณ์ ์ ์ฒด ๋งํฌ๋ค์ด ๊ฐ์ด๋๋ฅผ ํฌํจํ ์ค์ ํ๋กฌํํธ๋ฅผ ๋ณต์ฌํ์ธ์.
๐๏ธ Capgo Cloud๋ฅผ ํตํด ๋ค์ดํฐ๋ธ iOS/Android ๋น๋๋ฅผ ๊ด๋ฆฌํ์ธ์.
๋น๋ ์ ๊ทผ ๋ฐ ์ถ๋ ฅ
โ๋น๋ ์ ๊ทผ ๋ฐ ์ถ๋ ฅโ์ด๋ผ๋ ์ ๋ชฉ์ ์น์ ๋ค์ดํฐ๋ธ ํด๋ผ์ฐ๋ ๋น๋ ์์ฒญ์ ํ์ฌ ์ ํ๋ ๋ฒ ํ ์ํ์ด๋ฉฐ ์ ๊ทผ์ด ์ ํ๋์ด ์์ต๋๋ค. ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ Capgo ์๋ฒ์ ์ ์ฅ๋์ง ์์ต๋๋ค: ๋น๋๋ง ์ฌ์ฉํ๊ณ ์ญ์ ๋ฉ๋๋ค. ๋น๋ ์ถ๋ ฅ์ ์ต์ ์ผ๋ก ์๊ฐ ์ ํ๋ ๋ค์ด๋ก๋ ๋งํฌ์ ํจ๊ป ์ ๋ก๋ํ ์ ์์ต๋๋ค.
์๊ฒฉ ์ฆ๋ช ์ ์ฅํ๊ธฐ
โ์๊ฒฉ ์ฆ๋ช ์ ์ฅํ๊ธฐโ๋ผ๋ ์ ๋ชฉ์ ์น์ npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCI์์ ์ถ๋ ฅ URL์ ์บก์ฒํ์ธ์
CI ์ถ๋ ฅ URL ์บก์ฒํต๊ณผ --output-record ๋ค์ด๋ก๋ URL๊ณผ QR ์ฝ๋๋ฅผ code๋ก ์ ์ฅํ๊ณ ์ฌ์ฉํ์ธ์ build last-output ๋ค์ด๋ก๋ URL์ ์ฝ๋ ๋ฐฉ๋ฒ
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๐น ํ์ํ ํญ๋ชฉ
ํ์ํ ํญ๋ชฉ ๐น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์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| -a | string | API ํค๋ฅผ ์ฌ์ฉํ์ฌ ๊ณ์ ์ ์ฐ๊ฒฐํฉ๋๋ค. |
| -c | string | CapacitorUpdater.defaultChannel ๋๋ ๊ณต๊ณต ๊ธฐ๋ณธ ์ฑ๋์ ๊ธฐ๋ณธ๊ฐ์ผ๋ก ํ๋ ์ฑ๋์ ๋น๊ตํฉ๋๋ค. |
| โpackage-json | string | ๋ชจ๋ ธ๋ ํฌ์ package.json ํ์ผ ๊ฒฝ๋ก (์ผํ๋ก ๊ตฌ๋ถ) |
| โnode-modules | string | ๋ชจ๋ ธ๋ ํฌ์ node_modules ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (์ผํ๋ก ๊ตฌ๋ถ) |
| โverbose | boolean | ์ธ๋ถ ๋ก๊น ์ ํฌํจํ ์์ธํ ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค. |
| โsupa-host | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| โsupa-anon | string | ์์ฒด ํธ์คํ ์ ์ํ ์ปค์คํ Supabase anon ํค |
๐ Init
๐ InitAlias: onboarding
npx @capgo/cli@latest build initiOS: ์ธ์ฆ์ + ํ๋กํ์ผ ์๋ํ; Android: ํค์คํ ์ด + Google OAuth GCP ์๋น์ค ๊ณ์ ๋ฐ Play ์ฝ์ ์ด๋
Options:
| Param | Type | ์ค๋ช |
|---|---|---|
| -a | string | API ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ํค |
| -p | string | ์จ๋ณด๋ฉํ ํ๋ซํผ (ios ๋๋ android). ์๋ต ์, ํ๋์ ๋ค์ดํฐ๋ธ ํด๋๋ง ์กด์ฌํ ๋ ์๋์ผ๋ก ๊ฐ์ง; ๊ทธ๋ ์ง ์์ผ๋ฉด ํ๋กฌํํธํฉ๋๋ค. |
| โ__CAPGO_KEEP_0__-ํธ์คํธ | string | Capgo ์์ฒด ํธ์คํ ๋๋ ๊ฐ๋ฐ์์ํ ์ฌ์ฉ์ ์ ์ Supabase ํธ์คํธ URL |
| โ__CAPGO_KEEP_0__ ๋ถ์ | boolean | ์ด ์คํ์ ๋ํด ๋น๋ ์จ๋ณด๋ฉ ๋ถ์ ๋ฐ ํฐ๋ฏธ๋ ์ฌ์์ ๋นํ์ฑํํฉ๋๋ค. |
๐น ์์ฒญ
๐น ์์ฒญnpx @capgo/cli@latest build requestCapgo Cloud์์ ์์ ๋น๋๋ฅผ ์์ฒญํฉ๋๋ค. ์ด ๋ช ๋ น์ ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ๋ฅผ ์์ถํ๊ณ 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 .์ค์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| --path | string | ํ๋ก์ ํธ ๋น๋์ ์ฌ์ฉํ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ๊ฐ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| --node-modules | string | ๋ชจ๋ ธ๋ ํฌ์ node_modules ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (์ผํ๋ก ๊ตฌ๋ถ) |
| --platform | string | ๋์ ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โbuild-mode | string | ๋น๋ ๋ชจ๋: ๋๋ฒ๊ทธ ๋๋ ๋ฆด๋ฆฌ์ฆ (๊ธฐ๋ณธ๊ฐ: ๋ฆด๋ฆฌ์ฆ) |
| โbuild-certificate-base64 | string | iOS: Base64๋ก ์ธ์ฝ๋ฉ๋ .p12 ์ธ์ฆ์ |
| โp12-password | string | iOS: ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์ ํ ์ฌํญ) |
| โapple-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ API ํค ๋์ฒด๋ฅผ ์ํ ์ ํ ID ์ด๋ฉ์ผ |
| โapple-app-specific-password | string | iOS: ํ ์คํธ ํ๋ผ์ดํธ ์ ๋ก๋๋ฅผ ์ํ ์ฑ ์คํ์ํฝ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: ์ฑ ์คํ ์ด ์ฐ๊ฒฐ ์ฑ ์์ด๋ (โapple-id์ โapple-app-specific-password์ ํจ๊ป ํ์) |
| โapple-key-id | string | iOS App Store Connect API ID |
| โapple-issuer-id | string | iOS App Store Connect ๋ฐ๊ธ์ ID |
| โapple-key-content | string | iOS App Store Connect API ํค (.p8) Base64 ์ธ์ฝ๋ฉ |
| โapp-store-connect-team-id | string | iOS App Store Connect ํ ID |
| โios-scheme | string | iOS Xcode ๋น๋ ์คํค๋ง (๊ธฐ๋ณธ: App) |
| โios-target | string | iOS Xcode ๋น๋ ์ค์ ์ ์ฝ๊ธฐ ์ํ ๋์ (๊ธฐ๋ณธ: ์คํค๋ง์ ๋์ผ) |
| โiOS ๋ฐฐํฌ ๋ชจ๋ | string | iOS ๋ฐฐํฌ ๋ชจ๋ |
| โiOS ์๋ ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก | string | iOS ์๋ ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path ๋งคํ (๋ฐ๋ณต ๊ฐ๋ฅ) |
| โAndroid ํค์คํ ์ด ํ์ผ | string | Android: Base64-encoded ํค์คํ ์ด ํ์ผ |
| โAndroid ํค์คํ ์ด ํค ๋ณ์นญ | string | Android: ํค์คํ ์ด ํค ๋ณ์นญ |
| โAndroid ํค์คํ ์ด ํค ๋น๋ฐ๋ฒํธ | string | Android: ํค์คํ ์ด ํค ๋น๋ฐ๋ฒํธ |
| โAndroid ํค์คํ ์ด ์ ์ฅ์ ๋น๋ฐ๋ฒํธ | string | Android: ํค์คํ ์ด ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| โplay-config-json | string | ์๋๋ก์ด๋: Google Play ์๋น์ค ๊ณ์ JSON |
| โandroid-flavor | string | ์๋๋ก์ด๋: ์ ํ ํ๋๋ฒ๋ฅผ ๋น๋ํ ๋ (์: ํ๋ก๋์ ). ํ๋ก์ ํธ๊ฐ ์ฌ๋ฌ ํ๋๋ฒ๋ฅผ ๊ฐ์ง ๊ฒฝ์ฐ ํ์. |
| โin-app-update-priority | string | ์๋๋ก์ด๋: Google Play ๋ด ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (0-5; ๋ ๋์ ์์น = ๋ ๊ธ๋ฐ). https://developer.android.com/guide/playcore/in-app-updates. ์ฐ์ ์์: CLI > ํ๊ฒฝ๋ณ์ > ์ ์ฅ๋ ์ธ์ฆ์ |
| โno-playstore-upload | boolean | ์ด ๋น๋์ ๋ํด ์คํ ์ด ์ ๋ก๋๋ฅผ ์๋ต (์ ์ฅ๋ ํ๋ ์ด ๊ตฌ์ฑ null๋ก ์ค์ ). โoutput-upload ํ์. |
| โsubmit-to-store-review | boolean | ์ ๋ก๋ ํ ์คํ ์ด ๋ฆฌ๋ทฐ์ ์ ์ถํ๋ ๋์ , ๋น๋ ์ํ๋ฅผ ๋ฏธ๋ฆฌ๋ณด๊ธฐ/๋นํ์ฑํ๋ก ๋จ๊ฒจ๋๋ค. ์๋๋ก์ด๋๋ ํ๋ ์ด ๋ฆด๋ฆฌ์ฆ๋ฅผ ์๋ฃํ๊ณ , iOS๋ ์ฒ๋ฆฌ๋ ํ ์คํธ ํ๋ผ์ดํธ ๋น๋๋ฅผ ์ฑ ์คํ ์ด ๋ฆฌ๋ทฐ์ ์ ์ถํ๋ค. |
| โ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ์ด๋ฆ | string | ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ์ด๋ฆ/๋ฒ์ ๋ ์ด๋ธ. ์๋๋ก์ด๋๋ ์ด ๊ฐ์ Google Play์ version_name์ผ๋ก ๋ณด๋ ๋๋ค. iOS๋ ํธ์ง ๊ฐ๋ฅํ ๋ฒ์ ์ ๋ง๋ค๊ฑฐ๋ ์ฌ์ฌ์ฉํ ๋ App Store์ ๋ฒ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ | string | ๋ํดํธ ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ. ์๋๋ก์ด๋๋ ์ด ๊ฐ์ Play์ changelog๋ก ์ฌ์ฉํ๊ณ iOS๋ App Store์ fallback Whatโs New ํ ์คํธ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ-๋ก์ผ์ผ | string | ๋ก์ผ์ผํ๋ ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ(๋ฐ๋ณต ๊ฐ๋ฅ), ์๋ฅผ ๋ค์ด โ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ-๋ก์ผ์ผ en-US=โ๋ฒ๊ทธ ์์ โ โ์คํ ์ด ๋ฆด๋ฆฌ์ฆ ๋ ธํธ-๋ก์ผ์ผ fr-FR=โ์์ โ. |
| โiOS ํ ์คํธ ํ๋ผ์ดํธ ๊ทธ๋ฃน | string | iOS: ์ต์ ์ผ๋ก ์ธ๋ถ ๋ฒ ํ ๋ฐฐํฌ๋ฅผ ์ํ ์ธ๋ถ ๊ทธ๋ฃน ์ด๋ฆ ๋๋ ID๋ฅผ ์ผํ๋ก ๊ตฌ๋ถํ์ฌ ์ ๋ ฅํฉ๋๋ค. |
| โiOS ์๋ ๋ฆด๋ฆฌ์ฆ | boolean | iOS: ์ ํ ์น์ธ ํ App Store ๋ฒ์ ์ ์๋์ผ๋ก ๋ฆด๋ฆฌ์ฆํฉ๋๋ค. ๋ํดํธ๋ ์๋ ๋ฆด๋ฆฌ์ฆ์ ๋๋ค. |
| โno-iOS ์๋ ๋ฆด๋ฆฌ์ฆ | boolean | iOS: ์ ํ ์น์ธ ํ App Store ๋ฒ์ ์ ์๋์ผ๋ก ๋ฆด๋ฆฌ์ฆํ๊ธฐ ์ํด ๊ธฐ๋ค๋ฆฝ๋๋ค. |
| โ์ถ๋ ฅ ์ ๋ก๋ | boolean | ์ด ๋น๋๋ง์ ์ํ ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ค๋ฒ๋ผ์ด๋ํฉ๋๋ค. ์ฐ์ ์์: CLI > ํ๊ฒฝ > ์ ์ฅ๋ ์ธ์ฆ์ |
| โ์ถ๋ ฅ ์ ๋ก๋ ๋นํ์ฑํ | boolean | ์ด ๋น๋๋ง์ ์ํ ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ค๋ฒ๋ผ์ด๋ํ์ฌ ๋นํ์ฑํํฉ๋๋ค. ์ฐ์ ์์: CLI > ํ๊ฒฝ > ์ ์ฅ๋ ์ธ์ฆ์ |
| โ์ถ๋ ฅ ๋ณด์กด | string | ์ด ๋น๋๋ง์ ์ํ ์ถ๋ ฅ ๋งํฌ TTL์ ์ค๋ฒ๋ผ์ด๋ํฉ๋๋ค (1์๊ฐ์์ 7์ผ). ์์: 1์๊ฐ, 6์๊ฐ, 2์ผ. ์ฐ์ ์์: CLI > ํ๊ฒฝ > ์ ์ฅ๋ ์ธ์ฆ์ |
| โ์ถ๋ ฅ ๊ธฐ๋ก | string | ์ฑ๊ณต์ ์ธ ๋น๋ ํ, JSON ๊ธฐ๋ก (jobId, ์ํ, ์ถ๋ ฅ URL, qrCodeAscii, qrCodePngPath, ์๋ฃ ์๊ฐ) ์ ๊ฒฝ๋ก์ ๊ธฐ๋กํฉ๋๋ค. PNG QR code๋ ๊ทธ ๊ฒฝ๋ก์ ๋ถ์ด์๋ PNG QR ์ฝ๋์ ํจ๊ป ๊ธฐ๋ก๋ฉ๋๋ค. .qr.png โsuffix build last-output. |
| โ์ถ๋ ฅ ๊ธฐ๋ก ๋นํ์ฑํ | boolean | โ์๋ ๋น๋ ๋ฒํธ ์ฆ๊ฐ๋ฅผ ๋ค์ ํ์ฑํํ๊ธฐ ์ํด ์ ์ฅ๋ ์ธ์ฆ์๋ฅผ ์ค๋ฒ๋ผ์ด๋ํฉ๋๋ค. |
| โ๋น๋ ๋ฒํธ ์ฆ๊ฐ๋ฅผ ์๋ต | boolean | ์๋ ๋ง์ผํ ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ์ฑ์ด ์ด๋ฏธ ์ถ์๋ ๊ฒฝ์ฐ CFBundleShortVersionString / versionName ๋ฒ์ ์ ๋ฐ์ดํธ๋ฅผ ์๋ตํฉ๋๋ค. |
| โiOS ๋ฒ์ ๋๊ธฐํ | boolean | iOS: Xcode MARKETING_VERSION์ package.json์์ ๋๊ธฐํํ๊ณ ํ๋ก์ ํธ๋ฅผ ์ ๋ก๋ํ๊ธฐ ์ ์. |
| โAI ๋ถ์ | boolean | ๋น๋ ์คํจ ์ Capgo AI๋ก ๋ก๊ทธ๋ฅผ ์ ์กํ์ฌ ์ง๋จํฉ๋๋ค. ์ธํฐ๋ํฐ๋ธ ํฐ๋ฏธ๋์์๋ ์ฌ์ ํ์ธ์ ์๋ตํ๊ณ CI์์๋ ์๋ ์ ๋ก๋ ๋ฐ ๋ถ์ ๊ฒฐ๊ณผ๋ฅผ stderr๋ก ์ถ๋ ฅํฉ๋๋ค. |
| โ๋น๋ ์ ์ค์บ ์๋ต | boolean | ์๋ ๋น๋ ์ ์ค์บ์ ์๋ตํฉ๋๋ค. |
| โ๋น๋ ์ ์ค์บ ๋ฌด์ | boolean | ๋น๋ ์ ์ค์บ์ ์คํํ์ง๋ง ๋น๋๋ฅผ ์ฐจ๋จํ์ง ์์ต๋๋ค (๋ณด๊ณ ๋ง ํจ). |
| โํน์ ์ค์บ ์๋ต | string | ํน์ ์ค์บ ์ฒดํฌ๋ฅผ ์๋ตํฉ๋๋ค (๋ฐ๋ณต ๋๋ ์ผํ๋ก ๊ตฌ๋ถ). ๋ค๋ฅธ ์ฒดํฌ๋ ์ฌ์ ํ ์คํ๋ฉ๋๋ค. |
| โ๋น๋ ์ ์ค์บ ๊ฒฝ๊ณ | string | ํน์ prescan ์ฒดํฌ๋ฅผ ๊ฒฝ๊ณ ๋ก ๋ด๋ฆฌ๋ ค๋ฉด id (๋ฐ๋ณต ๋๋ ์ผํ๋ก ๊ตฌ๋ถ)๋ก ์ ๋ ฅํ์ธ์. ์ฒดํฌ๋ ์ฌ์ ํ ์คํ๋ฉ๋๋ค. |
| โfail-on-warnings | boolean | prescan ๊ฒฝ๊ณ ๋ฅผ ์น๋ช ์ ์ธ ๊ฒ์ผ๋ก ์ฒ๋ฆฌํ์ธ์ |
| โsend-logs-to-support | boolean | CI/CD ๋น๋ ์คํจ ์ ์๋์ผ๋ก ๋น๋ ๋ก๊ทธ๋ฅผ Capgo ์ง์์ ์ ๋ก๋ํ์ธ์ (์ด๋ฉ์ผ์ด ํ์ํ์ง ์์ต๋๋ค). Capgo ์ง์์ ์ด๋ฉ์ผ๋ก ์ฐ๋ฝ์ ์ทจํ ๊ฒ์ ๋๋ค. โai-analytics์ ์ถ๊ฐ์ ์ธ ์ต์ ์ ๋๋ค. |
| โsend-logs | boolean | โsend-logs-to-support์ deprecated alias |
| -a | string | API ๊ณ์ ์ ์ฐ๊ฒฐํ๊ธฐ ์ํ ํค |
| โsupa-host | string | Self-hosting ๋๋ Capgo ๊ฐ๋ฐ์ ์ํ Custom Supabase ํธ์คํธ URL |
| โsupa-anon | string | __CAPGO_KEEP_0__ (์์ฒด ํธ์คํ ์ฉ) |
| __CAPGO_KEEP_1__ | boolean | __CAPGO_KEEP_2__ |
๐น __CAPGO_KEEP_3__
๐น __CAPGO_KEEP_3__npx @capgo/cli@latest build sync-ios-version__CAPGO_KEEP_6__
๋ก์ปฌ iOS Xcode MARKETING_VERSION์ package.json์์ Syncํฉ๋๋ค.
npx @capgo/cli@latest build sync-ios-version --path .__CAPGO_KEEP_5__
| Param | Type | ์ค๋ช |
|---|---|---|
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| โcheck | boolean | ์ฒดํฌ๋ง; MARKETING_VERSION์ด ๋๊ธฐํ๋์ง ์์ ๊ฒฝ์ฐ 0์ด ์๋ ๊ฐ์ ๋ฐํ |
๐น Prescan
โ ๐น Prescanโ ์ ๋ชฉnpx @capgo/cli@latest build prescanํ๋ก์ ํธ์ ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช
์์ ํด๋ผ์ฐ๋ ๋น๋๊ฐ ์คํจํ๋ ๋ฌธ์ ๋ฅผ ์ค์บํ๊ณ , ์
๋ก๋ํ๊ธฐ ์ ์ ํ์ธํฉ๋๋ค.
์๊ฒฉ ์ฆ๋ช
(๋ง๋ฃ, ๋น๋ฐ๋ฒํธ, ํ๋กํ pair๋ง), ํ๋ก์ ํธ ์ํ(cap sync, node_modules ๋ ์ด์์), ํ๋ซํผ ๊ตฌ์ฑ์ด ํ์ธ๋ฉ๋๋ค. ์๋์ผ๋ก ๋ด๋ถ์์ ์คํ๋ฉ๋๋ค. build request; ์ด ๋ช
๋ น์ด๋ ๋
๋ฆฝ์ ์ผ๋ก ์คํ๋๋ฉฐ (์: CI์์).
See Prescan ๊ฒ์ฌ ์ ์ฒด ๊ฒ์ฌ ์นดํ๋ก๊ทธ ๋ฐ ๊ฐ๋ณ ๊ท์น์ ๋ํ ๋ฐฉ๋ฒ์ --skip / --warn ๊ฐ๋ณ ๊ท์น.
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โplatform | string | ๋ชฉํ ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| -a | string | API ํค๋ฅผ ์ฌ์ฉํ์ฌ ๊ณ์ ์ ์ฐ๊ฒฐํ์ธ์. |
| โandroid-flavor | string | Android: ๋น๋ํ ์ ํ์ ๋ง์ ์ง์ ํ์ธ์. |
| โios-dist | string | iOS: ์ ํจ์ฑ ๊ฒ์ฌ๋ฅผ ์ํด ์ฌ์ฉํ ๋ฐฐํฌ ๋ชจ๋๋ฅผ ์ง์ ํ์ธ์. |
| โjson | boolean | ๊ธฐ๊ณ๊ฐ ์ฝ์ ์ ์๋ JSON ๋ณด๊ณ ์๋ฅผ ์ถ๋ ฅํ์ธ์. |
| โfail-on-warnings | boolean | ๊ฒฝ๊ณ ๊ฐ ๋ฐ๊ฒฌ๋๋ฉด 0์ด ์๋ ๊ฐ์ ๋ฐํํ์ธ์ (CI) |
| โignore-fatal | boolean | ๋๋ฒ๊ทธ ๋ชจ๋: ํญ์ 0์ ๋ฐํํ์ง๋ง ๋ชจ๋ ๊ฒ์ ๋ณด๊ณ ํ์ธ์. |
| โ์คํต | string | ํน์ ์ฒดํฌ๋ฅผ id (๋ฐ๋ณต ๋๋ ์ผํ๋ก ๊ตฌ๋ถ)์ผ๋ก ์คํตํฉ๋๋ค. |
| โ๊ฒฝ๊ณ | string | ํน์ ์ฒดํฌ๋ฅผ id (๋ฐ๋ณต ๋๋ ์ผํ๋ก ๊ตฌ๋ถ)์ผ๋ก ๊ฒฝ๊ณ ๋ก ๋ค์ด๊ทธ๋ ์ด๋ํฉ๋๋ค. |
| โverbose | boolean | ์์ธ ๋ก๊น ๊ณผ ํจ๊ป ์์ธํ ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค. |
| โsupa-host | string | ์์ฒด ํธ์คํ ๋๋ ๊ฐ๋ฐ์ ์ํด ์ฌ์ฉํ๋ ์ปค์คํ Supabase ํธ์คํธ URL (๊ฐ๋ฐ์ ์ํด Capgo) |
| โsupa-anon | string | ์์ฒด ํธ์คํ ์ ์ํด ์ฌ์ฉํ๋ ์ปค์คํ Supabase anon ํค |
๐น ์ต๊ทผ ์ถ๋ ฅ
์ ๋ชฉ โ ๐น 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
์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| โpath | string | ์ด์ ์ผ๋ก ๊ธฐ๋ก๋ โoutput-record์ JSON ๊ธฐ๋ก์ ๋ํ ๊ฒฝ๋ก (ํ์) |
| โfield | string | ๋จ์ผ field (jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion ์ค ํ๋)๋ฅผ ์ถ๋ ฅ |
| โqr | boolean | ASCII QR ์ฝ๋๋ฅผ ๋ ๋๋งํ์ฌ code (โfield qrCodeAscii์ ๋จ์ถ)์ ์ถ๋ ฅํฉ๋๋ค. |
๐น ์ธ์ฆ ์ ๋ณด
์ธ์ฆ ์ ๋ณด์ธ์ฆ ์ ๋ณด
- Credentials saved to ~/.capgo-credentials/credentials.json (global) or .capgo-credentials.json (local)
- When building, sent to Capgo but NEVER stored permanently
- Deleted from Capgo immediately after build
- ์ธ์ฆ ์ ๋ณด https://capgo.app/docs/cli/cloud-build/ios/ ์ธ์ฆ ์ ๋ณด https://capgo.app/docs/cli/cloud-build/android/
๐น Apple-ํค
๐น Apple-ํค๋ณ์นญ: asc-key
npx @capgo/cli@latest build credentials apple-keyApp Store Connect ํ API ํค๋ฅผ macOS ๋์ฐ๋ฏธ๋ฅผ ์ฌ์ฉํ์ฌ ๊ฐ์ด๋ (macOS ์ ์ฉ)๋ก ์์ฑํฉ๋๋ค. App Store Connect UI์ ๋ด์ฅ ๋ธ๋ผ์ฐ์ ์์ Apple์ UI๋ฅผ walk-through ํด์ฃผ๋ฉฐ Issuer ID + Key ID๋ฅผ ์๋์ผ๋ก ์บก์ฒํ๊ณ , ํ ๋ฒ๋ง ์ฌ์ฉ๋๋ .p8๋ฅผ ์ค๊ฐ์ๆช่ทํ๊ณ , Apple๊ณผ ์ ํจ์ฑ์ ๊ฒ์ฌํ ํ ~/.appstoreconnect/private_keys์ ์ ์ฅํฉ๋๋ค. progress statistics๋ Capgo ๋ถ์ (CAPGO_DISABLE_TELEMETRY๋ก ๋นํ์ฑํ)๋ก ์ ๋ฌ๋ฉ๋๋ค. npx @capgo/cli build credentials apple-key โappId com.example.app
์์:
Example:์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| -a | string | API ํค๋ฅผ ์ฌ์ฉํ์ฌ ๊ณ์ ์ ์ฐ๊ฒฐํ์ธ์ |
| ์ฑ ID | string | iOS ๋น๋ ์ธ์ฆ์์ ์บก์ฒ๋ ํค๋ฅผ ์ ์ฅํ์ธ์ |
| โlocal | boolean | ํ๋ก์ ํธ๋ณ capgo-credentials.json ํ์ผ์ ์ ์ฅํ์ธ์ |
| โjson | boolean | JSON ํ์์ผ๋ก ์บก์ฒ๋ Key ID / Issuer ID / .p8 ๊ฒฝ๋ก๋ฅผ ์ถ๋ ฅํ์ธ์ |
๐น ์ ์ฅ
์ ์ฅnpx @capgo/cli@latest build credentials saveiOS ๋๋ Android์ฉ ๋น๋ ์ธ์ฆ์๋ฅผ ๋ก์ปฌ๋ก ์ ์ฅํ์ธ์. ์ธ์ฆ์๋ ๋ค์ ์์น์ ์ ์ฅ๋ฉ๋๋ค.
- ~/.capgo-credentials/credentials.json (๊ธฐ๋ณธ, ๊ธ๋ก๋ฒ)
- .capgo-credentials.json in project root (with โlocal flag)
โ ๏ธ REQUIRED BEFORE BUILDING: You must save credentials before requesting a build.
๐ These credentials are NEVER stored on Capgo servers permanently.
They are deleted immediately after the build completes.
๐ Setup guides:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
๐ ์ด ์ธ์ฆ์๋ __CAPGO_KEEP_1__ ์๋ฒ์ ์๊ตฌ์ ์ผ๋ก ์ ์ฅ๋์ง ์์ต๋๋ค. https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save โplatform ios
iOS:
https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/ios/
Android:
https://capgo.app/docs/cli/cloud-build/android/
โiOS ๋ฐฐํฌ ํ๋กํ์ผ ./App.mobileprovision
โiOS ๋ฐฐํฌ ํ๋กํ์ผ com.example.widget=./Widget.mobileprovision
npm @capgo/cli build credentials save โplatform android
โkeystore ./release.keystore โkeystore-alias โmy-keyโ
โkeystore-key-password โkey-passโ
โplay-config ./service-account.json Local storage (per-project): npm @capgo/cli build credentials save โlocal โplatform ios โฆ
์์:
iOS Example:์ค์ :
| ๋งค๊ฐ ๋ณ์ | ํ์ | ์ค๋ช |
|---|---|---|
| __CAPGO_KEEP_0__ | string | ์ฑ ID (์: com.example.app) (ํ์) |
| __CAPGO_KEEP_0__ | string | ํ๋ซํผ: ios ๋๋ android (ํ์) |
| __CAPGO_KEEP_0__ | string | iOS: .p12 ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| __CAPGO_KEEP_0__ | string | iOS: ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path (๋ฐ๋ณต ๊ฐ๋ฅ) |
| __CAPGO_KEEP_0__ | string | iOS: ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์ ํ ์ฌํญ) |
| __CAPGO_KEEP_0__ | string | iOS: API App Store Connect ๊ฒฝ๋ก |
| โapple-key-id | string | iOS: App Store Connect API Key ID |
| โapple-issuer-id | string | iOS: App Store Connect Issuer ID |
| โapple-team-id | 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: App-specific password (xxxx-xxxx-xxxx-xxxx) for TestFlight uploads |
| โapple-app-id | string | iOS: Numeric App Store Connect app id (required together with โapple-id and โapple-app-specific-password) |
| โkeystore | string | Android: Keystore ํ์ผ ๊ฒฝ๋ก (.keystore ๋๋ .jks) |
| --keystore-alias | string | Android: Keystore ํค ๋ณ์นญ |
| --keystore-key-password | string | Android: Keystore ํค ๋น๋ฐ๋ฒํธ |
| --keystore-store-password | string | Android: Keystore ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| --play-config | string | ์๋๋ก์ด๋: Play Store ์๋น์ค ๊ณ์ JSON ๊ฒฝ๋ก |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ๋น๋ํ ์ ํ ํ๋๋ฒ (์: ํ๋ก๋์ ). ํ๋ก์ ํธ์ ์ฌ๋ฌ ํ๋๋ฒ๊ฐ ์๋ค๋ฉด ํ์. |
| __CAPGO_KEEP_0__ | string | ์๋๋ก์ด๋: ๋ฏธ๋ ๋ฆด๋ฆฌ์ค์ ๋ํ Google Play ๋ด ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (์ ์ 0โ5; ๋์์๋ก ๋ ๊ธ๋ฐ). ์๋ตํ๋ฉด Play์ ๊ธฐ์กด ๊ฐ์ด ์ ์ง๋ฉ๋๋ค. |
| ๋ก์ปฌ | boolean | capgo-credentials.json์ ํ๋ก์ ํธ ๋ฃจํธ์ ์ ์ฅํ๊ธฐ ๋์ ๊ธ๋ก๋ฒ ~/.capgo-credentials/์ ์ ์ฅํฉ๋๋ค. |
| __CAPGO_KEEP_0__ | boolean | ๋น๋ ์ถ๋ ฅ (IPA/APK/AAB)์ Capgo ์ ์ฅ์์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ๋ฅผ ์ถ๋ ฅํฉ๋๋ค. |
| __CAPGO_KEEP_0__ | boolean | ๋น๋ ์ถ๋ ฅ (IPA/APK/AAB)์ Capgo ์ ์ฅ์์ ์ ๋ก๋ํ์ง ์์ต๋๋ค. |
| __CAPGO_KEEP_0__ | 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 | ์๋ ๋ง์ผํ ๋ฒ์ ์ฆ๊ฐ๋ฅผ ์ฌ ํ์ฑํํฉ๋๋ค (๊ธฐ๋ณธ ๋์). |
๐ ๋ชฉ๋ก
๋ชฉ๋ก ์ ๋ชฉ โ ๐ ๋ชฉ๋กโnpx @capgo/cli@latest build credentials list์ ์ฅ๋ ๋น๋ ์๊ฒฉ ์ฆ๋ช ๋ชฉ๋ก (๋น๋ฐ๋ฒํธ๊ฐ ๊ฐ๋ ค์ง). ํ์ฌ ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช (์ ์ญ ๋ฐ ์ง์ญ ๋ชจ๋)์ ๋ณด์ฌ์ค๋๋ค. ์์: npx @capgo/cli build credentials list # ๋ชจ๋ ์ฑ ๋ชฉ๋ก npx @capgo/cli build credentials list โappId com.example.app # ํน์ ์ฑ ๋ชฉ๋ก
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โ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
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โappId | string | ์ญ์ ํ ์ฑ ID (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ์ฑ ์ญ์ ) |
| โplatform | string | ์ญ์ ํ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ํ๋ซํผ ์ญ์ ) |
| โlocal | boolean | capgo-credentials.json์ ๋์ ํ์ฌ ์ง์ญ์์ ํด๋ฆฌ์ดํ์ธ์. |
๐น ์ ๋ฐ์ดํธ
์ ๋ฐ์ดํธnpx @capgo/cli@latest build credentials update๋ชจ๋ ๋ค์ ์ ๊ณตํ์ง ์๊ณ ํน์ ์ธ์ฆ์๋ง ์ ๋ฐ์ดํธํฉ๋๋ค. ๊ธฐ์กด ์ธ์ฆ์๋ฅผ ์ ๋ฐ์ดํธํ๊ธฐ ์ํด ์ ๊ณตํ๋ ํ๋๋ง ๋ณ๊ฒฝํฉ๋๋ค. ํ๋ซํผ์ ์ ๊ณตํ๋ ์ต์ ์์ ์๋์ผ๋ก ๊ฐ์ง๋ฉ๋๋ค. ์์: npx @capgo/cli build credentials update โios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update โlocal โkeystore ./new-keystore.jks
์ต์ :
| ํ๋ผ๋ฏธํฐ | ํ์ | ์ค๋ช |
|---|---|---|
| โ์ฑID | string | ์ฑ ID (์๋์ผ๋ก capacitor.config์์ ๊ฐ์ง๋๋ฉด ์๋ต) |
| โํ๋ซํผ | string | ํ๋ซํผ: ios ๋๋ android (์ต์ ์์ ์๋ ๊ฐ์ง) |
| โ๋ก์ปฌ | boolean | ์ง์ญ capgo-์ธ์ฆ์.json์ ์ ๋ฐ์ดํธํ๋ ๋์ ์ ์ญ |
| โ์ธ์ฆ์ | string | P12 ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| โios-๋ฐฐํฌ ํ๋กํ์ผ | string | ๋ฐฐํฌ ํ๋กํ์ผ ๊ฒฝ๋ก ๋๋ bundleId=path (๋ฐ๋ณต ๊ฐ๋ฅ, ๊ธฐ๋ณธ์ ์ผ๋ก ์ถ๊ฐ) |
| โios-๋ฐฐํฌ ํ๋กํ์ผ ๋งคํ์ ๋ฎ์ด์ฐ๊ธฐ | boolean | ์ ์ฒด ๋ฐฐํฌ ํ๋กํ์ผ ๋งคํ์ ๋์ ํ์ฌ ๋ณํฉํ๋ ๋์ (๊ธฐ๋ณธ: ๋ณํฉ) |
| โp12-์ํธ | string | P12 ์ธ์ฆ์ ์ํธ |
| โapple-key | string | Path to App Store Connect API key (.p8 file) |
| โapple-key-id | string | App Store Connect API Key ID |
| โ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: ์ ํ ์คํ ์ด ์ฐ๊ฒฐ ์ฑ ์์ด๋ (โapple-id์ โapple-app-specific-password ํจ๊ป ํ์) |
| โios-distribution | string | iOS: ๋ฐฐํฌ ๋ชจ๋ |
| โkeystore | string | Keystore ํ์ผ ๊ฒฝ๋ก (.keystore ๋๋ .jks) |
| โkeystore-alias | string | Keystore ํค ๋ณ์นญ |
| โkeystore-key-password | string | Keystore ํค ๋น๋ฐ๋ฒํธ |
| โkeystore-store-password | string | Keystore ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| โplay-config | string | ๊ตฌ๊ธ ํ๋ ์ด ์๋น์ค ๊ณ์ JSON ํ์ผ ๊ฒฝ๋ก |
| โandroid-flavor | string | Android: ํ๋ก๋์ ๋ฑ ์ฌ๋ฌ ๊ฐ์ง๋ก ๊ตฌ์ฑ๋ ํ๋ก์ ํธ๊ฐ ์๋ค๋ฉด, ๋น๋ํ Android ์ ํ์ ๋ง์ ์ ํํ์ธ์. |
| โin-app-update-priority | string | Android: ๋ฏธ๋ ๋ฆด๋ฆฌ์ค์ ๊ตฌ๊ธ ํ๋ ์ด ์ธ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (0-5; ์ซ์; ์ซ์๊ฐ ๋์์๋ก ๋ ๊ธํฉ๋๋ค). |
| โoutput-upload | boolean | Capgo ์ ์ฅ์์ ๋น๋ ์ถ๋ ฅ๋ฌผ(IPA/APK/AAB)์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ๋ฅผ ์ถ๋ ฅํฉ๋๋ค. |
| โno-output-upload | boolean | Capgo ์ ์ฅ์์ ๋น๋ ์ถ๋ ฅ๋ฌผ(IPA/APK/AAB)์ ์ ๋ก๋ํ์ง ์์ต๋๋ค. |
| โoutput-retention | string | ์ถ๋ ฅ ๋งํฌ TTL: 1์๊ฐ์์ 7์ผ๊น์ง. ์์: 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 | ์๋ ๋ง์ผํ ๋ฒ์ ์ฆ๊ฐ๋ฅผ ์ฌ ํ์ฑํ (๊ธฐ๋ณธ ๋์) |
๐น ๊ด๋ฆฌ
ํฐ๋ฏธ๋ ์ฐฝnpx @capgo/cli@latest build credentials manageInteractively ๊ด๋ฆฌํ ์ ์๋ ์ ์ฅ๋ ๋น๋ ์๊ฒฉ ์ฆ๋ช
๊ด๋ฆฌ.
์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช
ๆต่ง, ๊ตฌ์ฑ๋ ๊ฒ์ ํ์ธ, CI/CD-์ค๋น๋ .env ํ์ผ์ ๋ด๋ณด๋ด๊ฑฐ๋, ํ๋ซํผ์ ์๊ฒฉ ์ฆ๋ช
์ ์ญ์ ํ ์ ์์ต๋๋ค. ๋์ผํ TUI๋ฅผ ์ฌ์ฌ์ฉํฉ๋๋ค. capgo init.
์์:
npx @capgo/cli ๋น๋ ์๊ฒฉ ์ฆ๋ช
๊ด๋ฆฌ
npx @capgo/cli ๋น๋ ์๊ฒฉ ์ฆ๋ช
๊ด๋ฆฌ โappId com.example.app
npx @capgo/cli ๋น๋ ์๊ฒฉ ์ฆ๋ช
๊ด๋ฆฌ โappId com.example.app โplatform ios
npx @capgo/cli ๋น๋ ์๊ฒฉ ์ฆ๋ช
๊ด๋ฆฌ โlocal
์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โappId | string | ๊ด๋ฆฌํ ์ฑ ID (์ ํ ์ฌํญ, ์๋ต ์ ์ ํํ๋๋ก ์ ๋) |
| โplatform | string | ๊ด๋ฆฌํ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ต ์ ์ ํํ๋๋ก ์ ๋) |
| โlocal | boolean | ๋ก์ปฌ .capgo-credentials.json๋ง ๋ธ๋ผ์ฐ์ง |
๐น Migrate
๐น ์ ํnpx @capgo/cli@latest build credentials migrate๊ธฐ์กด์ ๋ฉํฐ-ํ๊ฒ ํ์์ผ๋ก ์ ํํ๋ ๋ฐ ํ์ํ ํ๋ก๋น์ ๋ ํ๋กํ์ผ์ ์๋ก ๋ง๋ญ๋๋ค. BUILD_PROVISION_PROFILE_BASE64์ CAPGO_IOS_PROVISIONING_MAP์ผ๋ก ๋ณํํฉ๋๋ค. Xcode ํ๋ก์ ํธ์์ ์๋์ผ๋ก ๋ฉ์ธ ๋ฒ๋ค ID๋ฅผ ๋ฐ๊ฒฌํฉ๋๋ค. npx @capgo/cli build credentials migrate โplatform ios
์์:
Example:์ต์ :
| Param | Type | ์ค๋ช |
|---|---|---|
| โ์ฑ ์์ด๋ | string | ์ฑ ์์ด๋ (์๋์ผ๋ก capacitor.config์์ ์ถ์ถ๋๋ฉฐ ์๋ต ์ ์๋์ผ๋ก ์ถ์ถ๋จ) |
| โํ๋ซํผ | string | ํ๋ซํผ (ํ์ฌ ios๋ง ์ง์ํจ) |
| โ๋ก์ปฌ | boolean | ๋ก์ปฌ .capgo-credentials.json์์ ๋์ ๋ง์ด๊ทธ๋ ์ด์ |