🔹 Bangun
Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.
🏗️ Atur bangunan iOS/Android asli melalui Capgo Cloud.
Akses dan keluaran bangun
Bab berjudul “Akses dan keluaran bangun”Bangunan cloud asli tersedia di setiap Capgo rencana. Kredensial bangun tidak pernah disimpan di Capgo server: mereka digunakan hanya untuk bangun dan kemudian dihapus. Keluaran bangun dapat diunggah secara opsional dengan tautan unduh sementara waktu.
Simpan kredensial terlebih dahulu
Bab berjudul “Simpan kredensial 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 keluaran di CI
Bagian berjudul “Tangkap URL keluaran 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
Bagian berjudul “ 🔹 Diperlukan”npx @capgo/cli@latest build needed🧭 Cetak "ya" dan keluar dengan code 1 jika pembangunan asli diperlukan; lainnya cetak "tidak" dan keluar dengan code 0. Kegagalan perintah keluar dengan code 2.
Contoh:
npx @capgo/cli@latest build needed com.example.app --channel production --verbosePilihan:
| Param | Tipe | Deskripsi |
|---|---|---|
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| -c | string | Saluran untuk dibandingkan. Default ke CapacitorUpdater.defaultChannel atau saluran publik default |
| ---json-paket | string | Jalur ke file json-paket untuk repositori monorepo (dipisahkan koma) |
| ---modul-node | string | Jalur ke direktori node_modules untuk repositori monorepo (dipisahkan koma) |
| ---verbose | boolean | Tampilkan output detail dengan log yang lebih banyak |
| ---host-supabase | string | URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo) |
| ---anon-supabase | string | Custom Supabase anon key (for self-hosting) |
Alias: onboarding
npx @capgo/cli@latest build initKonfigurasi kredit pembangunan secara interaktif (iOS: sertifikat + profil otomatis; Android: keystore + Google OAuth menyediakan akun layanan GCP dan undang ke Play Console)
Options:
| Param | Tipe | Deskripsi |
|---|---|---|
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| -p | string | Platform untuk mendaftar (ios atau android). Jika tidak ada, mendeteksi otomatis ketika hanya ada satu folder asli; meminta lainnya. |
| —host-supabase | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| —no-analytics | boolean | Matikan analitik pembangunan dan ulang terminal untuk jalankan ini |
🔹 Pilih
Bab berjudul “ Pilih”npx @capgo/cli@latest build requestPilih untuk mendapatkan build asli 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 .Opsi:
| Param | Tipe | Deskripsi |
|---|---|---|
| —path | string | Jalur ke direktori proyek untuk dibangun (default: direktori saat ini) |
| —node-modules | string | Jalur ke direktori node_modules untuk repositori monorepo (dipisahkan koma) |
| —platform | string | Platform target: ios atau android (wajib) |
| —mode-pembangunan | string | Pembangunan mode: debug atau rilis (default: rilis) |
| —sertifikat-base64 | string | iOS: Sertifikat .p12 yang dikodekan dalam Base64 |
| —kata-sandi-p12 | string | iOS: Kata sandi sertifikat (opsional jika sertifikat tidak memiliki kata sandi) |
| —id-apple | string | iOS: Alamat email ID Apple untuk unggah kata sandi aplikasi (alternatif dari API kunci App Store Connect) |
| —kata-sandi-aplikasi-apple | string | iOS: Kata sandi aplikasi (xxxx-xxxx-xxxx-xxxx) untuk unggah TestFlight |
| —id-aplikasi-apple | string | iOS: ID aplikasi numerik App Store Connect (diperlukan bersamaan dengan —id-apple dan —kata-sandi-aplikasi-apple) |
| —apple-key-id | string | iOS: App Store Connect API ID Pengembang |
| —apple-issuer-id | string | iOS: ID Pengembang 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: Skema 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 Pengaturan 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 Toko Keystore |
| —play-config-json | string | Android: JSON akun layanan Google Play yang dikodekan Base64 |
| —rasa-android | string | Android: Rasa produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki rasa yang berbeda |
| —track-android | string | Android: Track Google Play untuk unggahan ini (internal, alpha, beta, produksi). Default tanpa —submit-to-store-review: internal. Dengan —submit-to-store-review dan tidak ada track yang ditetapkan: produksi. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —status-publikasi-android | string | Android: Status publikasi Google Play (draft, selesai, inProgress, dihentikan). Default tanpa —submit-to-store-review: draft. Dengan —submit-to-store-review dan tidak ada status yang ditetapkan: selesai. Prioritas: CLI > lingkungan > kredit yang disimpan |
| —prioritas-update-antar-aplikasi | string | Android: Prioritas update antar-aplikasi 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 |
| –tidak-unggah-play-store | boolean | Skip unggah Play Store untuk build ini (membatalkan konfigurasi Play yang disimpan). Memerlukan —output-upload. |
| –kirim-ke-pengujian-toko | boolean | Setelah unggah, kirim rilis toko untuk pengujian alih-alih meninggalkannya sebagai draft/bangun aktif. Pada Android ini berarti track 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 pengujian App Store. |
| –nama-rilis-toko | string | Label nama rilis versi toko. Android mengirimkan ini sebagai versi Google Play; iOS menggunakan ini sebagai versi App Store ketika membuat atau menggunakan versi yang dapat diedit. |
| –catatan-rilis-toko | string | Catatan rilis toko default. Android menggunakan ini sebagai catatan perubahan Play; iOS menggunakan ini sebagai teks 'Apa Baru' App Store yang dapat digunakan sebagai pengganti. |
| –catatan-rilis-toko-lokasi | string | Catatan rilis toko yang diterjemahkan (berulang), misalnya —catatan-rilis-toko-lokasi en-US=“Pembaruan bug” —catatan-rilis-toko-lokasi fr-FR=“Corrections”. |
| —ios-testflight-groups | string | Pada iOS: nama atau ID kelompok eksternal TestFlight opsional yang dipisahkan koma untuk distribusi beta eksternal. |
| – ios-otomatis-rilis | boolean | iOS: rilis otomatis versi App Store setelah persetujuan Apple. Default adalah rilis manual. |
| – no-ios-otomatis-rilis | boolean | iOS: biarkan versi App Store menunggu rilis manual setelah 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 | Atur TTL link keluaran untuk build ini saja (1 jam hingga 7 hari). Contoh: 1 jam, 6 jam, 2 hari. Prioritas: CLI > lingkungan > kredit yang disimpan |
| – output-record | string | Setelah build sukses, tulis rekaman JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) ke sebuah path. Selain itu, juga ditulis PNG QR code di samping path tersebut dengan .qr.png suffix. Baca kembali field dengan build last-output. |
| —no-cache | boolean | Lebihkan penggunaan cache pembangunan dan Jangan menyimpan entri cache baru untuk build ini. Cache build diaktifkan secara default per aplikasi. |
| —cache-key | string | Bagi cache pembangunan berdasarkan lingkungan, cabang, atau rasa Android (misalnya) prod, stagingOmit untuk satu cache default bersama per aplikasi. |
| —no-skip-build-number-bump | boolean | Atur kembali kreditensial yang disimpan untuk mengaktifkan kembali otomatis peningkatan nomor build untuk build ini saja. |
| —skip-marketing-version-bump | boolean | Tidak otomatis meningkatkan versi pemasaran (CFBundleShortVersionString / versionName) ketika aplikasi sudah dirilis. |
| –sync-versi-ios | boolean | iOS: sinkronkan MARKETING_VERSION Xcode dari package.json sebelum mengunggah proyek. |
| –ai-analitik | boolean | Pada gagal build, kirim log ke Capgo AI untuk diagnosis. Di terminal interaktif ini melompati konfirmasi awal; di CI ini mengunggah otomatis dan mencetak analisis ke stderr. |
| –tidak-scan-awal | boolean | Lebihkan sken pra-build otomatis |
| –scan-awal-abaikan-fatal | boolean | Lakukan sken pra-build tetapi tidak pernah menghalangi build (laporkan hanya) |
| –lewatkan-scan-awal | string | Lebihkan sken pra-build tertentu dengan id (berulang atau dipisahkan koma). Sken lainnya masih berjalan. |
| —prescan-warn | string | Turunkan sken pra-build tertentu ke peringatan dengan id (berulang atau dipisahkan koma). Sken masih berjalan. |
| —fail-on-warnings | boolean | Tangani peringatan prescan sebagai fatal |
| ---kirim-log-ke-dukungan | boolean | Pada gagal bangun CI/CD, secara otomatis unggah log bangun ke Capgo dukungan (tidak memerlukan email). Capgo dukungan akan diinformasikan dan akan mengikuti up dengan email. Menambahkan ke —ai-analytics. |
| ---kirim-log | boolean | Alias deprecasi untuk —kirim-log-ke-dukungan |
| -a | string | API kunci untuk menghubungkan ke akun Anda |
| ---host-supabase | string | URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo pengembangan) |
| ---anon-supabase | string | Custom Supabase anon key (for self-hosting) |
| —verbose | boolean | Aktifkan output detail dengan verbose |
Cache Pembangunan: Capgo memulihkan dan menyimpan artefak native yang dikompilasi (CocoaPods, Gradle, dan hasil terkait) per aplikasi secara default. Gunakan --cache-key untuk memisahkan cache RC dan produksi; gunakan --no-cache untuk membersihkan build satu kali. Integrasi API dapat melewatkan cache_key atau cache_enabled: false dalam permintaan payload build. Lihat Katalog Pemuatan Build cache Mengatasi Masalah: Pemulihan Cache Salah.
🔹 Sync-ios-version
Judul Bagian berjudul “ 🔹 Sinkronisasi-versi-ios”npx @capgo/cli@latest build sync-ios-versionSinkronkan versi iOS Xcode MARKETING_VERSION dari package.json.
Contoh:
npx @capgo/cli@latest build sync-ios-version --path .Pilihan:
| Param | Tipe | Deskripsi |
|---|---|---|
| —path | string | Alamat direktori proyek (default: direktori saat ini) |
| –check | boolean | Cek saja; keluar dengan kode non-nol ketika MARKETING_VERSION tidak sinkron |
🔹 Prescan
Bab berjudul “ 🔹 Prescan”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 sinkron, tata letak node_modules), dan konfigurasi platform. Berjalan secara otomatis di dalam build request; perintah ini menjalankannya secara mandiri (misalnya di CI).
Lihat Pengecekan Awal untuk katalog cek lengkap dan cara --skip / --warn aturan individu.
Opsi:
| Param | Tipe | Pengenalan |
|---|---|---|
| Deskripsi | string | Platform target: ios atau android (wajib) |
| —path | string | Direktori proyek (default: direktori saat ini) |
| -a | string | Kunci API untuk menghubungkan ke akun Anda |
| —android-flavor | string | Android: pilihan produk yang akan digunakan untuk membangun |
| ---dist-ios | string | iOS: mode distribusi untuk memvalidasi terhadap |
| ---json | boolean | Tampilkan laporan JSON yang dapat dibaca mesin |
| ---fail-on-warnings | boolean | Keluar dengan kode non-nol ketika ditemukan peringatan (CI) |
| ---ignore-fatal | boolean | Mode diagnostik: laporan semua tetapi selalu keluar dengan kode 0 |
| ---skip | string | Lebihkan periksaan tertentu dengan id (ulangi atau terpisah koma) |
| ---warn | string | Turunkan periksaan tertentu ke peringatan dengan id (ulangi atau terpisah koma) |
| —verbose | boolean | Memperbesar output dengan log yang lebih detail |
| —supa-host | string | URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo) |
| —supa-anon | string | Custom Supabase anon key (for self-hosting) |
🔹 Last-output
Bab berjudul “ 🔹 Last-output”npx @capgo/cli@latest build last-outputBaca catatan output pembangunan yang ditulis oleh pembangunan sebelumnya build request --output-record.
Tampilkan JSON penuh secara default, bidang tunggal dengan —field, atau kode QR ASCII
code dengan —qr. Berguna di CI untuk mengambil URL download atau QR untuk diposting kembali
ke PR atau masalah.
Contoh:
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
Opsi:
| Param | Tipe | Pengenalan |
|---|---|---|
| Deskripsi | string | Path ke rekaman JSON yang ditulis oleh —output-record (wajib) |
| —field | string | Tampilkan satu field (salah satu: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Tampilkan kode QR ASCII yang di-render code (singkatan dari —field qrCodeAscii) |
🔹 Credentials
Bagian berjudul “ 🔹 Kredensial”🔒 KEAMANAN: Manajemen kredit pembangunan yang disimpan secara lokal di mesin Anda.
- Kredensial yang disimpan ke ~/.capgo-credentials/credentials.json (global) atau .capgo-credentials.json (local)
- Ketika pembangunan, dikirim ke Capgo tetapi TIDAK pernah disimpan secara permanen.
- Dihapus dari Capgo segera setelah pembangunan.
- Hasil pembangunan mungkin dapat diunggah secara opsional untuk tautan download sementara 📚 DOKUMENTASI: iOS setup: https://capgo.app/docs/cli/build-cloud-ios/ Pengaturan Android: https://capgo.app/docs/cli/build-cloud-android/
🔹 Apple-key
Bagian berjudul “ 🔹 Apple-key”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyBuat tim App Store Connect dengan kunci API menggunakan bantuan macOS yang diarahkan (hanya macOS). Membuka jendela native yang memandu Anda melalui antarmuka UI App Store Connect Apple dalam browser yang diintegrasikan, menangkap secara otomatis ID Issuer + ID Kunci, menangkap kode satu kali .p8, memvalidasinya terhadap Apple, dan menyimpannya ke ~/.appstoreconnect/private_keys. Statistik kemajuan dikirimkan ke Capgo analitis (nonaktifkan dengan CAPGO_DISABLE_TELEMETRY). npx @capgo/cli bangun kredit build apple-key —appId com.example.app
Contoh:
Example:Pilihan:
| Parameter | Jenis | Description |
|---|---|---|
| Deskripsi | string | Kunci API untuk menghubungkan ke akun Anda |
| —appId | string | Simpan kunci yang ditangkap ke kredensial build iOS aplikasi ini |
| --- lokal | boolean | Simpan ke file .capgo-credentials.json per-proyek daripada file global |
| --- JSON | boolean | Tampilkan kunci ID / ID Issuer / jalur .p8 sebagai JSON |
🔹 Simpan
Bagian berjudul “ 🔹 Simpan”npx @capgo/cli@latest build credentials saveSimpan kredit pembangunan secara lokal untuk iOS atau Android. Kredit disimpan di:
- ~/.capgo-kredensial/credentials.json (default, global)
- .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/build-cloud-ios/
Android: https://capgo.app/docs/cli/build-cloud-android/
npx @capgo/cli build credentials simpan —platform ios
—sertifikat ./cert.p12 —kunci-p12 “password”
—profil-provinsi-ios ./profile.mobileprovision
—kunci-apple ./AuthKey.p8 —kunci-apple-id “KEY123”
—id-issuer-apple “issuer-uuid” —id-teams-apple “team-id” Contoh Multi-target (aplikasi + ekstensi widget): npx @capgo/cli build credentials save —platform ios
—profil-provinsi-ios ./App.mobileprovision
—profil-provinsi-ios com.example.widget=./Widget.mobileprovision
npix @capgo/cli build kreditensi simpan —platform android
—keystore ./release.keystore —alias-keystore “my-key”
—kunci-sandi-keystore “kunci-pass”
—konfigurasi-play ./service-account.json Penyimpanan lokal (per-proyek): npx @capgo/cli build kreditel save —local —platform ios …
Contoh:
iOS Example:Pilihan:
| Param | Tipe | context |
|---|---|---|
| Pengenalan: | string | ID Aplikasi (misalnya, com.example.app) (wajib) |
| —platform | string | Platform: ios atau android (wajib) |
| --- sertifikat | string | iOS: Jalur file sertifikat .p12 |
| --- profil-penyediaan-ios | string | iOS: Jalur profil penyediaan atau bundleId=path (ulangi) |
| --- kata-sandi-p12 | string | iOS: Kata sandi sertifikat (opsional jika sertifikat tidak memiliki kata sandi) |
| --- kunci-apple | string | iOS: Jalur file kunci App Store Connect .p8 API |
| --- kunci-apple-id | string | iOS: ID Kunci App Store Connect API |
| --- id-penerbit-apple | string | iOS: ID Pengembang App Store Connect |
| —apple-team-id | string | iOS: ID Tim Pengembang App Store Connect |
| —ios-distribution | string | iOS: Mode Distribusi |
| —apple-id | string | iOS: Alamat Email ID Apple untuk unggah password aplikasi khusus (alternatif untuk kunci API App Store Connect) |
| —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) |
| —keystore | string | Android: Lokasi file keystore (.keystore atau .jks) |
| ---keystore-alias--- | string | Android: Alias kunci keystore |
| ---keystore-key-password--- | string | Android: Kata sandi kunci keystore |
| ---keystore-store-password--- | string | Android: Kata sandi toko keystore |
| ---play-config--- | string | Android: Lokasi file JSON akun layanan toko Play |
| ---android-flavor--- | string | Android: Rasa produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki beberapa rasa. |
| ---in-app-update-priority--- | string | Prioritas pembaruan dalam aplikasi Google Play untuk rilis masa depan (integer 0–5; semakin tinggi = lebih mendesak). Omit untuk meninggalkan nilai Play yang ada tidak berubah. |
| — lokal | boolean | Simpan ke .capgo-credentials.json di root proyek bukan ~/.capgo-credentials global |
| — output-upload | boolean | Unggah hasil pembangunan (IPA/APK/AAB) ke Capgo penyimpanan dan cetak tautan download |
| — no-output-upload | boolean | Tidak unggah hasil pembangunan (IPA/APK/AAB) ke Capgo penyimpanan |
| — output-retention | string | Output link TTL: 1h to 7d (default: 1h). Examples: 1h, 6h, 2d |
| — skip-build-number-bump | boolean | Lebihkan nomor pembangunan otomatis versi code pada pembangunan masa depan |
| — no-skip-build-number-bump | boolean | Mengaktifkan kembali peningkatan nomor build otomatis (pengaturan default) |
| –skip-marketing-version-bump | boolean | Melewatkan peningkatan versi pemasaran otomatis pada build masa depan ketika aplikasi sudah dirilis |
| –no-skip-marketing-version-bump | boolean | Mengaktifkan kembali peningkatan versi pemasaran otomatis (pengaturan default) |
📋 Daftar
Judul bagian “ 📋 Daftar”npx @capgo/cli@latest build credentials listMenampilkan daftar kredit build yang disimpan (kata sandi disembunyikan). Menampilkan apa saja kredit yang disimpan saat ini (baik global maupun lokal). Contoh: npx @capgo/cli build kredit daftar # Menampilkan semua aplikasi npx @capgo/cli build kredit daftar –appId com.example.app # Menampilkan aplikasi tertentu
Pilihan:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi untuk Daftar (opsional, daftar semua jika dihilangkan) |
| —local | boolean | Daftar kredential dari lokal .capgo-credentials.json saja |
🔹 Bersihkan
Bagian 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
—platform
| Parameter | Jenis | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi untuk dihapus (opsional, menghapus semua aplikasi jika tidak ada) |
| —platform | string | Platform untuk dihapus: ios atau android (opsional, menghapus semua platform jika tidak disebutkan) |
| —local | boolean | Menghapus dari file lokal .capgo-credentials.json daripada global |
🔹 Pembaruan
Bab berjudul “ Pembaruan”npx @capgo/cli@latest build credentials updatePerbarui kreditensi tertentu tanpa menyediakan semuanya lagi. Perbarui kreditensi yang sudah ada dengan menyediakan hanya bidang yang ingin Anda ubah. Platform akan dideteksi secara otomatis dari opsi yang Anda berikan. Contoh: npx @capgo/cli build kreditensi update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build kreditensi update —local —keystore ./new-keystore.jks
Pilihan:
| Parameter | Tipe | Description |
|---|---|---|
| Deskripsi | string | ID Aplikasi (ditebak dari capacitor.config jika tidak disebutkan) |
| —platform | string | Platform: ios atau android (ditebak dari pilihan) |
| —local | boolean | Perbarui file .capgo-credentials.json lokal daripada global |
| ---sertifikat | string | Jalur file sertifikat P12 |
| —ios-provisioning-profile | string | Jalur profil provisioning atau bundleId=path (dapat diulang, menambahkan secara default) |
| ---ganti-provisi-ios-map | boolean | Ganti seluruh peta provisioning daripada menggabungkan (default: gabung) |
| ---kata-sandi-p12 | string | Kata sandi sertifikat P12 |
| ---kunci-apple | string | Jalur kunci App Store Connect API (.p8 file) |
| ---kunci-apple-id | string | ID Kunci App Store Connect API |
| ---penerbit-apple-id--- | string | ID Penerbit App Store Connect |
| ---tim-apple-id--- | string | ID Tim App Store Connect |
| —apple-id | string | iOS: Alamat email ID Apple untuk unggah password aplikasi khusus (alternatif ke kunci API App Store Connect) |
| ---password-apple-app-tertentu--- | string | iOS: Password aplikasi khusus (xxxx-xxxx-xxxx-xxxx) untuk unggah TestFlight |
| ---id-apple-app--- | string | iOS: ID aplikasi numerik App Store Connect (diperlukan bersamaan dengan ---penerbit-apple--- dan ---password-apple-app-tertentu---) |
| ---distribusi-ios--- | string | iOS: Mode distribusi |
| —keystore | string | Jalur file keystore (.keystore atau .jks) |
| —keystore-alias | string | Alias kunci keystore |
| —keystore-key-password | string | Kata sandi kunci keystore |
| —keystore-store-password | string | Kata sandi penyimpanan keystore |
| —play-config | string | Jalur file akun layanan Google Play JSON |
| —android-flavor | string | Android: Rasa produk untuk dibangun (misalnya produksi). Diperlukan jika proyek Anda memiliki rasa yang berbeda. |
| ---prioritas-update-aplikasi | string | Android: Prioritas update aplikasi Google Play untuk rilis masa depan (integer 0–5; semakin tinggi = semakin mendesak). |
| ---unggah-output | boolean | Unggah hasil pembangunan (IPA/APK/AAB) ke Capgo penyimpanan dan cetak tautan download |
| ---tidak-unggah-output | boolean | Tidak unggah hasil pembangunan (IPA/APK/AAB) ke Capgo penyimpanan |
| —output-retention | string | TTL link keluaran: 1 jam hingga 7 hari. Contoh: 1 jam, 6 jam, 2 hari. |
| ---lewatkan-increment-nomor-build | boolean | Lewatkan otomatis meningkatkan nomor build versi code pada pembangunan masa depan |
| ---tidak-lewatkan-increment-nomor-build | boolean | Kembalikan perilaku otomatis meningkatkan nomor build (perilaku default) |
| —lewatkan-penambahan-versi-pemasaran | boolean | Skip otomatisasi penambahan versi pemasaran di masa depan ketika aplikasi sudah dirilis |
| —tidak-lewatkan-penambahan-versi-pemasaran | boolean | Re-enable otomatisasi penambahan versi pemasaran ( perilaku default ) |
🔹 Pengaturan
Judul bagian “ 🔹 Pengaturan”npx @capgo/cli@latest build credentials manageMenangani kredit pembangunan disimpan secara interaktif.
Lihat kredit yang disimpan, 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 pengaturan manage
npx @capgo/cli build kredit pengaturan manage —appId com.example.app
npx @capgo/cli build kredit pengaturan manage —platform ios
npx @capgo/cli build kredit pengaturan manage —local
Pilihan:
| Parameter | Tipe | Deskripsi |
|---|---|---|
| —appId | string | ID Aplikasi untuk mengelola (opsional, meminta memilih jika dihilangkan) |
| —platform | string | Platform untuk mengelola: ios atau android (opsional, meminta memilih jika dihilangkan) |
| —local | boolean | Hanya menjelajahi lokal .capgo-credentials.json |
🔹 Migrasi
Balk Berjudul “ Migrasi”npx @capgo/cli@latest build credentials migrateMigrasikan profil pengaturan warisan ke format multi-target baru. Mengubah BUILD_PROVISION_PROFILE_BASE64 menjadi CAPGO_IOS_PROVISIONING_MAP. Mengenali ID aplikasi utama dari proyek Xcode Anda secara otomatis. npx @capgo/cli build kredit migrasi —platform ios
Contoh:
Example:Pilihan:
| Param | Tipe | context |
|---|---|---|
| Deskripsi | string | ID Aplikasi (ditebak dari capacitor.config jika tidak disebutkan) |
| —platform | string | Platform (hanya ios yang didukung) |
| —local | boolean | Migrasikan dari lokal .capgo-credentials.json daripada global |