📦 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. Option 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

Membuat versi semver berikutnya yang gratis dari saluran (atau versi aplikasi remote terbaru) ketika Anda tidak memasukkan --bundleTerbaik digunakan di CI ketika package.json sudah sesuai dengan versi Capgo yang telah ada:

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 --auto-bump ai, Capgo Cloudflare AI Workers membandingkan file bundle lokal dengan manifest delta saluran sebelumnya Capgo, menginterpretasikan major | minor | patch | metadata, dan mencetak alasan singkat di CLI log. Jika tidak ada versi Capgo sebelumnya, AI dilewati dan bump default ke patch.

Pilihan:

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	Atur persentase pengiriman bundle yang diunggah dalam basis poin dari 0 hingga 10000
—rollout-cache-ttl-seconds	string	Cloudflare TTL kunci keputusan pengiriman dalam detik
-e	string	Tautan ke URL eksternal daripada mengunggah ke Capgo Cloud
—iv-session-key	string	Atur kunci IV dan sesi 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
—s3-endpoint	string	URL endpoint S3
—nama-bucket-s3	string	Nama untuk bucket S3 AWS Anda
—s3-port	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)
—kunci-data-v2	string	Kunci pribadi tanda tangan (sistem v2)
—bundle-url	boolean	Cetak 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 yang akan diunggah
—auto-bump	string	Auto-increment dari bundle terkait saluran, jika tidak maka versi aplikasi remote terbaru. Tingkat: mayor, minor (default), patch (alias fix), metadata, atau ai (AI Workers menerjemahkan tingkat dari manifest lokal vs delta sebelumnya; kembali ke patch jika tidak ada versi sebelumnya Capgo). Bumps hingga nama gratis ditemukan (nama yang dihapus tetap dipakai). Tidak dapat digabungkan dengan —bundle (-b)
–tautan	string	Tautan ke sumber 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-minimum-versi-update-otomatis	boolean	Setel versi update minimum berdasarkan paket native
–abaikan-pemeriksaan-metadata	boolean	Mengabaikan pemeriksaan metadata (node_modules) saat mengunggah
–gagal-atas-inkompatibilitas	boolean	Kegagalan mengunggah (keluar dengan kode non-nol) daripada mengunggah ketika paket bundel tidak kompatibel dengan paket native saluran saat ini. Dalam terminal interaktif, Anda masih bisa memilih build 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 unggah (override deteksi otomatis)
—timeout	string	Waktu tunggu untuk proses unggah dalam detik
—multipart	boolean	[DEPRECATED] Gunakan —tus sebaliknya. Menggunakan protokol multipart untuk unggah S3
—zip	boolean	Mengunggah paket bundel menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Upload bundle menggunakan TUS ke Capgo cloud
ukuran chunk dalam byte untuk upload TUS yang dapat diulang (default: otomatis)	string	DEPRECATED: Gunakan —delta saja. Upload update incremental
Upload hanya update incremental, lewati bundle penuh	boolean	DEPRECATED: Gunakan —delta-only saja. Upload hanya update incremental, lewati bundle penuh
Upload update delta (hanya file yang berubah) untuk update instan, sangat cepat	boolean	Upload hanya update delta tanpa bundle penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
Tidak upload update delta	boolean	ukuran chunk dalam byte untuk upload TUS yang dapat diulang (default: otomatis)
DEPRECATED: Gunakan —delta saja. Upload update incremental	boolean	DEPRECATED: Gunakan —delta-only saja. Upload hanya update incremental, lewati bundle penuh
Upload update delta (hanya file yang berubah) untuk update instan, sangat cepat	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: tambahkan 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	Menemukan 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
–jika-assign	boolean	Izinkan 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 kustom (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Kunci anon Supabase kustom (untuk pengembangan sendiri)
—verbose	boolean	Aktifkan output rinci dengan logging detail

🧪 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

Pilihan:

Parameter	Jenis	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 penggunaan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk hosting sendiri)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

Hapus 🗑️ sebuah bundle tertentu dari Capgo Cloud, secara opsional 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 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	URL Host Supabase Pribadi (untuk penggunaan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci Anon Supabase (untuk penggunaan sendiri)

🧹 Pembersihan

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

Opsi:

Param	Tipe	Deskripsi
-b	string	Nomor versi bundel aplikasi untuk dihapus
-a	string	Kunci API untuk menghubungkan ke akun Anda
-k	string	Jumlah versi untuk disimpan
-f	boolean	Penghapusan paksa
—abaikan-channel	boolean	Hapus paket bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL host Supabase yang disesuaikan (untuk penggunaan sendiri atau pengembangan Capgo)
—supa-anon	string	Kunci anonim Supabase yang disesuaikan (untuk penggunaan sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi paket zip untuk penyimpanan eksternal yang aman. Kembalikan ivSessionKey untuk unggah/decryption. Peroleh cek checksum menggunakan ‘paket zip —json’.

Contoh:

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

Opsi:

Param	Jenis	Deskripsi
—kunci	string	Jalur kustom 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 monorepos (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 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)

🔹 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:

Param	Tipe	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 nama 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)