🔹 Bangun
Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.
🏗️ Manage native iOS/Android builds through Capgo Cloud.
Akses dan Keluaran Bangunan
Bab berjudul “Akses dan Keluaran Bangunan”Native cloud build requests are currently in limited beta and access is restricted. Build credentials are never stored on Capgo servers: they are used only for the build and then deleted. Build outputs can optionally be uploaded with time-limited download links.
Simpan kredential terlebih dahulu
Bab berjudul “Simpan kredential terlebih dahulu”npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidTangkap URL hasil di CI
Judul bagian “Tangkap URL hasil di CI”Pass --output-record Untuk menyimpan URL download dan QR code, kemudian gunakan build last-output Untuk membacanya:
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🔹 Diperlukan
Judul bagian “ 🔹 Diperlukan”npx @capgo/cli@latest build needed🧭 Cetak “ya” dan keluar dengan code 1 jika pembangunan asli diperlukan; jika tidak, cetak “tidak” dan keluar dengan code 0. Gagalnya perintah keluar dengan code 2.
Contoh:
npx @capgo/cli@latest build needed com.example.app --channel production --verbosePilihan:
| Param | Jenis | Deskripsi |
|---|---|---|
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| -c | string | Saluran untuk dibandingkan. Default ke Saluran CapacitorUpdater.defaultChannel atau saluran publik default |
| ---package-json | string | Jalur ke file package.json untuk repositori monorepos (dipisahkan koma) |
| ---node-modules | string | Jalur ke direktori node_modules untuk repositori monorepos (dipisahkan koma) |
| ---verbose | boolean | Tampilkan output yang lebih detail dengan logging yang lebih rinci |
| ---supa-host | string | URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo) |
| ---supa-anon | string | Kunci anon Supabase yang diatur sendiri (untuk pengembangan sendiri) |
Alias: onboarding
npx @capgo/cli@latest build initKonfigurasi kredit build secara interaktif (iOS: sertifikat + profil otomatis; Android: keystore + Google OAuth menyediakan akun layanan GCP dan undang ke Play Console)
Option:
| Param | Jenis | Deskripsi |
|---|---|---|
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| -p | string | Platform untuk mengaktifkan (ios atau android). Jika tidak disebutkan, akan mendeteksi secara otomatis ketika hanya ada satu folder native yang ada; meminta konfirmasi lainnya. |
| — supa-host | string | URL Host Supabase yang disesuaikan (untuk pengembangan sendiri atau pengembangan Capgo) |
| — no-analytics | boolean | Matikan analisis pendaftaran build dan ulang terminal untuk menjalankan ini |
🔹 Permintaan
Bagian berjudul “ 🔹 Permintaan”npx @capgo/cli@latest build requestPermintaan build native dari Capgo Cloud. Perintah ini akan mengemas direktori proyek Anda dan mengunggahnya ke Capgo untuk dibangun. Build akan diproses dan dikirim langsung ke toko aplikasi. Kredensial tidak disimpan di server Capgo; mereka dihapus setelah build. Simpan mereka sebelum meminta build:
npx @capgo/cli build credentials save --appId APP_ID --platform iosContoh:
npx @capgo/cli@latest build request com.example.app --platform ios --path .Pilihan:
| Param | Tipe | Deskripsi |
|---|---|---|
| —path | string | Alamat direktori proyek untuk dibangun (default: direktori saat ini) |
| —node-modules | string | Alamat direktori node_modules untuk repositori monorepos (dipisahkan koma) |
| —platform | string | Platform target: ios atau android (wajib) |
| Mode pembangunan: | string | Mode pembangunan: debug atau release (default: release) |
| Mode pembangunan: | string | Sertifikat iOS: Sertifikat .p12 yang dikodekan dalam Base64 |
| Sandi sertifikat iOS: | string | Sandi sertifikat iOS (opsional jika sertifikat tidak memiliki sandi) |
| Alamat email ID Apple untuk unggah sandi aplikasi khusus (alternatif untuk App Store Connect __CAPGO_KEEP_0__ key) | string | iOS: Apple ID email for app-specific password uploads (alternative to App Store Connect API key) |
| ID aplikasi Apple: | string | __CAPGO_KEEP_0__ |
| __CAPGO_KEEP_0__ | string | iOS: ID Aplikasi App Store Connect numerik (diperlukan bersama dengan —apple-id dan —apple-app-specific-password) |
| —apple-key-id | string | iOS: App Store Connect API Key ID |
| —apple-issuer-id | string | iOS: ID Pengeluarnya App Store Connect |
| —apple-key-content | string | iOS: Base64-encoded App Store Connect API key (.p8) |
| —app-store-connect-team-id | string | iOS: ID Tim App Store Connect |
| —ios-scheme | string | iOS: Scheme Xcode untuk membangun (default: App) |
| —ios-target | string | iOS: Target Xcode untuk membaca pengaturan pembangunan (default: sama dengan skema) |
| —ios-distribution | string | iOS: Mode distribusi |
| —ios-provisioning-profile | string | iOS: Jalur profil penyediaan atau bundleId=path mapping (ulangi) |
| —android-keystore-file | string | Android: File keystore yang dikodekan Base64 |
| —keystore-key-alias | string | Android: Alias kunci keystore |
| —keystore-key-password | string | Android: Kata sandi kunci keystore |
| —keystore-store-password | string | Android: Kata sandi penyimpanan keystore |
| —konfigurasi-mainan-json | string | Android: Akun JSON layanan Google Play yang di-Base64 |
| —rasa-android | string | Android: Rasa produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki beberapa rasa. |
| —track-android | string | Android: Jalur Google Play untuk unggahan ini (internal, alpha, beta, produksi). Default tanpa —kirim-ke-tinjauan-toko: internal. Dengan —kirim-ke-tinjauan-toko dan tidak ada jalur yang ditetapkan: produksi. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —status-rilis-android | string | Android: Status rilis Google Play (draft, selesai, inProgress, dihentikan). Default tanpa —kirim-ke-tinjauan-toko: draft. Dengan —kirim-ke-tinjauan-toko dan tidak ada status yang ditetapkan: selesai. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —prioritas-update-in-app | string | Android: Prioritas update in-app Google Play untuk rilis ini (integer 0–5; lebih tinggi = lebih mendesak). Lihat https://developer.android.com/guide/playcore/in-app-updates. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —no-playstore-upload | boolean | Lepaskan unggahan ke Play Store untuk build ini (membatalkan konfigurasi Play yang disimpan). Memerlukan —output-upload. |
| —submit-to-store-review | boolean | Setelah unggahan, kirimkan rilis toko untuk tinjauan daripada meninggalkannya sebagai draft/aktif build. Pada Android ini beralih ke jalur produksi dengan status rilis selesai (atasi dengan —android-track / PLAY_STORE_TRACK dan —android-release-status / PLAY_STORE_RELEASE_STATUS). Pada iOS ini mengirimkan build TestFlight yang diproses ke tinjauan App Store. |
| —store-release-name | string | Label nama rilis toko/versi. Android mengirimkan ini sebagai versi Google Play; iOS menggunakan ini sebagai versi App Store ketika membuat atau menggunakan versi yang dapat diedit. |
| —store-release-notes | string | Catatan rilis toko default. Android menggunakan ini sebagai catatan perubahan Play; iOS menggunakan ini sebagai teks 'Apa Baru' App Store yang dapat digunakan. |
| —store-release-notes-locale | string | Catatan rilis toko yang disesuaikan (berulang), misalnya —store-release-notes-locale en-US=“Pembaruan bug” —store-release-notes-locale fr-FR=“Koreksi”. |
| —ios-testflight-groups | string | iOS: nama atau ID grup eksternal TestFlight yang dipisahkan koma secara opsional atau ID untuk distribusi beta eksternal. |
| —ios-otomatis-rilis | boolean | iOS: rilis versi App Store secara otomatis setelah mendapat persetujuan Apple. Default adalah rilis manual. |
| —no-ios-otomatis-rilis | boolean | iOS: biarkan versi App Store menunggu rilis manual setelah mendapat persetujuan Apple. |
| —output-upload | boolean | Override perilaku unggah output untuk build ini saja (aktifkan). Prioritas: CLI > lingkungan > kredit yang disimpan |
| —no-output-upload | boolean | Override perilaku unggah output untuk build ini saja (nonaktifkan). Prioritas: CLI > lingkungan > kredit yang disimpan |
| —output-retention | string | Override TTL link output untuk build ini saja (1h - 7d). Contoh: 1h, 6h, 2d. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —output-rekam | string | Setelah sukses melakukan build, tuliskan sebuah catatan JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) ke sebuah path. Sebuah QR PNG code juga ditulis di samping path tersebut dengan .qr.png Tampilkan kembali bidang dengan build last-output. |
| Tidak melewati nomor build yang telah disimpan untuk meningkatkan nomor build otomatis untuk build ini saja. | boolean | Tidak meningkatkan nomor versi pemasaran otomatis (CFBundleShortVersionString / versionName) ketika aplikasi sudah dirilis. |
| Sinkronkan versi iOS: Sinkronkan MARKETING_VERSION dari Xcode package.json sebelum mengunggah proyek. | boolean | Kirim log ke __CAPGO_KEEP_0__ AI untuk diagnosis ketika build gagal. Di terminal interaktif, ini melewati konfirmasi awal; di CI, ini mengunggah otomatis dan mencetak analisis ke stderr. |
| Tidak melakukan skanning otomatis sebelum build | boolean | Tidak melewati nomor build yang telah disimpan untuk meningkatkan nomor build otomatis untuk build ini saja. |
| Tidak meningkatkan nomor versi pemasaran otomatis (CFBundleShortVersionString / versionName) ketika aplikasi sudah dirilis. | boolean | On build failure, send logs to Capgo AI for diagnosis. In interactive terminals this skips the upfront confirmation; in CI this auto-uploads and prints the analysis to stderr. |
| Kirim log ke __CAPGO_KEEP_0__ AI untuk diagnosis ketika build gagal. Di terminal interaktif, ini melewati konfirmasi awal; di CI, ini mengunggah otomatis dan mencetak analisis ke stderr. | boolean | Tidak melakukan skanning otomatis sebelum build |
| – prescan-ignore-fatal | boolean | Jalankan skenario pra-pembangunan tetapi tidak pernah menghalangi pembangunan (laporan hanya) |
| – prescan-skip | string | Melewatkan skenario pra-pembangunan tertentu dengan id (berulang atau terpisah koma). Skenario lain masih berjalan. |
| – prescan-warn | string | Menurunkan skenario pra-pembangunan tertentu ke peringatan dengan id (berulang atau terpisah koma). Skenario masih berjalan. |
| – fail-on-warnings | boolean | Anggap peringatan skenario pra-pembangunan sebagai fatal |
| – send-logs-to-support | boolean | Pada gagal bangun CI/CD, secara otomatis unggah log bangun ke Capgo dukungan (tidak memerlukan email). Capgo dukungan diberitahu dan akan mengikuti dengan email. Tambahkan ke –ai-analytics. |
| – send-logs | boolean | Alias deprekatif untuk – send-logs-to-support |
| -a | string | API kunci untuk menghubungkan ke akun Anda |
| —supa-host | string | URL host Supabase kustom (untuk pengembangan sendiri atau Capgo) |
| —supa-anon | string | Kunci anon Supabase kustom (untuk pengembangan sendiri) |
| —verbose | boolean | Aktifkan output berlebihan dengan logging detail |
🔹 Versi iOS Sinkronisasi
Jendela terminalnpx @capgo/cli@latest build sync-ios-versionSinkronkan versi MARKETING iOS Xcode lokal dari package.json.
Contoh:
npx @capgo/cli@latest build sync-ios-version --path .Opsi:
| Param | Tipe | Deskripsi |
|---|---|---|
| —path | string | Alamat direktori proyek (default: direktori saat ini) |
| —check | boolean | Cek saja; keluar dengan kode non-nol jika versi MARKETING_VERSION tidak sinkron |
🔹 Pra-scan
Judul bagian “ 🔹 Pra-scan”npx @capgo/cli@latest build prescanPeriksa proyek dan kredit yang disimpan Anda untuk masalah yang akan gagal membangun di cloud — sebelum mengunggah apa pun.
Periksa kredit (kedaluwarsa, kata sandi, pairing profil), status proyek (cap sink, node_modules tata letak), dan konfigurasi platform. Berjalan secara otomatis di dalam build request; perintah ini menjalankannya secara mandiri (misalnya di CI).
Lihat Pra-scan memeriksa untuk katalog pemeriksaan lengkap dan cara --skip / --warn aturan individu.
Pilihan:
| Param | Tipe | Deskripsi |
|---|---|---|
| —platform | string | Platform target: ios atau android (wajib) |
| —path | string | Path ke direktori proyek (default: direktori saat ini) |
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| —android-flavor | string | Android: rasa produk yang akan digunakan untuk build |
| —ios-dist | string | iOS: mode distribusi untuk memvalidasi |
| —json | boolean | Menghasilkan laporan JSON yang dapat dibaca mesin |
| ---fail-on-warnings | boolean | Keluar dengan kode non-nol ketika ditemukan peringatan (CI) |
| ---ignore-fatal | boolean | Saat mode diagnostik: laporan semua tetapi selalu keluar dengan kode 0 |
| ---skip | string | Melewatkan pengecekan tertentu dengan id (ulangi atau terpisah dengan koma) |
| ---warn | string | Menurunkan pengecekan tertentu ke peringatan dengan id (ulangi atau terpisah dengan koma) |
| ---verbose | boolean | Mengaktifkan output yang rinci dengan logging yang detail |
| ---supa-host | string | URL Host Supabase Pribadi (untuk pengembangan sendiri atau Capgo) |
| —supa-anon | string | Kunci Anon Supabase (untuk pengembangan sendiri) |
🔹 Output Terakhir
Judul Bagian “ 🔹 Output Terakhir”npx @capgo/cli@latest build last-outputBaca Catatan Output Pembangunan yang Ditulis oleh Sebelumnya build request --output-record.
Tampilkan JSON Penuh secara Default, Bidang Tunggal dengan —field, atau QR ASCII
code dengan —qr. Berguna di CI untuk Mengambil URL Unduhan atau QR untuk Memposting Kembali
ke PR atau Masalah.
Contoh:
npx @capgo/cli build output-terakhir —path /tmp/output.json
npx @capgo/cli build output-terakhir —path /tmp/output.json —field urlDownload
npx @capgo/cli build output-terakhir —path /tmp/output.json —qr
Pilihan:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —path | string | Jalur ke catatan JSON yang ditulis oleh —output-record (wajib) |
| —field | string | Tampilkan satu bidang (salah satu: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Print the rendered ASCII QR code (shortcut for —field qrCodeAscii) |
🔹 Kredensial
Bab yang berjudul “ 🔹 Kredensial”Kelola kredensial pembangunan yang disimpan secara lokal di mesin Anda. 🔒 KEAMANAN:
- Kredensial yang disimpan ke ~/.capgo-credentials/credentials.json (global) atau .capgo-credentials.json (local)
- Saat pembangunan, dikirim ke Capgo tetapi TIDAK pernah disimpan secara permanen
- Dihapus dari Capgo segera setelah pembangunan
- Hasil pembangunan dapat diunggah secara opsional untuk tautan download sementara 📚 DOKUMENTASI: Pengaturan iOS: https://capgo.app/docs/cli/cloud-build/ios/ Pengaturan Android: https://capgo.app/docs/cli/cloud-build/android/
🔹 Apple-key
Judul Bagian “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyBuatlah kunci tim App Store Connect API dengan bantuan asisten macOS (hanya macOS). Membuka jendela native yang membantu Anda melalui UI App Store Connect Apple dalam browser yang diintegrasikan, menangkap secara otomatis ID Issuer + ID Key, menangkap satu kali .p8, memvalidasinya terhadap Apple, dan menyimpannya ke ~/.appstoreconnect/private_keys. Statistik kemajuan dikirimkan ke Capgo analytics (nonaktifkan dengan CAPGO_DISABLE_TELEMETRY). npx @capgo/cli membangun kredit aplikasi apple-key —appId com.example.app
Contoh:
Example:Opsi:
| Param | Jenis | Deskripsi |
|---|---|---|
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| –appId | string | Simpan kunci yang ditangkap ke kredensial build iOS aplikasi ini |
| –local | boolean | Simpan ke file .capgo-credentials.json per-proyek daripada file global |
| —json | boolean | Tampilkan ID Kunci / ID Issuer / jalur .p8 sebagai JSON |
🔹 Simpan
Bagian berjudul “ 🔹 Simpan”npx @capgo/cli@latest build credentials saveSimpan kredit build secara lokal untuk iOS atau Android. Kredit disimpan di:
- ~/.capgo-kredit/credentials.json (default, global)
- .capgo-kredit.json di root proyek (dengan flag —local)
⚠️ DIPERLUKAN SEBELUM MEMBUAT: Anda harus menyimpan kredit sebelum meminta build.
🔒 Kredit ini TIDAK pernah disimpan pada server Capgo secara permanen.
Mereka dihapus segera setelah build selesai.
📚 Panduan pengaturan:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npm @capgo/cli build credentials save —platform ios
—certificate ./cert.p12 —p12-password “password”
—ios-provisi ./profile.mobileprovision
—apple-key ./AuthKey.p8 —apple-key-id “KEY123”
—apple-issuer-id “issuer-uuid” —apple-team-id “team-id” Contoh Penggunaan Berbagai Target (aplikasi + ekstensi widget): npx @capgo/cli build credentials save —platform ios
—ios-provisi ./App.mobileprovision
—ios-provisi com.example.widget=./Widget.mobileprovision
… npx @capgo/cli 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 build credentials save —local —platform ios …
Contoh:
iOS Example:Opsi:
| Param | Jenis | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi (misalnya, com.example.app) (wajib) |
| —platform | string | Platform: ios atau android (wajib) |
| —certificate | string | iOS: Jalur ke file sertifikat .p12 |
| ---profil-provinsi-ios | string | iOS: Jalur profil pengaturan atau bundleId=path (ulangi) |
| ---kata-sandi-p12 | string | iOS: Kata sandi sertifikat (opsional jika sertifikat tidak memiliki kata sandi) |
| ---kunci-apple | string | iOS: Jalur ke kunci .p8 App Store Connect API |
| ---kunci-apple-id | string | iOS: ID Kunci App Store Connect API |
| ---penerbit-id-apple | string | iOS: ID Penerbit App Store Connect |
| ---tim-id-apple | string | iOS: ID Tim App Store Connect |
| —ios-distribution | string | Mode iOS: Distribusi |
| —apple-id | string | Email ID Apple untuk pengunggahan kata sandi aplikasi (alternatif untuk kunci App Store Connect API) |
| —apple-app-specific-password | string | Kata sandi aplikasi spesifik (xxxx-xxxx-xxxx-xxxx) untuk pengunggahan TestFlight |
| —apple-app-id | string | ID Aplikasi App Store Connect numerik (diperlukan bersamaan dengan —apple-id dan —apple-app-specific-password) |
| —keystore | string | Android: Jalur file keystore (.keystore atau .jks) |
| —keystore-alias | string | Alias kunci keystore Android |
| ---kunci-sandi-keystore--- | string | Android: Kata sandi kunci keystore |
| ---kunci-sandi-keystore--- | string | Android: Kata sandi penyimpanan keystore |
| ---konfigurasi-play--- | string | Android: Jalur ke akun JSON layanan Google Play |
| ---varian-android--- | string | Android: Variasi produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki beberapa varian. |
| ---prioritas-pembaruan-dalam-aplikasi--- | string | Android: Prioritas pembaruan dalam aplikasi Google Play untuk rilis masa depan (integer 0–5; semakin tinggi = semakin mendesak). Omit untuk meninggalkan nilai yang ada di Play tidak berubah. |
| ---local--- | boolean | Simpan ke .capgo-credentials.json di root proyek bukan ~/.capgo-credentials/ |
| ---output-upload | boolean | Upload hasil pembangunan (IPA/APK/AAB) ke penyimpanan Capgo dan cetak tautan download |
| ---no-output-upload | boolean | Tidak unggah hasil pembangunan (IPA/APK/AAB) ke penyimpanan Capgo |
| ---output-retention | string | Jangka waktu tautan hasil: 1 jam hingga 7 hari (default: 1 jam). Contoh: 1 jam, 6 jam, 2 hari |
| ---skip-build-number-bump | boolean | Lebihkan nomor pembangunan otomatis/code/versi pada pembangunan masa depan |
| ---no-skip-build-number-bump | boolean | Nonaktifkan kembali perilaku otomatis meningkatkan nomor pembangunan (perilaku default) |
| ---skip-marketing-version-bump | boolean | Lebihkan otomatis versi pemasaran pada pembangunan masa depan ketika aplikasi sudah dirilis |
| ---tidak-lompat-versi-pemasaran-bump | boolean | Mengaktifkan kembali versi pemasaran otomatis (pengaturan default) |
📋 Dapatkan Daftar
Judul bagian “ 📋 Daftar”npx @capgo/cli@latest build credentials listTampilkan kredit pembangunan yang disimpan (kata sandi tersembunyi). Menampilkan apa yang saat ini disimpan (baik global maupun lokal). Contoh: npx @capgo/cli build credentials list # Daftar semua aplikasi npx @capgo/cli build credentials list —appId com.example.app # Daftar aplikasi tertentu
Pilihan:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| appId | string | ID Aplikasi untuk menampilkan (opsional, menampilkan semua jika dihilangkan) |
| – lokal | boolean | Daftar kredential dari file lokal .capgo-credentials.json saja |
🔹 Bersihkan
Bab berjudul “ 🔹 Bersihkan”npx @capgo/cli@latest build credentials clearClear saved build credentials. Remove credentials from storage. Use —appId and —platform to target specific credentials. Examples: npx @capgo/cli build credentials clear # Clear all apps (global) npx @capgo/cli build credentials clear —local # Clear local credentials npx @capgo/cli build credentials clear —appId com.example.app —platform ios
Pilihan:
| Parameter | Jenis | Deskripsi |
|---|---|---|
| —ID Aplikasi | string | ID Aplikasi untuk dihapus (opsional, menghapus semua aplikasi jika tidak disebutkan) |
| —Platform | string | Platform untuk dihapus: ios atau android (opsional, menghapus semua platform jika tidak disebutkan) |
| —Local | boolean | Hapus dari file .capgo-credentials.json lokal daripada global |
🔹 Perbarui
Bab berjudul “ 🔹 Perbarui”npx @capgo/cli@latest build credentials updatePerbarui kreditan khusus tanpa menyediakan semuanya lagi. Perbarui kreditan yang sudah ada dengan menyediakan hanya bidang yang ingin diubah. Platform akan dideteksi secara otomatis dari opsi yang disediakan. Contoh: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks
Pilihan:
| Parameter | Jenis | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi (dipilih secara otomatis dari capacitor.config jika tidak disebutkan) |
| —platform | string | Platform: ios atau android (dipilih secara otomatis dari opsi) |
| —local | boolean | Perbarui file .capgo-credentials.json lokal daripada global |
| —certificate | string | Jalur ke file sertifikat P12 |
| —ios-provisioning-profile | string | Jalur profil pengaturan atau bundleId=path (ulangi, tambahkan secara default) |
| – overwrite-ios-provisioning-map | boolean | Ganti seluruh peta pengaturan iOS daripada menggabungkan (default: gabung) |
| – p12-password | string | Sandi sertifikat P12 |
| – apple-key | string | Jalur kunci App Store Connect API (.p8 file) |
| – apple-key-id | string | ID Kunci App Store Connect API |
| – apple-issuer-id | string | ID Pengeluarkan App Store Connect |
| – apple-team-id | string | ID Tim App Store Connect |
| —apple-id | string | iOS: Alamat email ID Apple untuk unggah password aplikasi khusus (alternatif untuk kunci App Store Connect API) |
| —apple-app-specific-password | string | iOS: Password aplikasi khusus (xxxx-xxxx-xxxx-xxxx) untuk unggah TestFlight |
| —apple-app-id | string | iOS: ID aplikasi App Store Connect numerik (diperlukan bersama dengan —apple-id dan —apple-app-specific-password) |
| —ios-distribution | string | iOS: Mode distribusi |
| —keystore | string | Jalur file keystore (.keystore atau .jks) |
| —keystore-alias | string | Alias kunci keystore |
| ---kunci-sandi-keystore | string | Kata sandi kunci keystore |
| ---kunci-sandi-toko-keystore | string | Kata sandi toko keystore |
| ---konfigurasi-play | string | Jalur ke akun JSON layanan Google Play |
| ---rasa-android | string | Android: Rasa produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki rasa yang berbeda. |
| ---prioritas-perbarui-dalam-aplikasi | string | Android: Prioritas perbarui dalam aplikasi Google Play untuk rilis masa depan (integer 0–5; semakin tinggi = lebih mendesak). |
| ---unggah-output | boolean | Muat naik hasil pembangunan (IPA/APK/AAB) ke penyimpanan Capgo dan cetak tautan download |
| ---tidak-muat-naik | boolean | Tidak muat naik hasil pembangunan (IPA/APK/AAB) ke penyimpanan Capgo |
| ---retensi-hasil | string | TTL tautan hasil: 1 jam hingga 7 hari. Contoh: 1 jam, 6 jam, 2 hari |
| ---lewatkan-angka-bangunan | boolean | Lebihkan secara otomatis angka bangunan versi code pada bangunan masa depan |
| ---aktifkan-lewatkan-angka-bangunan | boolean | Mengaktifkan kembali peningkatan angka bangunan secara otomatis (pengaturan default) |
| ---lewatkan-angka-versi-pemasaran | boolean | Lebihkan secara otomatis versi pemasaran pada bangunan masa depan ketika aplikasi sudah dirilis |
| ---aktifkan-lewatkan-angka-versi-pemasaran | boolean | Nonaktifkan kembali versi otomatis pemasaran (tingkah laku default) |
🔹 Kelola
Judul bagian “ 🔹 Kelola”npx @capgo/cli@latest build credentials manageKelola kredit konstruksi yang disimpan secara interaktif.
Lihat kredit yang tersimpan, lihat apa yang dikonfigurasi, ekspor file .env yang siap digunakan CI/CD,
atau hapus kredit platform. Menggunakan TUI yang sama seperti capgo init.
Contoh:
npx @capgo/cli build kredit konstruksi kelola
npx @capgo/cli build kredit konstruksi kelola —appId com.example.app
npx @capgo/cli build kredit konstruksi kelola —appId com.example.app —platform ios
npx @capgo/cli build kredit konstruksi kelola —local
Pilihan:
| Parameter | Jenis | Deskripsi |
|---|---|---|
| appId | string | ID Aplikasi untuk mengelola (opsional, meminta pilihan jika dihilangkan) |
| ---platform | string | Platform untuk mengelola: ios atau android (opsional, meminta pilihan jika dihilangkan) |
| ---local | boolean | Hanya lihat file lokal .capgo-credentials.json |
🔹 Migrasi
Bab berjudul “ Migrasi”npx @capgo/cli@latest build credentials migrateMigrasikan profil pengembangan lama ke format multi-target baru. Mengubah BUILD_PROVISION_PROFILE_BASE64 ke CAPGO_IOS_PROVISIONING_MAP. Mengenali ID bundle utama dari proyek Xcode Anda secara otomatis. npx @capgo/cli build credentials migrate —platform ios
Contoh:
Example:Pilihan:
| Param | Tipe | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi (ditebak dari capacitor.config jika tidak disebutkan) |
| —platform | string | Platform (hanya ios yang didukung) |
| —local | boolean | Migrasi dari lokal .capgo-credentials.json bukan global |