🔹 build
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
🏗️ Kelola build native iOS/Android lewat Capgo Cloud.
Akses dan output build
Bagian berjudul “Akses dan output Build”Capgo Build sudah tersedia umum untuk rilis produksi iOS dan Android Capacitor. Build, sign, dan submit dari Windows, Linux, macOS, CI, atau agen coding AI melalui Capgo MCP. Tidak perlu Mac lokal atau Xcode.
Menit build sudah termasuk dalam paket Capgo; menit tambahan memakai kredit prabayar. Lihat harga terkini, performa build terukur, dan persyaratan setup. Gunakan kredensial signing lokal atau CI, atau simpan kredensial aplikasi terenkripsi secara eksplisit untuk workflow MCP hosted. Output build bisa diunggah secara opsional dengan tautan download berbatas waktu.
Simpan kredensial terlebih dahulu
Bagian berjudul “Simpan kredensial terlebih dahulu”npx @capgo/cli@latest build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli@latest build credentials save --appId YOUR_APP_ID --platform androidAmbil URL output di CI
Bagian berjudul “Tangkap URL output di CI”Gunakan --output-record untuk menyimpan URL download dan QR code, lalu gunakan build last-output untuk membacanya:
npx @capgo/cli@latest build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli@latest build last-output --path /tmp/build.json --field outputUrl🔹 Diperlukan
Bagian berjudul “ 🔹 Diperlukan”npx @capgo/cli@latest build needed🧭 Cetak “yes” dan keluar dengan code 1 jika native build diperlukan; jika tidak, cetak “no” dan keluar dengan code 0. Kegagalan perintah keluar dengan code 2.
Contoh:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOpsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| -a | string | key API untuk menautkan ke akun Anda |
| -c | string | Channel yang dijadikan pembanding. Default ke CapacitorUpdater.defaultChannel atau channel default publik |
| —package-json | string | Path ke file package.json untuk monorepo (pisahkan dengan koma) |
| —node-modules | string | Path ke direktori node_modules untuk monorepo (pisahkan dengan koma) |
| —verbose | boolean | Aktifkan output verbose dengan logging mendetail |
| —supa-host | string | URL host Supabase kustom (untuk self-hosting atau pengembangan Capgo) |
| —supa-anon | string | Anon key Supabase kustom (untuk self-hosting) |
Alias: onboarding
npx @capgo/cli@latest build initKonfigurasi kredensial build secara interaktif (iOS: sertifikat + profil otomatis; Android: keystore + Google OAuth menyediakan akun layanan GCP dan undangan Play Console)
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| -a | string | key API untuk menautkan ke akun Anda |
| -p | string | Platform untuk onboarding (ios atau android). Jika tidak diisi, otomatis terdeteksi saat hanya ada satu folder native; jika tidak, akan menampilkan prompt. |
| —supa-host | string | URL host Supabase kustom (untuk self-hosting atau pengembangan Capgo) |
| —no-analytics | boolean | Nonaktifkan analytics onboarding build dan terminal replay untuk run ini |
🔹 Permintaan
Bagian berjudul “ 🔹 Request”npx @capgo/cli@latest build requestMinta native build dari Capgo Cloud. Perintah ini akan meng-zip direktori proyek Anda dan meng-upload-nya ke Capgo untuk di-build. Build akan diproses dan dikirim langsung ke app stores. Kredensial tidak pernah disimpan di server Capgo; kredensial dihapus setelah build selesai. Simpan kredensial sebelum meminta build:
npx @capgo/cli@latest build credentials save --appId APP_ID --platform iosContoh:
npx @capgo/cli@latest build request com.example.app --platform ios --path .Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —path | string | Path ke direktori proyek yang akan di-build (default: direktori saat ini) |
| —node-modules | string | Path ke direktori node_modules untuk monorepo (pisahkan dengan koma) |
| —platform | string | Platform target: ios atau android (wajib) |
| —build-mode | string | Mode build: debug atau release (default: release) |
| —build-certificate-base64 | string | iOS: Sertifikat .p12 yang di-encode Base64 |
| —p12-password | string | iOS: Password sertifikat (opsional jika sertifikat tidak punya password) |
| —apple-id | string | iOS: Email Apple ID untuk upload dengan app-specific password (alternatif untuk key API App Store Connect) |
| —apple-app-specific-password | string | iOS: App-specific password (xxxx-xxxx-xxxx-xxxx) untuk upload ke TestFlight |
| —apple-app-id | string | iOS: app id numerik App Store Connect (wajib digunakan bersama —apple-id dan —apple-app-specific-password) |
| —apple-key-id | string | iOS: App Store Connect API Key ID |
| —apple-issuer-id | string | iOS: App Store Connect Issuer ID |
| —apple-key-content | string | iOS: key App Store Connect API yang di-encode Base64 (.p8) |
| —app-store-connect-team-id | string | iOS: Team ID App Store Connect |
| —ios-scheme | string | iOS: Xcode scheme yang akan di-build (default: App) |
| —ios-target | string | iOS: Xcode target untuk membaca build settings (default: sama dengan scheme) |
| —xcode-version | string | iOS: build di mesin dengan versi Xcode ini (misal 26, 26.0.1, 27). Versi major menerima minor apa pun. Default: mesin apa pun. Prioritas: CLI > env (CAPGO_IOS_XCODE_VERSION) > kredensial tersimpan |
| —ios-distribution | string | iOS: Mode distribusi |
| —ios-provisioning-profile | string | iOS: Path provisioning profile atau pemetaan bundleId=path (bisa diulang) |
| —android-keystore-file | string | Android: File keystore ter-encode Base64 |
| —keystore-key-alias | string | Android: Alias kunci Keystore |
| —keystore-key-password | string | Android: Password kunci Keystore |
| —keystore-store-password | string | Android: Password store Keystore |
| —play-config-json | string | Android: JSON akun layanan Google Play yang di-encode Base64 |
| —android-flavor | string | Android: Product flavor yang akan di-build (misal: production). Wajib jika proyek Anda memiliki banyak flavor. |
| —android-track | string | Android: Track Google Play untuk upload ini (internal, alpha, beta, production). Default tanpa —submit-to-store-review: internal. Dengan —submit-to-store-review dan tanpa track yang disetel: production. Prioritas: CLI > env > kredensial tersimpan |
| —android-release-status | string | Android: Status rilis Google Play (draft, completed, inProgress, halted). Default tanpa —submit-to-store-review: draft. Dengan —submit-to-store-review dan tanpa status yang disetel: completed. Prioritas: CLI > env > kredensial tersimpan |
| —in-app-update-priority | string | Android: Prioritas in-app update Google Play untuk rilis ini (integer 0–5; makin tinggi = makin mendesak). Lihat https://developer.android.com/guide/playcore/in-app-updates. Prioritas: CLI > env > kredensial tersimpan |
| —no-playstore-upload | boolean | Lewati upload ke Play Store untuk build ini (mengosongkan konfigurasi Play yang tersimpan). Memerlukan —output-upload. |
| —submit-to-store-review | boolean | Setelah upload, kirim rilis store untuk review, bukan membiarkannya sebagai draft/build tidak aktif. Di Android, default-nya ke production track dengan release_status completed (bisa di-override dengan —android-track / PLAY_STORE_TRACK dan —android-release-status / PLAY_STORE_RELEASE_STATUS). Di iOS, ini mengirim build TestFlight yang sudah diproses ke review App Store. |
| —store-release-name | string | Label nama/versi rilis store. Android mengirim ini sebagai version_name Google Play; iOS memakainya sebagai versi App Store saat membuat atau memakai ulang versi yang bisa diedit. |
| —store-release-notes | string | Catatan rilis store default. Android menggunakan ini sebagai changelog Play; iOS menggunakannya sebagai teks fallback What’s New di App Store. |
| —store-release-notes-locale | string | Catatan rilis store dalam bahasa lokal (bisa diulang), contohnya —store-release-notes-locale en-US=“Bug fixes” —store-release-notes-locale fr-FR=“Corrections”. |
| —ios-testflight-groups | string | iOS: opsional, nama atau ID grup eksternal TestFlight yang dipisahkan koma untuk distribusi beta eksternal. |
| —ios-automatic-release | boolean | iOS: rilis versi App Store secara otomatis setelah disetujui Apple. Default-nya rilis manual. |
| —no-ios-automatic-release | boolean | iOS: biarkan versi App Store menunggu rilis manual setelah disetujui Apple. |
| —output-upload | boolean | Timperilaku output upload untuk build ini saja (aktifkan). Prioritas: CLI > env > kredensial tersimpan |
| —no-output-upload | boolean | Timperilaku upload output hanya untuk build ini (nonaktifkan). Prioritas: CLI > env > kredensial tersimpan |
| —output-retention | string | Tim TTL tautan output hanya untuk build ini (1 jam hingga 7 hari). Contoh: 1h, 6h, 2d. Prioritas: CLI > env > kredensial tersimpan |
| —output-record | string | Setelah build berhasil, tulis rekaman JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) ke path. PNG QR code juga ditulis di samping path tersebut dengan .qr.png suffix. Baca kembali field dengan build last-output. |
| —no-cache | boolean | Lewati pemulihan cache build dan jangan simpan entri cache baru untuk build ini. Cache build diaktifkan secara default per aplikasi. |
| —cache-key | string | Partisi cache build berdasarkan environment, branch, atau Android flavor (misalnya prod, staging). Hilangkan untuk satu cache default bersama per aplikasi. |
| —no-skip-build-number-bump | boolean | Timpa kredensial tersimpan untuk mengaktifkan kembali peningkatan nomor build otomatis hanya untuk build ini. |
| —skip-marketing-version-bump | boolean | Lewati peningkatan versi marketing otomatis (CFBundleShortVersionString / versionName) jika aplikasi sudah dirilis. |
| —sync-ios-version | boolean | iOS: sinkronkan MARKETING_VERSION Xcode dari package.json sebelum mengunggah proyek. |
| —ai-analytics | boolean | Jika build gagal, kirim logs ke Capgo AI untuk diagnosis. Di terminal interaktif, ini melewati konfirmasi awal; di CI, ini mengunggah otomatis dan mencetak analisis ke stderr. |
| —no-prescan | boolean | Lewati pemindaian pra-build otomatis |
| —prescan-ignore-fatal | boolean | Jalankan prescan sebelum build tetapi jangan pernah memblokir build (hanya laporan) |
| —prescan-skip | string | Lewati pemeriksaan prescan tertentu berdasarkan id (dapat diulang atau dipisahkan koma). Pemeriksaan lain tetap dijalankan. |
| —prescan-warn | string | Turunkan pemeriksaan prescan tertentu menjadi peringatan berdasarkan id (dapat diulang atau dipisahkan koma). Pemeriksaan tetap dijalankan. |
| —fail-on-warnings | boolean | Anggap peringatan prescan sebagai fatal |
| —send-logs-to-support | boolean | Jika build CI/CD gagal, otomatis upload log build ke dukungan Capgo (tanpa email). Dukungan Capgo akan diberi tahu dan menindaklanjuti via email. Ditambahkan ke —ai-analytics. |
| —send-logs | boolean | Alias non-rekomendasi untuk —send-logs-to-support |
| -a | string | key API untuk menautkan ke akun Anda |
| —supa-host | string | URL host Supabase kustom (untuk self-hosting atau pengembangan Capgo) |
| —supa-anon | string | Anon key Supabase kustom (untuk self-hosting) |
| —verbose | boolean | Aktifkan output verbose dengan logging mendetail |
Cache build: Capgo memulihkan dan menyimpan artefak native terkompilasi (CocoaPods, Gradle, dan output terkait) per aplikasi secara default. Gunakan --cache-key untuk memisahkan cache RC dan produksi; gunakan --no-cache untuk clean build sekali jalan. Integrasi API dapat meneruskan cache_key atau cache_enabled: false di payload permintaan build. Lihat Cache build dan Troubleshooting: restore cache yang salah.
🔹 Sync-ios-version
Bagian berjudul “ 🔹 Sync-ios-version”npx @capgo/cli@latest build sync-ios-versionSinkronkan MARKETING_VERSION Xcode iOS lokal dari package.json.
Contoh:
npx @capgo/cli@latest build sync-ios-version --path .Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —path | string | Path ke direktori proyek (default: direktori saat ini) |
| —check | boolean | Hanya cek; exit non-zero jika MARKETING_VERSION tidak sinkron |
🔹 Prescan
Bagian berjudul “ 🔹 Prescan”npx @capgo/cli@latest build prescanScan proyek dan kredensial tersimpan untuk masalah yang bisa menggagalkan cloud build — sebelum upload apa pun.
Memeriksa kredensial (masa berlaku, password, pairing profil), kondisi proyek (cap sync, layout node_modules), dan konfigurasi platform. Berjalan otomatis di dalam build request; perintah ini menjalankannya secara standalone (misalnya di CI).
Lihat Pengecekan Prescan untuk katalog pengecekan lengkap dan cara --skip / --warn setiap aturan.
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —platform | string | Platform target: ios atau android (wajib) |
| —path | string | Path ke direktori proyek (default: direktori saat ini) |
| -a | string | key API untuk menautkan ke akun Anda |
| —android-flavor | string | Android: product flavor yang akan digunakan build |
| —ios-dist | string | iOS: mode distribusi untuk validasi |
| —json | boolean | Hasilkan laporan JSON yang dapat dibaca mesin |
| —fail-on-warnings | boolean | Exit non-zero jika ditemukan warning (CI) |
| —ignore-fatal | boolean | Mode diagnostik: laporkan semua tapi selalu exit 0 |
| —skip | string | Lewati check tertentu berdasarkan id (bisa diulang atau dipisah koma) |
| —warn | string | Ubah check tertentu menjadi warning berdasarkan id (bisa diulang atau dipisah koma) |
| —verbose | boolean | Aktifkan output verbose dengan logging mendetail |
| —supa-host | string | URL host Supabase kustom (untuk self-hosting atau pengembangan Capgo) |
| —supa-anon | string | Anon key Supabase kustom (untuk self-hosting) |
🔹 Last-output
Bagian berjudul “ 🔹 Last-output”npx @capgo/cli@latest build last-outputMembaca catatan output build yang ditulis oleh proses sebelumnya build request --output-record.
Secara default menampilkan JSON lengkap, satu field dengan —field, atau QR ASCII
code dengan —qr. Berguna di CI untuk mengambil URL download atau QR untuk diposting kembali
ke PR atau issue.
Contoh:
npx @capgo/cli@latest build last-output —path /tmp/build.json
npx @capgo/cli@latest build last-output —path /tmp/build.json —field outputUrl
npx @capgo/cli@latest build last-output —path /tmp/build.json —qr
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —path | string | Path ke record JSON yang ditulis oleh —output-record (wajib) |
| —field | string | Tampilkan satu field (salah satu dari: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Tampilkan QR ASCII code hasil render (shortcut untuk —field qrCodeAscii) |
🔹 Kredensial
Bagian berjudul “ 🔹 Kredensial”Kelola kredensial build yang tersimpan secara lokal di mesin Anda. 🔒 KEAMANAN:
- Kredensial disimpan ke ~/.capgo-credentials/credentials.json (global) atau .capgo-credentials.json (lokal)
- Saat build, dikirim ke Capgo tetapi TIDAK pernah disimpan secara permanen
- Dihapus dari Capgo segera setelah build
- Output build dapat diunggah opsional untuk tautan unduhan berbatas waktu 📚 DOKUMENTASI: Setup iOS: https://capgo.app/docs/cli/cloud-build/ios/ Setup Android: https://capgo.app/docs/cli/cloud-build/android/
🔹 Apple-key
Bagian berjudul “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyBuat kunci tim App Store Connect API dengan helper macOS terpandu (khusus macOS). Membuka jendela native yang memandu Anda melalui UI App Store Connect Apple di browser tertanam, otomatis menangkap Issuer ID + Key ID, mencegat .p8 sekali pakai, memvalidasinya ke Apple, dan menyimpannya ke ~/.appstoreconnect/private_keys. Statistik progres diteruskan ke analytics Capgo (nonaktifkan dengan CAPGO_DISABLE_TELEMETRY). npx @capgo/cli@latest build credentials apple-key —appId com.example.app
Contoh:
Example:Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| -a | string | key API untuk menautkan ke akun Anda |
| —appId | string | Simpan key yang diperoleh ke kredensial build iOS app ini |
| —local | boolean | Simpan ke file .capgo-credentials.json per proyek, bukan ke file global |
| —json | boolean | Tampilkan Key ID / Issuer ID / path .p8 yang ditangkap sebagai JSON |
🔹 Simpan
Bagian berjudul “ 🔹 Simpan”npx @capgo/cli@latest build credentials saveSimpan kredensial build secara lokal untuk iOS atau Android. Kredensial disimpan di:
- ~/.capgo-credentials/credentials.json (default, global)
- .capgo-credentials.json di root proyek (dengan flag —local)
⚠️ WAJIB SEBELUM BUILD: Anda harus menyimpan kredensial sebelum meminta build.
🔒 Kredensial ini TIDAK PERNAH disimpan secara permanen di server Capgo.
Mereka dihapus segera setelah build selesai.
📚 Panduan setup:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli@latest 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” Contoh Multi-target (app + widget extension): npx @capgo/cli@latest build credentials save —platform ios
—ios-provisioning-profile ./App.mobileprovision
—ios-provisioning-profile com.example.widget=./Widget.mobileprovision
… npx @capgo/cli@latest build credentials save —platform android
—keystore ./release.keystore —keystore-alias “my-key”
—keystore-key-password “key-pass”
—play-config ./service-account.json Penyimpanan lokal (per-proyek): npx @capgo/cli@latest build credentials save —local —platform ios …
Contoh:
iOS Example:Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID (mis., com.example.app) (wajib) |
| —platform | string | Platform: ios atau android (wajib) |
| —certificate | string | iOS: Path ke file sertifikat .p12 |
| —ios-provisioning-profile | string | iOS: Path provisioning profile atau bundleId=path (dapat diulang) |
| —p12-password | string | iOS: Password sertifikat (opsional jika sertifikat tidak punya password) |
| —apple-key | string | iOS: Path ke kunci API App Store Connect .p8 |
| —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: Team ID App Store Connect |
| —ios-distribution | string | iOS: Mode distribusi |
| —apple-id | string | iOS: Email Apple ID untuk upload dengan app-specific password (alternatif untuk key API App Store Connect) |
| —apple-app-specific-password | string | iOS: App-specific password (xxxx-xxxx-xxxx-xxxx) untuk upload ke TestFlight |
| —apple-app-id | string | iOS: app id numerik App Store Connect (wajib digunakan bersama —apple-id dan —apple-app-specific-password) |
| —keystore | string | Android: Path ke file keystore (.keystore atau .jks) |
| —keystore-alias | string | Android: Alias kunci Keystore |
| —keystore-key-password | string | Android: Password kunci Keystore |
| —keystore-store-password | string | Android: Password store Keystore |
| —play-config | string | Android: Path ke JSON service account Play Store |
| —android-flavor | string | Android: Product flavor yang akan di-build (misal: production). Wajib jika proyek Anda memiliki banyak flavor. |
| —in-app-update-priority | string | Android: Prioritas in-app update Google Play untuk rilis mendatang (integer 0–5; makin tinggi = makin mendesak). Lewati agar nilai Play yang ada tidak berubah. |
| —local | boolean | Simpan ke .capgo-credentials.json di root proyek, bukan di global ~/.capgo-credentials/ |
| —output-upload | boolean | Upload hasil build (IPA/APK/AAB) ke storage Capgo dan tampilkan link download |
| —no-output-upload | boolean | Jangan upload hasil build (IPA/APK/AAB) ke storage Capgo |
| —output-retention | string | TTL link output: 1h hingga 7d (default: 1h). Contoh: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Lewati kenaikan otomatis build number/version code pada build berikutnya |
| —no-skip-build-number-bump | boolean | Aktifkan kembali kenaikan otomatis build number (perilaku default) |
| —skip-marketing-version-bump | boolean | Lewati peningkatan versi marketing otomatis pada build berikutnya jika aplikasi sudah dirilis |
| —no-skip-marketing-version-bump | boolean | Aktifkan kembali peningkatan versi marketing otomatis (perilaku default) |
📋 Daftar
Bagian berjudul “ 📋 List”npx @capgo/cli@latest build credentials listDaftarkan kredensial build yang tersimpan (kata sandi disamarkan). Menampilkan kredensial yang saat ini tersimpan (baik global maupun lokal). Contoh: npx @capgo/cli@latest build credentials list # Daftarkan semua aplikasi npx @capgo/cli@latest build credentials list —appId com.example.app # Daftarkan aplikasi tertentu
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID to list (optional, lists all if omitted) |
| —local | boolean | Daftarkan kredensial hanya dari .capgo-credentials.json lokal |
🔹 Hapus
Bagian berjudul “ 🔹 Clear”npx @capgo/cli@latest build credentials clearHapus kredensial build yang tersimpan. Hapus kredensial dari penyimpanan. Gunakan —appId dan —platform untuk menargetkan kredensial tertentu. Contoh: npx @capgo/cli@latest build credentials clear # Hapus semua aplikasi (global) npx @capgo/cli@latest build credentials clear —local # Hapus kredensial lokal npx @capgo/cli@latest build credentials clear —appId com.example.app —platform ios
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID yang akan dihapus (opsional, hapus semua app jika tidak diisi) |
| —platform | string | Platform yang akan dihapus: ios atau android (opsional, hapus semua platform jika tidak diisi) |
| —local | boolean | Hapus dari file lokal .capgo-credentials.json, bukan global |
🔹 Update
Bagian berjudul “ 🔹 Update”npx @capgo/cli@latest build credentials updateUpdate kredensial tertentu tanpa perlu memberikan semuanya lagi. Update kredensial yang ada dengan hanya memberikan field yang ingin diubah. Platform akan terdeteksi otomatis dari opsi yang Anda berikan. Contoh: npx @capgo/cli@latest build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli@latest build credentials update —local —keystore ./new-keystore.jks
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID (terdeteksi otomatis dari capacitor.config jika tidak diisi) |
| —platform | string | Platform: ios atau android (terdeteksi otomatis dari opsi) |
| —local | boolean | Perbarui .capgo-credentials.json lokal, bukan yang global |
| —certificate | string | Path ke file sertifikat P12 |
| —ios-provisioning-profile | string | Path provisioning profile atau bundleId=path (dapat diulang, default: aditif) |
| —overwrite-ios-provisioning-map | boolean | Ganti seluruh provisioning map alih-alih menggabungkan (default: merge) |
| —p12-password | string | Kata sandi sertifikat P12 |
| —apple-key | string | Path ke kunci API App Store Connect (file .p8) |
| —apple-key-id | string | ID Kunci App Store Connect API |
| —apple-issuer-id | string | Issuer ID App Store Connect |
| —apple-team-id | string | Team ID App Store Connect |
| —apple-id | string | iOS: Email Apple ID untuk upload dengan app-specific password (alternatif untuk key API App Store Connect) |
| —apple-app-specific-password | string | iOS: App-specific password (xxxx-xxxx-xxxx-xxxx) untuk upload ke TestFlight |
| —apple-app-id | string | iOS: app id numerik App Store Connect (wajib digunakan bersama —apple-id dan —apple-app-specific-password) |
| —ios-distribution | string | iOS: Mode distribusi |
| —keystore | string | Path ke file keystore (.keystore atau .jks) |
| —keystore-alias | string | Alias key keystore |
| —keystore-key-password | string | Password key keystore |
| —keystore-store-password | string | Password store keystore |
| —play-config | string | Path ke JSON service account Google Play |
| —android-flavor | string | Android: Product flavor yang akan di-build (misal: production). Wajib jika proyek Anda memiliki banyak flavor. |
| —in-app-update-priority | string | Android: Prioritas in-app update Google Play untuk rilis mendatang (integer 0–5; lebih tinggi = lebih mendesak). |
| —output-upload | boolean | Upload hasil build (IPA/APK/AAB) ke storage Capgo dan tampilkan link download |
| —no-output-upload | boolean | Jangan upload hasil build (IPA/APK/AAB) ke storage Capgo |
| —output-retention | string | TTL tautan output: 1 jam hingga 7 hari. Contoh: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Lewati kenaikan otomatis build number/version code pada build berikutnya |
| —no-skip-build-number-bump | boolean | Aktifkan kembali kenaikan otomatis build number (perilaku default) |
| —skip-marketing-version-bump | boolean | Lewati peningkatan versi marketing otomatis pada build berikutnya jika aplikasi sudah dirilis |
| —no-skip-marketing-version-bump | boolean | Aktifkan kembali peningkatan versi marketing otomatis (perilaku default) |
🔹 Kelola
Bagian berjudul “ 🔹 Kelola”npx @capgo/cli@latest build credentials manageKelola kredensial build yang tersimpan secara interaktif.
Jelajahi kredensial yang disimpan, lihat apa yang dikonfigurasi, ekspor file .env yang siap untuk CI/CD,
atau hapus kredensial platform. Menggunakan TUI yang sama dengan capgo init.
Contoh:
npx @capgo/cli@latest build credentials manage
npx @capgo/cli@latest build credentials manage —appId com.example.app
npx @capgo/cli@latest build credentials manage —appId com.example.app —platform ios
npx @capgo/cli@latest build credentials manage —local
Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID yang akan dikelola (opsional, akan diminta untuk memilih jika diabaikan) |
| —platform | string | Platform yang akan dikelola: ios atau android (opsional, akan diminta untuk memilih jika diabaikan) |
| —local | boolean | Hanya jelajahi .capgo-credentials.json lokal |
🔹 Migrasi
Bagian berjudul “ 🔹 Migrasi”npx @capgo/cli@latest build credentials migrateMigrasikan profil provisioning legacy ke format multi-target baru. Mengonversi BUILD_PROVISION_PROFILE_BASE64 menjadi CAPGO_IOS_PROVISIONING_MAP. Menemukan bundle ID utama dari proyek Xcode Anda secara otomatis. npx @capgo/cli@latest build credentials migrate —platform ios
Contoh:
Example:Opsi:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | App ID (terdeteksi otomatis dari capacitor.config jika tidak diisi) |
| —platform | string | Platform (hanya ios yang didukung) |
| —local | boolean | Migrasi dari .capgo-credentials.json lokal alih-alih global |