📦 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 tautan URL (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 menyediakan __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__, menginfer __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:.

__CAPGO_KEEP_0__

Parameter	Tipe	Deskripsi
–a	string	API kunci untuk menghubungkan ke akun Anda
–p	string	Jalur folder untuk diunggah, jika tidak disediakan akan menggunakan webDir yang ditetapkan di capacitor.config
–c	string	Saluran untuk dihubungkan. 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	Atur persentase pengiriman bundle yang telah diunggah dalam basis poin dari 0 hingga 10000
—rollout-cache-ttl-seconds	string	Cloudflare TTL cache keputusan pengiriman dalam detik
-e	string	Tautan ke URL eksternal daripada mengunggah ke Capgo Cloud
—iv-session-key	string	Atur kunci IV dan session untuk URL bundle eksternal
—s3-region	string	Wilayah untuk bucket S3 Anda
—s3-apikey	string	API kunci 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 ke S3
– kunci-v2	string	Jalur kustom untuk kunci tanda tangan pribadi (sistem v2)
– kunci-data-v2	string	Kunci pribadi tanda tangan (sistem v2)
—bundle-url	boolean	Tampilkan URL bundle ke stdout
—no-key	boolean	Abai kunci tanda tangan dan kirim update jelas
—no-code-check	boolean	Abai 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 dari bundle yang akan diunggah
—auto-bump	string	Otomatisk meningkatkan dari paket terkait saluran, jika tidak maka 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). Meningkatkan hingga nama gratis ditemukan (nama yang dihapus tetap terisi). Tidak dapat digabungkan dengan —paket (-b)
---tambahan	string	Tautkan 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
---otomatis-minimum-versi-update	boolean	Setel versi update minimum berdasarkan paket native
---abaikan-periksa-metadata	boolean	Mengabaikan periksa metadata (node_modules) saat mengunggah
---gagal-atas-inkompatibilitas	boolean	Jangan unggah (keluar dengan kode non-nol) ketika bundel tidak kompatibel dengan paket native saluran saat ini. Di terminal interaktif, Anda masih bisa memilih untuk membangun native; menolak akan gagal. Tidak bisa digabungkan dengan —ignore-metadata-check.
—ignore-checksum-check	boolean	Melupakan periksa checksum ketika mengunggah
—force-crc32-checksum	boolean	Force CRC32 checksum untuk unggah (mengatasi deteksi otomatis)
—timeout	string	Waktu tunggu untuk proses unggah dalam detik
—multipart	boolean	[DEPRECATED] Gunakan —tus sebaliknya. Menggunakan protokol multipart untuk unggah ke S3
—zip	boolean	Unggah bundel menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Upload 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 saja. Upload update incremental
–partial-only	boolean	[DEPRECATED] Gunakan –delta-only saja. Upload hanya update incremental, lewati bundle penuh
–delta	boolean	Upload update delta (hanya file yang berubah) untuk update instan, sangat cepat, bukan download zip besar
–delta-only	boolean	Upload 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 bersih: menambahkan baris di database tanpa mengunggah file atau memperbarui saluran (Digunakan oleh Capgo untuk tes internal)
---json-package	string	Jalur file package.json untuk repositori monorepo (dipisahkan koma)
---modul-node	string	Jalur direktori node_modules untuk repositori monorepo (dipisahkan koma)
---enkripsi-sebagian	boolean	Enkripsi file update delta (otomatis diaktifkan untuk pengguna > 6.14.4)
–hapus-bundel-tersambung-pada-upload	boolean	Mencari bundel yang terkait saat ini di saluran yang Anda coba unggah, dan menghapusnya
–tidak-aktifkan-polanya-brotli	string	File untuk dikecualikan dari kompresi Brotli (globs terpisah dengan koma, misalnya ".jpg,.png")
–matikan-brotli	boolean	Mengaktifkan kompresi Brotli secara keseluruhan bahkan jika versi pengguna mendukungnya
–versi-sudah-ada-oke	boolean	Keluar dengan sukses jika versi bundel sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
–tugaskan-ke-mu-lah	boolean	Biarkan perangkat bergabung secara otomatis ke saluran ini (aturan saluran update)
–qr-preview	boolean	Tampilkan kode QR terminal untuk code pratinjau paket setelah unggah
–send-update-notification	boolean	Kirim notifikasi periksa update asli ke perangkat setelah mengupdate paket saluran terkait
–supa-host	string	URL host Supabase yang disesuaikan (untuk penggunaan sendiri atau Capgo pengembangan)
–supa-anon	string	Kunci anonim Supabase yang disesuaikan (untuk penggunaan sendiri)
–verbose	boolean	Aktifkan output yang lebih detail dengan logging yang lebih rinci

🧪 Kompabilitas

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 output daripada 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 (untuk hosting sendiri)

🔹 Jenis Rilis

npx @capgo/cli@latest bundle releaseType

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

Contoh:

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

Pilihan:

Param	Tipe	Deskripsi
-a	string	API kunci 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 pengembangan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase (untuk hosting sendiri)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

Hapus 🗑️ sebuah bundle tertentu dari Capgo Cloud, dengan kemungkinan menargetkan versi tunggal.

Contoh:

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

Pilihan:

Parameter	Tipe	Deskripsi
-a	string	API kunci untuk menghubungkan ke akun Anda
—supa-host	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan 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	URL Host Supabase Pribadi (untuk penggunaan sendiri atau pengembangan Capgo)
—supa-anon	string	Kunci Anon Supabase (untuk penggunaan sendiri)

🧹 Membersihkan

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Hapus bundle lama di Capgo Cloud, menjaga 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 yang harus disimpan
-f	boolean	Hapus paksa
—abaikan-channel	boolean	Hapus paket bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL host Supabase yang disesuaikan (untuk hosting sendiri atau pengembangan Capgo)
—supa-anon	string	Kunci anonim Supabase yang disesuaikan (untuk hosting sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi paket zip untuk penyimpanan eksternal yang aman. Kembalikan ivSessionKey untuk unggah/decryption. 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
—file-package-json	string	Jalur ke file package.json untuk monorepos (dipisahkan koma)

🔓 Mengamankan

npx @capgo/cli@latest bundle decrypt

Mengamankan sebuah bundle yang dienkripsi (utamanya untuk pengujian). Mencetak 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 privat
—kunci-data	string	Kunci tanda tangan privat
—checksum	string	Checksum dari bundle, untuk memverifikasi integritas bundle
—package-json	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)

🔹 Arsip 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 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	Abaikan pengecekan apakah notifyAppReady() dipanggil di sumber code dan indeks ada di folder root
—key-v2	boolean	Gunakan enkripsi v2
—package-json	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)