📦 bundel

📦 Pengelolaan paket aplikasi untuk pengiriman di Capgo Cloud, termasuk unggah, pengecekan kompatibilitas, dan enkripsi.

⬆️ Unggah

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Unggah paket aplikasi baru ke Capgo Cloud untuk distribusi. Versi harus > 0.0.0 dan unik. Versi yang dihapus tidak dapat digunakan kembali untuk keamanan. Opsi eksternal: Simpan hanya URL tautan (bermanfaat untuk aplikasi >200MB atau persyaratan privasi). Capgo tidak pernah memeriksa konten eksternal. Tambahkan enkripsi untuk keamanan tanpa kepercayaan.

Contoh:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

Tingkatkan versi semver berikutnya secara otomatis dari saluran (atau versi aplikasi remote terbaru) ketika Anda tidak menyertakan __CAPGO_KEEP_0__ --bundleBermanfaat dalam CI ketika __CAPGO_KEEP_0__ package.json Sudah sesuai dengan versi Capgo yang dimiliki __CAPGO_KEEP_1__:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Dengan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ AI Workers membandingkan file bundle lokal dengan manifest delta saluran sebelumnya __CAPGO_KEEP_2__, mengidentifikasi __CAPGO_KEEP_0__ --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata, and prints a short reason in the CLI log. If no previous Capgo version exists, AI is skipped and the bump defaults to Pilihan:.

Jendela terminal

Parameter	Tipe	Deskripsi
–a	string	API kunci untuk menghubungkan ke akun Anda
–p	string	Jalur folder untuk mengunggah, jika tidak disediakan akan menggunakan webDir yang ditetapkan di capacitor.config
–c	string	Saluran untuk menghubungkan. Gunakan koma untuk beberapa saluran, misalnya produksi,beta
–rollout	string	Tetapkan bundle yang diunggah sebagai target rollout saluran ini pada persentase dari 0 hingga 100
–rollout-percentage-bps	string	Setel persentase pengiriman bundle yang diunggah dalam basis poin dari 0 hingga 10000
– rollout-cache-ttl-detik	string	Cloudflare TTL cache keputusan pengiriman dalam detik
-e	string	Tautan ke URL eksternal daripada mengunggah ke Capgo Cloud
– iv-sesi-kunci	string	Setel kunci IV dan sesi untuk URL bundle eksternal
– s3-region	string	Wilayah untuk bucket S3 Anda
– s3-apikey	string	API kunci API untuk endpoint S3 Anda
– s3-apisecret	string	API rahasia untuk endpoint S3 Anda
– endpoint-s3	string	URL endpoint S3
– nama-bucket-s3	string	Nama untuk bucket S3 AWS Anda
– port-s3	string	Port untuk endpoint S3 Anda
– tidak-ssl-s3	boolean	Nonaktifkan SSL untuk unggah S3
– kunci-v2	string	Jalur kustom untuk kunci tanda tangan pribadi (sistem v2)
– data-kunci-v2	string	Kunci pribadi tanda tangan (sistem v2)
—bundle-url	boolean	Tampilkan URL bundle ke stdout
—no-key	boolean	Lupakan kunci tanda tangan dan kirim update jelas
—no-code-check	boolean	Lupakan memeriksa apakah notifyAppReady() dipanggil di sumber code dan indeks ada di folder root
—display-iv-session	boolean	Tampilkan di konsol kunci IV dan sesi yang digunakan untuk mengenkripsi update
-b	string	Nomor versi bundle yang akan diunggah
—auto-bump	string	Menggunakan otomatis dari bundle terkait saluran, jika tidak versi aplikasi remote terbaru. Tingkat: mayor, minor (default), patch (alias fix), metadata, atau ai (AI pekerja infers tingkat dari lokal vs delta manifest sebelumnya; kembali ke patch dengan versi sebelumnya Capgo tidak ada). Membangun hingga nama gratis ditemukan (nama yang dihapus tetap terisi). Tidak dapat digabungkan dengan —bundle (-b)
—tambahan	string	Tautan ke sumber daya eksternal (misalnya GitHub rilis)
—komentar	string	Komentar tentang versi ini, bisa saja catatan rilis, hash commit, pesan commit, dll.
—versi-minimum-update	string	Versi minimum yang diperlukan untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di saluran
—atur-versi-minimum-update-otomatis	boolean	Atur versi update minimum berdasarkan paket native
—abaikan-pemeriksaan-metadata	boolean	Mengabaikan pemeriksaan metadata (node_modules) saat mengunggah
—gagal-atas-inkompatibilitas	boolean	Jalankan ulang unggahan (keluar dengan kode tidak nol) daripada mengunggah ketika paket bundel tidak kompatibel dengan kanal paket native saat ini. Di terminal interaktif, Anda masih bisa memilih untuk membangun native; menolak gagal. Tidak bisa digabungkan dengan —ignore-metadata-check.
—ignore-checksum-check	boolean	Ignores cek checksum ketika mengunggah
—force-crc32-checksum	boolean	Force cek CRC32 checksum untuk unggahan (override deteksi otomatis)
—timeout	string	Waktu tunggu untuk proses unggahan dalam detik
—multipart	boolean	[DEPRECATED] Gunakan —tus sebaliknya. Gunakan protokol multipart untuk unggahan S3
—zip	boolean	Unggah paket bundel menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Unggah bundle menggunakan TUS ke Capgo cloud
—tus-chunk-size	string	Ukuran chunk dalam byte untuk TUS upload yang dapat diulang (default: otomatis)
—partial	boolean	[DEPRECATED] Gunakan —delta sebaliknya. Unggah update incremental
—partial-only	boolean	[DEPRECATED] Gunakan —delta-only sebaliknya. Unggah hanya update incremental, lewati bundle penuh
—delta	boolean	Unggah update delta (hanya file yang berubah) untuk update instan, sangat cepat sebaliknya dari download zip besar
—delta-only	boolean	Unggah hanya update delta tanpa bundle penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
—no-delta	boolean	Mengaktifkan pembaruan delta bahkan jika pembaruan instan diaktifkan
---enkripsi-checksum	string	Checksum terenkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal
---atur-bundle-otomatis	boolean	Mengatur bundle di capacitor.config.json
---unggah-bersih	boolean	Mengunggah proses bundle secara kering: menambahkan baris di database tanpa mengunggah file atau memperbarui saluran (Digunakan oleh Capgo untuk tes internal)
---json-package	string	Jalur file package.json untuk monorepos (dipisahkan koma)
---modul-node	string	Jalur direktori node_modules untuk monorepos (dipisahkan koma)
---enkripsi-sebagian	boolean	Enkripsi file update delta (otomatis diaktifkan untuk pengguna > 6.14.4)
—hapus-bundle-tersambung-pada-upload	boolean	Mencari bundle yang terkait saat ini di saluran yang Anda coba unggah, dan menghapusnya
—pattern-brotli-tidak-diizinkan	string	File untuk dikecualikan dari kompresi Brotli (globs terpisah dengan koma, misalnya “.jpg,.png”)
—nonaktifkan-brotli	boolean	Mengaktifkan kompresi Brotli secara keseluruhan bahkan jika versi pengguna mendukungnya
—versi-sudah-ada-oke	boolean	Keluar dengan sukses jika versi bundle sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
—tunjuk-ke-mu-lah	boolean	Izinkan perangkat untuk bergabung secara otomatis ke saluran ini (aturan saluran pembaruan)
—qr-preview	boolean	Tampilkan kode QR terminal untuk code pratinjau paket setelah unggah
—send-update-notification	boolean	Kirim notifikasi pembaruan native ke perangkat setelah memperbarui paket saluran terkait
—supa-host	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan sendiri)
—verbose	boolean	Aktifkan output yang lebih detail dengan logging yang lebih rinci

🧪 Kompatibilitas

npx @capgo/cli@latest bundle compatibility

Periksa kompatibilitas suatu bundle dengan saluran tertentu di Capgo Cloud untuk memastikan pembaruan aman.

Contoh:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

Pilihan:

Param	Tipe	Deskripsi
-a	string	API kunci untuk menghubungkan ke akun Anda
-c	string	Saluran untuk memeriksa konsistensi dengan
–teks	boolean	Tampilkan teks alih-alih emoji
–package-json	string	Jalur ke file package.json untuk proyek monorepo (dipisahkan koma)
–node-modules	string	Jalur ke direktori node_modules untuk proyek monorepo (dipisahkan koma)
–supa-host	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo pengembangan)
–supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk hosting sendiri)

🔹 Jenis Rilis

npx @capgo/cli@latest bundle releaseType

🧭 Cetak “native” atau “OTA” berdasarkan konsistensi dengan metadata terbaru suatu saluran.

Contoh:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

Opsi:

Parameter	Jenis	Deskripsi
-a	string	Kunci API untuk menghubungkan ke akun Anda
-c	string	Saluran untuk dibandingkan
—package-json	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)
—node-modules	string	Jalur ke direktori node_modules untuk repositori monorepo (dipisahkan koma)
—supa-host	string	URL host Supabase yang disesuaikan (untuk penggunaan self-hosting atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase (untuk hosting sendiri)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

Hapus bundle tertentu dari Capgo Cloud, dengan memilih versi tertentu.

Contoh:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

Pilihan:

Parameter	Tipe	Deskripsi
-a	string	Kunci API untuk menghubungkan ke akun Anda
—supa-host	string	URL host Supabase yang disesuaikan (untuk penggunaan sendiri atau pengembangan Capgo)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk penggunaan sendiri)

📋 Daftar

Alias: l

npx @capgo/cli@latest bundle list

📋 Daftar semua bundle yang diunggah untuk aplikasi di Capgo Cloud.

Contoh:

npx @capgo/cli@latest bundle list com.example.app

Pilihan:

Param	Tipe	Deskripsi
-a	string	API kunci untuk menghubungkan ke akun Anda
--supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
– supa-anon	string	Kunci Anon Supabase (untuk hosting sendiri)

🧹 Pembersihan

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Hapus bundle lama di Capgo Cloud, menyimpan jumlah versi terbaru yang ditentukan. Bundle yang terkait dengan saluran diselamatkan kecuali —ignore-channel digunakan.

Contoh:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Pilihan:

Param	Tipe	Deskripsi
-b	string	Nomor versi bundle aplikasi untuk dihapus
-a	string	API kunci untuk menghubungkan ke akun Anda
-k	string	Jumlah versi untuk disimpan
-f	boolean	Hapus paksa
—abaikan-channel	boolean	Hapus paket bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk hosting sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi paket zip untuk penyimpanan eksternal yang aman. Mengembalikan ivSessionKey untuk unggah/pengekripsi. Periksa checksum menggunakan ‘paket zip —json’.

Contoh:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

Pilihan:

Param	Tipe	Deskripsi
—kunci	string	Jalur khusus untuk kunci tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
-j	boolean	Keluaran dalam format JSON
---json-paket	string	Jalur ke file json-paket untuk repositori monorepo (dipisahkan koma)

🔓 Enkripsi

npx @capgo/cli@latest bundle decrypt

🔓 Enkripsi bundle yang dienkripsi (utamanya untuk pengujian). Tampilkan kunci sesi base64 untuk verifikasi.

Contoh:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

Pilihan:

Parameter	Tipe	Deskripsi
—kunci	string	Jalur kustom untuk kunci tanda tangan pribadi
—kunci-data	string	Kunci tanda tangan pribadi
—checksum	string	Checksum dari bundle, untuk memverifikasi integritas bundle
—package-json	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Buatlah file zip aplikasi Anda. Kembalikan checksum untuk penggunaan dengan enkripsi. Gunakan —json untuk output yang dapat dibaca oleh mesin.

Contoh:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Pilihan:

Parameter	Jenis	Deskripsi
-p	string	Jalur folder untuk diunggah, jika tidak disediakan maka akan menggunakan webDir yang ditetapkan di capacitor.config
-b	string	Nomor versi bundle untuk menamai file zip
-n	string	Nama file zip
-j	boolean	Tampilkan dalam format JSON
—no-code-check	boolean	Tidak periksa panggilan notifyAppReady() di sumber code dan index yang ada di folder root
—key-v2	boolean	Gunakan enkripsi v2
—package-json	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)