๐น build
์ด ํ๋ฌ๊ทธ์ธ์ ์ค์น ๋จ๊ณ์ ์ ์ฒด ๋งํฌ๋ค์ด ๊ฐ์ด๋๊ฐ ํฌํจ๋ ์ค์ ํ๋กฌํํธ๋ฅผ ๋ณต์ฌํ์ธ์.
๐๏ธ Capgo Cloud๋ฅผ ํตํด ๋ค์ดํฐ๋ธ iOS/Android ๋น๋๋ฅผ ๊ด๋ฆฌํ์ธ์.
๋น๋ ์ ๊ทผ ๋ฐ ์ถ๋ ฅ
โ๋น๋ ์ก์ธ์ค ๋ฐ ๊ฒฐ๊ณผ๋ฌผโ ์น์ ๋ค์ดํฐ๋ธ ํด๋ผ์ฐ๋ ๋น๋๋ ๋ชจ๋ Capgo ํ๋์์ ์ฌ์ฉํ ์ ์์ต๋๋ค. ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ 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 ์ฝ์ผ๋ ค๋ฉด:
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 Build๊ฐ ํ์ํ ๊ฒฝ์ฐ โ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 | ๋น๊ตํ Channel์ ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ 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 key (์ ํ ํธ์คํ ์ฉ) |
๐ ์ด๊ธฐํ
โ ๐ Initโ ์น์ ๋ณ์นญ: onboarding
npx @capgo/cli@latest build init๋น๋ ์๊ฒฉ ์ฆ๋ช ์ ๋ํํ์ผ๋ก ์ค์ ํฉ๋๋ค (iOS: ์ธ์ฆ์ + ํ๋กํ ์๋ํ, Android: keystore + Google OAuth๋ก GCP ์๋น์ค ๊ณ์ ๋ฐ Play Console ์ด๋ ํ๋ก๋น์ ๋)
์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| -a | string | ๊ณ์ ์ ์ฐ๊ฒฐํ API ํค |
| -p | string | ์จ๋ณด๋ฉํ ํ๋ซํผ(ios ๋๋ android). ์๋ตํ๋ฉด ๋ค์ดํฐ๋ธ ํด๋๊ฐ ํ๋๋ง ์์ ๋ ์๋ ๊ฐ์งํ๊ณ , ๊ทธ๋ ์ง ์์ผ๋ฉด ํ๋กฌํํธ๋ฅผ ํ์ํฉ๋๋ค. |
| โsupa-host | string | ์ปค์คํ Supabase ํธ์คํธ URL (์ ํ ํธ์คํ ๋๋ Capgo ๊ฐ๋ฐ์ฉ) |
| โno-analytics | boolean | ์ด๋ฒ ์คํ์์๋ build onboarding analytics์ terminal replay๋ฅผ ๋นํ์ฑํํฉ๋๋ค. |
๐น ์์ฒญ
โ๐น Requestโ ์น์ npx @capgo/cli@latest build requestCapgo Cloud์์ Native Build๋ฅผ ์์ฒญํฉ๋๋ค. ์ด ๋ช ๋ น์ ํ๋ก์ ํธ ๋๋ ํฐ๋ฆฌ๋ฅผ zip์ผ๋ก ์์ถํด ๋น๋๋ฅผ ์ํด 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 ๋ชจ๋: debug ๋๋ release (๊ธฐ๋ณธ๊ฐ: release) |
| --build-certificate-base64 | string | iOS: Base64๋ก ์ธ์ฝ๋ฉ๋ .p12 ์ธ์ฆ์ |
| โp12-password | string | iOS: ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์๋ต ๊ฐ๋ฅ) |
| โapple-id | string | iOS: ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ ์ ๋ก๋์ฉ Apple ID ์ด๋ฉ์ผ (App Store Connect API ํค ๋์ ) |
| โapple-app-specific-password | string | iOS: TestFlight ์ ๋ก๋๋ฅผ ์ํ ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: App Store Connect ์ซ์ ์ฑ ID (โapple-id ๋ฐ โapple-app-specific-password์ ํจ๊ป ํ์) |
| โapple-key-id | string | iOS: App Store Connect API ํค ID |
| โapple-issuer-id | string | iOS: App Store Connect Issuer ID |
| โapple-key-content | string | iOS: Base64๋ก ์ธ์ฝ๋ฉ๋ App Store Connect API ํค (.p8) |
| โapp-store-connect-team-id | string | iOS: App Store Connect ํ ID |
| โios-scheme | string | iOS: ๋น๋ํ Xcode scheme (๊ธฐ๋ณธ๊ฐ: App) |
| โios-target | string | iOS: ๋น๋ ์ค์ ์ ์ฝ์ด์ฌ Xcode target (๊ธฐ๋ณธ๊ฐ: scheme๊ณผ ๋์ผ) |
| โxcode-version | string | iOS: ์ง์ ํ Xcode ๋ฒ์ ์ด ์ค์น๋ ๋จธ์ ์์ ๋น๋ (์: 26, 26.0.1, 27). ๋ฉ์ด์ ๋ฒ์ ๋ง ์ง์ ํ๋ฉด ๋ง์ด๋ ๋ฒ์ ์ ์๋ฌด๊ฑฐ๋ ํ์ฉ. ๊ธฐ๋ณธ๊ฐ: ์๋ฌด ๋จธ์ . ์ฐ์ ์์: CLI > ํ๊ฒฝ ๋ณ์ (CAPGO_IOS_XCODE_VERSION) > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โios-distribution | string | iOS: ๋ฐฐํฌ ๋ชจ๋ |
| โios-provisioning-profile | string | iOS: Provisioning profile ๊ฒฝ๋ก ๋๋ bundleId=path ๋งคํ (๋ฐ๋ณต ๊ฐ๋ฅ) |
| โandroid-keystore-file | string | Android: Base64๋ก ์ธ์ฝ๋ฉ๋ keystore ํ์ผ |
| โkeystore-key-alias | string | Android: Keystore ํค ๋ณ์นญ(alias) |
| --keystore-key-password | string | Android: Keystore ํค ๋น๋ฐ๋ฒํธ |
| --keystore-store-password | string | Android: Keystore ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| โplay-config-json | string | Android: Base64๋ก ์ธ์ฝ๋ฉ๋ Google Play ์๋น์ค ๊ณ์ JSON |
| --android-flavor | string | Android: ๋น๋ํ Product flavor (์: production). ํ๋ก์ ํธ์ ์ฌ๋ฌ flavor๊ฐ ์๋ ๊ฒฝ์ฐ ํ์์ ๋๋ค. |
| โandroid-track | string | Android: ์ด ์ ๋ก๋์ ์ฌ์ฉํ Google Play ํธ๋ (internal, alpha, beta, production). โsubmit-to-store-review ์์ด ๊ธฐ๋ณธ๊ฐ: internal. โsubmit-to-store-review๊ฐ ์๊ณ ํธ๋ ๋ฏธ์ค์ ์: production. ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โandroid-release-status | string | Android: Google Play ๋ฆด๋ฆฌ์ค ์ํ (draft, completed, inProgress, halted). โsubmit-to-store-review์์ด ๊ธฐ๋ณธ๊ฐ: draft. โsubmit-to-store-review๊ฐ ์๊ณ ์ํ ๋ฏธ์ค์ ์: completed. ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| --in-app-update-priority | string | Android: ์ด ๋ฆด๋ฆฌ์ค์ ์ฌ์ฉํ Google Play ์ธ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (์ ์ 0โ5; ๋์์๋ก ๊ธด๊ธํจ). ์ฐธ๊ณ https://developer.android.com/guide/playcore/in-app-updates. ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โno-playstore-upload | boolean | ์ด ๋น๋์์ Play Store ์ ๋ก๋๋ฅผ ๊ฑด๋๋๋๋ค(์ ์ฅ๋ play ์ค์ ์ null๋ก ์ค์ ). โoutput-upload๊ฐ ํ์ํฉ๋๋ค. |
| โsubmit-to-store-review | boolean | ์ ๋ก๋ ํ draft/inactive ๋น๋๋ก ๋จ๊ฒจ๋์ง ์๊ณ ์คํ ์ด ๋ฆด๋ฆฌ์ค๋ฅผ ๊ฒํ ์ ์ ์ถํฉ๋๋ค. Android์ ๊ฒฝ์ฐ ๊ธฐ๋ณธ์ ์ผ๋ก release_status๊ฐ completed์ธ production track์ผ๋ก ์ค์ ๋ฉ๋๋ค(โandroid-track / PLAY_STORE_TRACK ๋ฐ โandroid-release-status / PLAY_STORE_RELEASE_STATUS๋ก ์ค๋ฒ๋ผ์ด๋ ๊ฐ๋ฅ). iOS์ ๊ฒฝ์ฐ ์ฒ๋ฆฌ๋ TestFlight ๋น๋๋ฅผ App Store ๊ฒํ ์ ์ ์ถํฉ๋๋ค. |
| โstore-release-name | string | ์คํ ์ด ๋ฆด๋ฆฌ์ค ์ด๋ฆ/๋ฒ์ ๋ผ๋ฒจ. Android๋ ์ด๋ฅผ Google Play version_name์ผ๋ก ์ ์กํ๋ฉฐ, iOS๋ ํธ์ง ๊ฐ๋ฅํ ๋ฒ์ ์ ์์ฑํ๊ฑฐ๋ ์ฌ์ฌ์ฉํ ๋ App Store ๋ฒ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โstore-release-notes | string | ๊ธฐ๋ณธ ์คํ ์ด ๋ฆด๋ฆฌ์ค ๋ ธํธ. Android๋ ์ด๋ฅผ Play changelog๋ก, iOS๋ App Store Whatโs New ํ ์คํธ์ ํด๋ฐฑ์ผ๋ก ์ฌ์ฉํฉ๋๋ค. |
| โstore-release-notes-locale | string | ๋ก์ปฌ๋ผ์ด์ฆ๋ ์คํ ์ด ๋ฆด๋ฆฌ์ค ๋ ธํธ(๋ฐ๋ณต ๊ฐ๋ฅ), ์: โstore-release-notes-locale en-US="Bug fixes" โstore-release-notes-locale fr-FR="Corrections". |
| โios-testflight-groups | string | iOS: ์ธ๋ถ ๋ฒ ํ ๋ฐฐํฌ๋ฅผ ์ํ ์ ํ์ ์ผํ๋ก ๊ตฌ๋ถ๋ TestFlight ์ธ๋ถ ๊ทธ๋ฃน ์ด๋ฆ ๋๋ ID. |
| โios-automatic-release | boolean | iOS: Apple ์น์ธ ํ App Store ๋ฒ์ ์ ์๋์ผ๋ก ๋ฆด๋ฆฌ์คํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ ์๋ ๋ฆด๋ฆฌ์ค์ ๋๋ค. |
| โno-ios-automatic-release | boolean | iOS: Apple ์น์ธ ํ App Store ๋ฒ์ ์ ์๋ ๋ฆด๋ฆฌ์ค ๋๊ธฐ ์ํ๋ก ์ ์งํฉ๋๋ค. |
| โoutput-upload | boolean | ์ด ๋น๋์๋ง ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ฌ์ ์ํฉ๋๋ค(ํ์ฑํ). ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โno-output-upload | boolean | ์ด ๋น๋์๋ง ์ถ๋ ฅ ์ ๋ก๋ ๋์์ ์ฌ์ ์ํฉ๋๋ค(๋นํ์ฑํ). ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โoutput-retention | string | ์ด ๋น๋์๋ง ์ถ๋ ฅ ๋งํฌ TTL์ ์ฌ์ ์ํฉ๋๋ค(1h~7d). ์: 1h, 6h, 2d. ์ฐ์ ์์: CLI > env > ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช |
| โoutput-record | string | ๋น๋๊ฐ ์ฑ๊ณตํ๋ฉด JSON ๋ ์ฝ๋(jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)๋ฅผ ๊ฒฝ๋ก์ ๊ธฐ๋กํฉ๋๋ค. ํด๋น ๊ฒฝ๋ก ์์ PNG QR code๋ ๊ธฐ๋ก๋ฉ๋๋ค. .qr.png ์ ๋ฏธ์ฌ. ํ๋๋ฅผ ๋ค์ ์ฝ์ผ๋ ค๋ฉด build last-output. |
| โno-cache | boolean | ๋น๋ ์บ์ ๋ณต์ ๊ฑด๋๋ฐ๊ธฐ ๋ฐ ์ด๋ฒ ๋น๋์ ๋ํ ์๋ก์ด ์บ์ ํญ๋ชฉ์ ์ ์ฅํ์ง ์์ต๋๋ค. ๋น๋ ์บ์๋ ์ฑ๋ณ๋ก ๊ธฐ๋ณธ ํ์ฑํ๋์ด ์์ต๋๋ค. |
| --cache-key | string | ํ๊ฒฝ, ๋ธ๋์น ๋๋ Android flavor๋ณ๋ก ๋น๋ ์บ์๋ฅผ ๋ถํ ํฉ๋๋ค (์: prod, staging). ์ฑ๋น ํ๋์ ๊ณต์ฉ ๊ธฐ๋ณธ ์บ์๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ์๋ตํ์ธ์. |
| --no-skip-build-number-bump | boolean | ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช ์ ๋ฌด์ํ๊ณ ์ด๋ฒ ๋น๋์ ๋ํด์๋ง ๋น๋ ๋ฒํธ ์๋ ์ฆ๊ฐ๋ฅผ ๋ค์ ํ์ฑํํฉ๋๋ค. |
| --skip-marketing-version-bump | boolean | ์ฑ์ด ์ด๋ฏธ ์ถ์๋ ๊ฒฝ์ฐ ๋ง์ผํ ๋ฒ์ (CFBundleShortVersionString / versionName)์ ์๋ ์ฆ๊ฐ๋ฅผ ๊ฑด๋๋๋๋ค. |
| --sync-ios-version | boolean | iOS: ํ๋ก์ ํธ๋ฅผ ์ ๋ก๋ํ๊ธฐ ์ ์ package.json์์ Xcode MARKETING_VERSION์ ๋๊ธฐํํฉ๋๋ค. |
| โai-analytics | boolean | ๋น๋ ์คํจ ์ ์ง๋จ์ ์ํด ๋ก๊ทธ๋ฅผ Capgo AI๋ก ์ ์กํฉ๋๋ค. ๋ํํ ํฐ๋ฏธ๋์์๋ ์ฌ์ ํ์ธ์ ๊ฑด๋๋ฐ๊ณ , CI์์๋ ์๋ ์ ๋ก๋ํ ๋ค ๋ถ์ ๊ฒฐ๊ณผ๋ฅผ stderr์ ์ถ๋ ฅํฉ๋๋ค. |
| โno-prescan | boolean | ์๋ pre-build ์ค์บ์ ๊ฑด๋๋๋๋ค. |
| โprescan-ignore-fatal | boolean | pre-build ์ค์บ์ ์คํํ๋ ๋น๋๋ ์ ๋ ์ค๋จํ์ง ์์ต๋๋ค(๋ณด๊ณ ๋ง). |
| โprescan-skip | string | ID๋ก ํน์ prescan ์ฒดํฌ๋ฅผ ๊ฑด๋๋๋๋ค(๋ฐ๋ณต ์ง์ ๋๋ ์ผํ ๊ตฌ๋ถ ๊ฐ๋ฅ). ๋ค๋ฅธ ์ฒดํฌ๋ ๊ณ์ ์คํ๋ฉ๋๋ค. |
| โprescan-warn | string | ID๋ก ํน์ prescan ์ฒดํฌ๋ฅผ ๊ฒฝ๊ณ ๋ก ๋ฎ์ถฅ๋๋ค(๋ฐ๋ณต ์ง์ ๋๋ ์ผํ ๊ตฌ๋ถ ๊ฐ๋ฅ). ์ฒดํฌ๋ ๊ณ์ ์คํ๋ฉ๋๋ค. |
| โfail-on-warnings | boolean | prescan ๊ฒฝ๊ณ ๋ฅผ fatal๋ก ์ฒ๋ฆฌํฉ๋๋ค. |
| โsend-logs-to-support | boolean | CI/CD ๋น๋ ์คํจ ์ ๋น๋ ๋ก๊ทธ๋ฅผ Capgo ์ง์ํ์ ์๋์ผ๋ก ์ ๋ก๋ํฉ๋๋ค(์ด๋ฉ์ผ ๋ถํ์). Capgo ์ง์ํ์ด ์๋ฆผ์ ๋ฐ๊ณ ์ด๋ฉ์ผ๋ก ํ์ ์๋ด๋ฅผ ๋๋ฆฝ๋๋ค. โai-analytics์ ํจ๊ป ์ฌ์ฉํ ์ ์์ต๋๋ค. |
| โsend-logs | boolean | โsend-logs-to-support์ ๋ ์ด์ ์ฌ์ฉ๋์ง ์๋ ๋ณ์นญ |
| -a | string | ๊ณ์ ์ ์ฐ๊ฒฐํ API ํค |
| โsupa-host | string | ์ปค์คํ Supabase ํธ์คํธ URL (์ ํ ํธ์คํ ๋๋ Capgo ๊ฐ๋ฐ์ฉ) |
| โsupa-anon | string | ์ปค์คํ Supabase anon key (์ ํ ํธ์คํ ์ฉ) |
| โverbose | boolean | ์์ธ ๋ก๊ทธ๊ฐ ํฌํจ๋ verbose ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค |
๋น๋ ์บ์: ๊ธฐ๋ณธ์ ์ผ๋ก Capgo๋ ์ฑ๋ณ๋ก ์ปดํ์ผ๋ ๋ค์ดํฐ๋ธ ์ํฐํฉํธ(CocoaPods, Gradle ๋ฐ ๊ด๋ จ ์ฐ์ถ๋ฌผ)๋ฅผ ๋ณต์ํ๊ณ ์ ์ฅํฉ๋๋ค. RC์ ํ๋ก๋์
์บ์๋ฅผ ๋ถ๋ฆฌํ๋ ค๋ฉด --cache-key ๋ฅผ ์ฌ์ฉํ๊ณ , ์ผํ์ฑ ํด๋ฆฐ ๋น๋๋ฅผ ํ๋ ค๋ฉด --no-cache ๋ฅผ ์ฌ์ฉํ์ธ์. API ํตํฉ ๊ธฐ๋ฅ์ ํตํด ๋น๋ ์์ฒญ ํ์ด๋ก๋์ cache_key ๋๋ cache_enabled: false ๋ฅผ ์ ๋ฌํ ์ ์์ต๋๋ค. ์์ธํ ๋ด์ฉ์ ๋น๋ ์บ์ ๋ฐ ๋ฌธ์ ํด๊ฒฐ: ์๋ชป๋ ์บ์ ๋ณต๊ตฌ.
๐น Sync-ios-version
โ ๐น Sync-ios-versionโ ์ ๋ชฉ์ ์น์ npx @capgo/cli@latest build sync-ios-versionpackage.json์ ๋ก์ปฌ iOS Xcode MARKETING_VERSION์ ๋๊ธฐํํฉ๋๋ค.
์์:
npx @capgo/cli@latest build sync-ios-version --path .์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ๊ฐ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| โํ์ธ | boolean | ์ฒดํฌ ์ ์ฉ; MARKETING_VERSION์ด ์ผ์นํ์ง ์์ผ๋ฉด non-zero๋ก ์ข ๋ฃ |
๐น Prescan
โ ๐น Prescanโ ์น์ npx @capgo/cli@latest build prescan์
๋ก๋ ์ , ํด๋ผ์ฐ๋ ๋น๋ ์คํจ๋ฅผ ์ ๋ฐํ ์ ์๋ ํ๋ก์ ํธ ๋ฐ ์ ์ฅ๋ ์๊ฒฉ ์ฆ๋ช
์ ๋ฌธ์ ๋ฅผ ๋ฏธ๋ฆฌ ์ค์บํฉ๋๋ค.
์๊ฒฉ ์ฆ๋ช
(๋ง๋ฃ, ๋น๋ฐ๋ฒํธ, ํ๋กํ ํ์ด๋ง), ํ๋ก์ ํธ ์ํ(cap sync, node_modules ๊ตฌ์กฐ), ํ๋ซํผ ์ค์ ์ ํ์ธํฉ๋๋ค. ๋ค์์์ ์๋์ผ๋ก ์คํ๋ฉ๋๋ค: build request; ์ด ๋ช
๋ น์ด๋ฅผ ์ฌ์ฉํ๋ฉด (CI ๋ฑ์์) ๋จ๋
์ผ๋ก ์คํํ ์ ์์ต๋๋ค.
์์ธํ ๋ด์ฉ์ Prescan ๊ฒ์ฌ ์ ์ฒด ์ฒดํฌ ์นดํ๋ก๊ทธ์ ๊ฐ๋ณ ๊ท์น์ --skip / --warn ํ์ธํ๋ ๋ฐฉ๋ฒ์ ์ฐธ์กฐํ์ธ์.
์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โplatform | string | ๋์ ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โpath | string | ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ ๊ฒฝ๋ก (๊ธฐ๋ณธ๊ฐ: ํ์ฌ ๋๋ ํ ๋ฆฌ) |
| -a | string | ๊ณ์ ์ ์ฐ๊ฒฐํ API ํค |
| --android-flavor | string | Android: ๋น๋์ ์ฌ์ฉํ product flavor |
| โios-dist | string | iOS: ๊ฒ์ฆํ distribution mode |
| โjson | boolean | ๊ธฐ๊ณ ํ๋ ๊ฐ๋ฅํ JSON ๋ฆฌํฌํธ ์ถ๋ ฅ |
| โfail-on-warnings | boolean | ๊ฒฝ๊ณ ๊ฐ ์์ผ๋ฉด 0์ด ์๋ ๊ฐ์ผ๋ก ์ข ๋ฃ (CI) |
| โignore-fatal | boolean | ์ง๋จ ๋ชจ๋: ๋ชจ๋ ํญ๋ชฉ ๋ณด๊ณ ํ๋ ํญ์ 0์ผ๋ก ์ข ๋ฃ |
| โskip | string | ID๋ก ํน์ ์ฒดํฌ ํญ๋ชฉ ์คํต (๋ฐ๋ณต ๊ฐ๋ฅ ๋๋ ์ผํ ๊ตฌ๋ถ) |
| โwarn | string | ID๋ก ํน์ ์ฒดํฌ ํญ๋ชฉ์ ๊ฒฝ๊ณ ๋ก ๊ฐ๋ฑ (๋ฐ๋ณต ๊ฐ๋ฅ ๋๋ ์ผํ ๊ตฌ๋ถ) |
| โverbose | boolean | ์์ธ ๋ก๊ทธ๊ฐ ํฌํจ๋ verbose ์ถ๋ ฅ์ ํ์ฑํํฉ๋๋ค |
| โsupa-host | string | ์ปค์คํ Supabase ํธ์คํธ URL (์ ํ ํธ์คํ ๋๋ Capgo ๊ฐ๋ฐ์ฉ) |
| โsupa-anon | string | ์ปค์คํ Supabase anon key (์ ํ ํธ์คํ ์ฉ) |
๐น Last-output
โ ๐น Last-outputโ ์น์ npx @capgo/cli@latest build last-output์ด์ ์ ์์ฑ๋ ๋น๋ ์ถ๋ ฅ ๊ธฐ๋ก์ ์ฝ์ต๋๋ค build request --output-record.
๊ธฐ๋ณธ์ ์ผ๋ก ์ ์ฒด JSON์ ์ถ๋ ฅํ๊ณ , โfield๋ฅผ ์ฌ์ฉํ๋ฉด ๋จ์ผ ํ๋๋ฅผ, code๋ฅผ โqr๋ก ์ถ๋ ฅํฉ๋๋ค. CI์์ ๋ค์ด๋ก๋ URL์ด๋ QR์ ๊ฐ์ ธ์ PR์ด๋ ์ด์์ ๊ฒ์ํ๋ ๋ฐ ์ ์ฉํฉ๋๋ค.
์:
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 | ๋จ์ผ ํ๋ ์ถ๋ ฅ (jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion ์ค ํ๋) |
| โqr | boolean | ๋ ๋๋ง๋ ASCII QR code ์ถ๋ ฅ (โfield qrCodeAscii์ ๋จ์ถํค) |
๐น ์ธ์ฆ ์ ๋ณด
โ ๐น Credentialsโ ์น์ ๋ก์ปฌ ๋จธ์ ์ ์ ์ฅ๋ ๋น๋ ์๊ฒฉ ์ฆ๋ช ์ ๊ด๋ฆฌํฉ๋๋ค. ๐ ๋ณด์:
- ์๊ฒฉ ์ฆ๋ช ์ด ~/.capgo-credentials/credentials.json(์ ์ญ) ๋๋ .capgo-credentials.json(๋ก์ปฌ)์ ์ ์ฅ๋ฉ๋๋ค
- ๋น๋ ์ Capgo์ ์ ์ก๋์ง๋ง ์๊ตฌ์ ์ผ๋ก ์ ์ฅ๋์ง ์์ต๋๋ค
- ๋น๋ ์งํ Capgo์์ ์ญ์ ๋ฉ๋๋ค
- ๋น๋ ์ฐ์ถ๋ฌผ์ ์ ํ์ ์ผ๋ก ์ ๋ก๋ํ์ฌ ์๊ฐ ์ ํ ๋ค์ด๋ก๋ ๋งํฌ๋ฅผ ์์ฑํ ์ ์์ต๋๋ค ๐ ๋ฌธ์: iOS ์ค์ : https://capgo.app/docs/cli/cloud-build/ios/ Android ์ค์ : https://capgo.app/docs/cli/cloud-build/android/
๐น Apple-key
โ ๐น Apple-keyโ ์น์ ๋ณ์นญ: asc-key
npx @capgo/cli@latest build credentials apple-key๊ฐ์ด๋ํ macOS ํฌํผ๋ฅผ ์ฌ์ฉํ์ฌ App Store Connect ํ API ํค๋ฅผ ์์ฑํฉ๋๋ค (macOS ์ ์ฉ). ๋ค์ดํฐ๋ธ ์ฐฝ์ ์ด์ด Apple์ App Store Connect UI๋ฅผ ๋ด์ฅ ๋ธ๋ผ์ฐ์ ์์ ์๋ดํ๋ฉฐ, Issuer ID + Key ID๋ฅผ ์๋ ์บก์ฒํ๊ณ ์ผํ์ฉ .p8์ ๊ฐ๋ก์ฑ Apple์์ ๊ฒ์ฆํ ํ ~/.appstoreconnect/private_keys์ ์ ์ฅํฉ๋๋ค. ์งํ ํต๊ณ๋ Capgo ๋ถ์์ผ๋ก ์ ์ก๋ฉ๋๋ค (CAPGO_DISABLE_TELEMETRY๋ก ๋นํ์ฑํ ๊ฐ๋ฅ). npx @capgo/cli build credentials apple-key โappId com.example.app
์์:
Example:์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| -a | string | ๊ณ์ ์ ์ฐ๊ฒฐํ API ํค |
| โappId | string | ์บก์ฒํ ํค๋ฅผ ์ด ์ฑ์ iOS build credentials์ ์ ์ฅํฉ๋๋ค |
| โlocal | boolean | ์ ์ญ ํ์ผ ๋์ ํ๋ก์ ํธ๋ณ .capgo-credentials.json์ ์ ์ฅ |
| โjson | boolean | ์บก์ฒํ Key ID / Issuer ID / .p8 ๊ฒฝ๋ก๋ฅผ JSON์ผ๋ก ์ถ๋ ฅ |
๐น ์ ์ฅ
โ ๐น Saveโ ์น์ 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/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save โplatform ios
โcertificate ./cert.p12 โp12-password โpasswordโ
โios-provisioning-profile ./profile.mobileprovision
โapple-key ./AuthKey.p8 โapple-key-id โKEY123โ
โapple-issuer-id โissuer-uuidโ โapple-team-id โteam-idโ ๋ฉํฐ ํ๊ฒ ์์ (์ฑ + ์์ ฏ ์ต์คํ ์ ): npx @capgo/cli build credentials save โplatform ios
โios-provisioning-profile ./App.mobileprovision
โios-provisioning-profile com.example.widget=./Widget.mobileprovision
โฆ npx @capgo/cli build credentials save โ Android ํ๋ซํผ
โkeystore ./release.keystore โkeystore-alias โmy-keyโ
โkeystore-key-password โkey-passโ
โplay-config ./service-account.json ๋ก์ปฌ ์คํ ๋ฆฌ์ง (ํ๋ก์ ํธ๋ณ): npx @capgo/cli build credentials save โlocal โplatform ios โฆ
์์:
iOS Example:์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โappId | string | App ID (์: com.example.app) (ํ์) |
| โplatform | string | ํ๋ซํผ: ios ๋๋ android (ํ์) |
| โcertificate | string | iOS: .p12 ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| โios-provisioning-profile | string | iOS: ํ๋ก๋น์ ๋ ํ๋กํ ๊ฒฝ๋ก ๋๋ bundleId=path (์ค๋ณต ์ฌ์ฉ ๊ฐ๋ฅ) |
| โp12-password | string | iOS: ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ (์ธ์ฆ์์ ๋น๋ฐ๋ฒํธ๊ฐ ์์ผ๋ฉด ์๋ต ๊ฐ๋ฅ) |
| โapple-key | string | iOS: .p8 App Store Connect API ํค ๊ฒฝ๋ก |
| โapple-key-id | string | iOS: App Store Connect API ํค 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: ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ ์ ๋ก๋์ฉ Apple ID ์ด๋ฉ์ผ (App Store Connect API ํค ๋์ ) |
| โapple-app-specific-password | string | iOS: TestFlight ์ ๋ก๋๋ฅผ ์ํ ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: App Store Connect ์ซ์ ์ฑ ID (โapple-id ๋ฐ โapple-app-specific-password์ ํจ๊ป ํ์) |
| โkeystore | string | Android: keystore ํ์ผ ๊ฒฝ๋ก (.keystore ๋๋ .jks) |
| --keystore-alias | string | Android: Keystore ํค ๋ณ์นญ(alias) |
| --keystore-key-password | string | Android: Keystore ํค ๋น๋ฐ๋ฒํธ |
| --keystore-store-password | string | Android: Keystore ์ ์ฅ์ ๋น๋ฐ๋ฒํธ |
| --play-config | string | Android: Play Store ์๋น์ค ๊ณ์ JSON ๊ฒฝ๋ก |
| --android-flavor | string | Android: ๋น๋ํ Product flavor (์: production). ํ๋ก์ ํธ์ ์ฌ๋ฌ flavor๊ฐ ์๋ ๊ฒฝ์ฐ ํ์์ ๋๋ค. |
| --in-app-update-priority | string | Android: ํฅํ ๋ฆด๋ฆฌ์ค๋ฅผ ์ํ Google Play ์ธ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (์ ์ 0โ5; ๋์์๋ก ๋ ๊ธด๊ธ). ์๋ตํ๋ฉด Play์ ๊ธฐ์กด ๊ฐ์ด ๊ทธ๋๋ก ์ ์ง๋ฉ๋๋ค. |
| โlocal | boolean | ์ ์ญ ~/.capgo-credentials/ ๋์ ํ๋ก์ ํธ ๋ฃจํธ์ .capgo-credentials.json์ ์ ์ฅ |
| โoutput-upload | boolean | ๋น๋ ๊ฒฐ๊ณผ๋ฌผ(IPA/APK/AAB)์ Capgo ์คํ ๋ฆฌ์ง์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ ์ถ๋ ฅ |
| โno-output-upload | boolean | ๋น๋ ๊ฒฐ๊ณผ๋ฌผ(IPA/APK/AAB)์ Capgo ์คํ ๋ฆฌ์ง์ ์ ๋ก๋ํ์ง ์์ |
| โoutput-retention | string | ์ถ๋ ฅ ๋งํฌ TTL: 1h~7d (๊ธฐ๋ณธ๊ฐ: 1h). ์: 1h, 6h, 2d |
| โ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 | ๋ชฉ๋ก์ ํ์ํ App ID (์๋ต ์ ์ ์ฒด ๋ชฉ๋ก ํ์) |
| โlocal | boolean | ๋ก์ปฌ .capgo-credentials.json ํ์ผ์ ์๊ฒฉ ์ฆ๋ช ๋ง ๋ชฉ๋ก์ ํ์ |
๐น ์ง์ฐ๊ธฐ
โ ๐น 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 | ์ง์ธ App ID (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ์ฑ ์ญ์ ) |
| โplatform | string | ์ง์ธ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ต ์ ๋ชจ๋ ํ๋ซํผ ์ญ์ ) |
| โlocal | boolean | global ๋์ ๋ก์ปฌ .capgo-credentials.json์์ ์ญ์ |
๐น ์ ๋ฐ์ดํธ
โ ๐น Updateโ ์น์ 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
์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โappId | string | App ID (์๋ต ์ capacitor.config์์ ์๋ ๊ฐ์ง) |
| โplatform | string | Platform: ios ๋๋ android (์ต์ ์์ ์๋ ๊ฐ์ง) |
| โlocal | boolean | ๊ธ๋ก๋ฒ ๋์ ๋ก์ปฌ .capgo-credentials.json ์ ๋ฐ์ดํธ |
| โcertificate | string | P12 ์ธ์ฆ์ ํ์ผ ๊ฒฝ๋ก |
| โios-provisioning-profile | string | Provisioning profile ๊ฒฝ๋ก ๋๋ bundleId=path (๋ฐ๋ณต ๊ฐ๋ฅ, ๊ธฐ๋ณธ๊ฐ์ ๋ณํฉ) |
| โoverwrite-ios-provisioning-map | boolean | ๊ธฐ์กด ํ๋ก๋น์ ๋ ๋งต์ ๋ณํฉํ์ง ์๊ณ ์ ์ฒด ๊ต์ฒด (๊ธฐ๋ณธ๊ฐ: ๋ณํฉ) |
| โp12-password | string | P12 ์ธ์ฆ์ ๋น๋ฐ๋ฒํธ |
| โapple-key | string | App Store Connect API ํค ๊ฒฝ๋ก (.p8 ํ์ผ) |
| โapple-key-id | string | App Store Connect API ํค ID |
| โapple-issuer-id | string | App Store Connect Issuer ID |
| โapple-team-id | string | App Store Connect ํ ID |
| โapple-id | string | iOS: ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ ์ ๋ก๋์ฉ Apple ID ์ด๋ฉ์ผ (App Store Connect API ํค ๋์ ) |
| โapple-app-specific-password | string | iOS: TestFlight ์ ๋ก๋๋ฅผ ์ํ ์ฑ ์ ์ฉ ๋น๋ฐ๋ฒํธ (xxxx-xxxx-xxxx-xxxx) |
| โapple-app-id | string | iOS: App Store Connect ์ซ์ ์ฑ ID (โ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 | Google Play ์๋น์ค ๊ณ์ JSON ๊ฒฝ๋ก |
| --android-flavor | string | Android: ๋น๋ํ Product flavor (์: production). ํ๋ก์ ํธ์ ์ฌ๋ฌ flavor๊ฐ ์๋ ๊ฒฝ์ฐ ํ์์ ๋๋ค. |
| --in-app-update-priority | string | Android: ํฅํ ๋ฆด๋ฆฌ์ค๋ฅผ ์ํ Google Play ์ธ์ฑ ์ ๋ฐ์ดํธ ์ฐ์ ์์ (์ ์ 0โ5; ๋์์๋ก ๊ธด๊ธํจ). |
| โoutput-upload | boolean | ๋น๋ ๊ฒฐ๊ณผ๋ฌผ(IPA/APK/AAB)์ Capgo ์คํ ๋ฆฌ์ง์ ์ ๋ก๋ํ๊ณ ๋ค์ด๋ก๋ ๋งํฌ ์ถ๋ ฅ |
| โno-output-upload | boolean | ๋น๋ ๊ฒฐ๊ณผ๋ฌผ(IPA/APK/AAB)์ Capgo ์คํ ๋ฆฌ์ง์ ์ ๋ก๋ํ์ง ์์ |
| โoutput-retention | string | Output ๋งํฌ TTL: 1h~7d. ์: 1h, 6h, 2d |
| โ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 manage์ ์ฅ๋ ๋น๋ ์ธ์ฆ ์ ๋ณด๋ฅผ ๋ํํ์ผ๋ก ๊ด๋ฆฌํฉ๋๋ค.
์ ์ฅ๋ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ฐพ์๋ณด๊ณ , ์ค์ ๋ด์ฉ์ ํ์ธํ๊ฑฐ๋, CI/CD์ฉ .env ํ์ผ์ ๋ด๋ณด๋ด๊ณ , ํน์ ํ๋ซํผ์ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ญ์ ํ ์ ์์ต๋๋ค. ๋ค์ ๋ช
๋ น๊ณผ ๋์ผํ TUI๋ฅผ ์ฌ์ฉํฉ๋๋ค: capgo init.
์์:
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
์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โappId | string | ๊ด๋ฆฌํ ์ฑ ID (์ ํ ์ฌํญ, ์๋ตํ๋ฉด ์ ํ ํ๋กฌํํธ ํ์) |
| โplatform | string | ๊ด๋ฆฌํ ํ๋ซํผ: ios ๋๋ android (์ ํ ์ฌํญ, ์๋ตํ๋ฉด ์ ํ ํ๋กฌํํธ ํ์) |
| โlocal | boolean | ๋ก์ปฌ .capgo-credentials.json๋ง ํ์ |
๐น ๋ง์ด๊ทธ๋ ์ด์
โ ๐น ๋ง์ด๊ทธ๋ ์ด์ โ ์น์ npx @capgo/cli@latest build credentials migrate๋ ๊ฑฐ์ ํ๋ก๋น์ ๋ ํ๋กํ์ ์๋ก์ด ๋ฉํฐ ํ๊น ํ์์ผ๋ก ๋ง์ด๊ทธ๋ ์ด์ ํฉ๋๋ค. BUILD_PROVISIONING_PROFILE_BASE64๋ฅผ CAPGO_IOS_PROVISIONING_MAP์ผ๋ก ๋ณํํฉ๋๋ค. Xcode ํ๋ก์ ํธ์์ ๋ฉ์ธ ๋ฒ๋ค ID๋ฅผ ์๋์ผ๋ก ๊ฐ์งํฉ๋๋ค. npx @capgo/cli build credentials migrate โplatform ios
์์:
Example:์ต์ :
| ํ๋ผ๋ฏธํฐ | ์ ํ | ์ค๋ช |
|---|---|---|
| โappId | string | App ID (์๋ต ์ capacitor.config์์ ์๋ ๊ฐ์ง) |
| โplatform | string | ํ๋ซํผ (ios๋ง ์ง์) |
| โlocal | boolean | ์ ์ญ ๋์ ๋ก์ปฌ .capgo-credentials.json์ผ๋ก ๋ง์ด๊ทธ๋ ์ด์ |