📦 bundel

📦 Kelola 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

Pilihan:

Param	Tipe	Deskripsi
-a	string	Kunci API untuk menghubungkan ke akun Anda
-p	string	Lokasi folder untuk mengunggah, jika tidak disediakan maka 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
—persentase-rolout-bps	string	Atur persentase rollout bundle yang diunggah dalam basis poin dari 0 hingga 10000
—ttl-cache-rolout-detik	string	Cloudflare TTL cache keputusan rollout dalam detik
-e	string	Tautan ke URL eksternal daripada mengunggah ke Capgo Cloud
—kunci-sesi-iv	string	Atur kunci IV dan sesi untuk URL bundle eksternal
—region-s3	string	Wilayah untuk bucket S3 Anda
—apikey-s3	string	API kunci API untuk endpoint S3 Anda
—s3-apisecret	string	API secret for your S3 endpoint
—s3-endpoint	string	URL Endpoint S3
—s3-bucket-name	string	Nama Bucket S3 Anda
—s3-port	string	Port Endpoint S3 Anda
—no-s3-ssl	boolean	Nonaktifkan SSL untuk Unggah S3
—key-v2	string	Jalur Kunci Tanda Tangan Pribadi (Sistem v2)
—key-data-v2	string	Kunci pribadi pengesahan (sistem v2)
—bundle-url	boolean	Tampilkan URL bundle ke stdout
—no-key	boolean	Lupakan kunci pengesahan dan kirimkan pembaruan jelas
—no-code-check	boolean	Lupakan periksa 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 pembaruan
-b	string	Nomor versi bundle dari bundle untuk diunggah
—tautan	string	Tautan ke sumber eksternal (misalnya GitHub rilis)
—komentar	string	Komentar tentang versi ini, bisa jadi catatan rilis, hash commit, pesan commit, dll.
—min-update-versi	string	Versi minimal yang diperlukan untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di channel
—auto-min-update-versi	boolean	Tetapkan versi update minimal berdasarkan paket native
—abaikan-periksa-metadata	boolean	Mengabaikan periksa metadata (node_modules) saat mengunggah
—gagal-kan-kompatibilitas	boolean	Gagal mengunggah (keluar dengan kode keluaran tidak nol) daripada mengunggah ketika bundel tidak kompatibel dengan paket native channel saat ini. Dalam terminal interaktif Anda masih bisa memilih bangun native; menolak gagal.
—ignore-checksum-check	boolean	Ignores cek checksum ketika mengunggah
—force-crc32-checksum	boolean	Menggunakan cek CRC32 untuk mengunggah (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	Mengunggah bundle menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Mengunggah bundle menggunakan TUS ke Capgo cloud
—ukuran-bagian—	string	Ukuran bagian dalam byte untuk unggahan TUS yang dapat diulang (default: otomatis)
—partial	boolean	[DEPRECATED] Gunakan —delta sebaliknya. Unggah pembaruan incremental
—partial-only	boolean	[DEPRECATED] Gunakan —delta-only sebaliknya. Unggah hanya pembaruan incremental, lewati bundel penuh
—delta	boolean	Unggah pembaruan delta (hanya file yang berubah) untuk pembaruan instan, sangat cepat, bukan unduhan zip besar
—delta-only	boolean	Unggah hanya pembaruan delta tanpa bundel penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
—tidak-delta	boolean	Matikan pembaruan delta bahkan jika pembaruan instan diaktifkan
---checksum-terenkripsi	string	Checksum terenkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal.
---atur-bundle-otomatis	boolean	Setel bundle di capacitor.config.json
---unggah-bersih	boolean	Unggah proses bundle secara kering: tambahkan baris di database tanpa mengunggah file atau memperbarui saluran (Digunakan oleh Capgo untuk tes internal)
---json-paket	string	Jalur file json paket untuk monorepos (dipisahkan koma)
---modul-node	string	Jalur direktori modul node untuk monorepos (dipisahkan koma)
---enkripsi-sebagian	boolean	Enkripsi file update delta (diaktifkan otomatis untuk pembarui > 6.14.4)
Hapus Paket Terhubung Pada Unggah	boolean	Menemukan paket yang terhubung saat ini di saluran yang Anda coba unggah, dan menghapusnya
Patokan Brotli Tidak	string	File untuk dikecualikan dari kompresi Brotli (globs terpisah dengan koma, misalnya “.jpg,.png”)
Matikan Brotli	boolean	Menghapus kompresi Brotli sepenuhnya bahkan jika versi pembarui mendukungnya
Versi Sudah Ada Baik	boolean	Keluar dengan sukses jika versi paket sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
Autotambahkan	boolean	Biarkan perangkat untuk bergabung secara otomatis ke saluran ini (mengubah pengaturan saluran)
—tampilan-qr	boolean	Cetak sebuah tampilan terminal QR code untuk pratinjau paket ini setelah diunggah
—kirim-pemberitahuan-pembaruan	boolean	Kirimkan pemberitahuan pembaruan asli ke perangkat setelah memperbarui paket kanal terkait
—host-supabase	string	URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo pengembangan)
—anon-supabase	string	Kunci anon Supabase yang diatur sendiri (untuk pengembangan sendiri)
—verbose	boolean	Aktifkan output yang lebih detail dengan logging yang lebih rinci

🧪 Kompatibilitas

npx @capgo/cli@latest bundle compatibility

🧪 Periksa konsistensi dari 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)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan sendiri)

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

Param	Jenis	Deskripsi
-a	string	API untuk menghubungkan ke akun Anda
-c	string	Saluran untuk dibandingkan
—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 pengembangan sendiri)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

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

Contoh:

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

Pilihan:

Param	Tipe	Deskripsi
-a	string	API kunci untuk menghubungkan ke akun Anda
—supa-host	string	URL host Supabase kustom (untuk pengembangan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase kustom (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 yang disesuaikan (untuk penggunaan sendiri atau Capgo pengembangan)
—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 tertentu versi terbaru. 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:

Parameter	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
—ignore-channel	boolean	Hapus bundle bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL host Supabase kustom (untuk pengembangan sendiri atau Capgo )
—supa-anon	string	Kunci anon Supabase kustom (untuk pengembangan sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi zip bundle untuk penyimpanan eksternal yang aman. Kembalikan ivSessionKey untuk unggah/pencairan. Periksa checksum menggunakan ‘bundle zip —json’.

Contoh:

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

Opsi:

Param	Tipe	Deskripsi
—kunci	string	Jalur kunci pribadi untuk tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
-j	boolean	Keluaran dalam JSON
—package-json	string	Rute file package.json untuk repositori monorepos (dipisahkan koma)

🔓 Mengamankan

npx @capgo/cli@latest bundle decrypt

🔓 Mengamankan bundle yang dienkripsi (utamanya untuk pengujian). Mencetak kunci sesi base64 untuk verifikasi.

Contoh:

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

Pilihan:

Param	Tipe	Deskripsi
—kunci	string	Jalur pribadi untuk kunci tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
—cek	string	Ceksum dari bundle, untuk memverifikasi integritas bundle
—json-package	string	Jalur file package.json untuk repositori monorepos (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 akan menggunakan webDir yang ditetapkan di capacitor.config
-b	string	Nomor versi bundel untuk nama file zip
-n	string	Nama file zip
-j	boolean	Tampilkan dalam JSON
—no-code-check	boolean	Abaikan periksa jika notifyAppReady() dipanggil di sumber code dan index ada di folder root
—key-v2	boolean	Gunakan enkripsi v2
—package-json	string	Jalur ke file package.json untuk repositori monorepos (dipisahkan koma)