📦 bundle

📦 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

Pilihan:

Param	Tipe	Deskripsi
-a,	string	Kunci API untuk menghubungkan ke akun Anda
-p,	string	Path direktori untuk mengunggah, jika tidak disediakan maka akan menggunakan webDir yang ditetapkan di capacitor.config
-c,	string	Saluran untuk menghubungkan
-e,	string	Link to external URL instead of upload to Capgo Cloud
—iv-session-key	string	Atur IV dan kunci sesi untuk URL paket eksternal
—s3-region	string	Wilayah untuk bucket S3 Anda
—s3-apikey	string	API kunci API untuk endpoint S3 Anda
—s3-apisecret	string	API rahasia API untuk endpoint S3 Anda
—s3-endpoint	string	URL endpoint S3 Anda
—nama-bucket-s3	string	Nama untuk bucket S3 Anda
—port-s3	string	Port untuk endpoint S3 Anda
—tidak-ssl-s3	boolean	Nonaktifkan SSL untuk unggah S3
—path-kunci-privat-v2	string	Jalur khusus untuk kunci tanda tangan privat (sistem v2)
—kunci-tanda-tangan-privat-v2	string	Kunci tanda tangan privat (sistem v2)
—url-bundle	boolean	Tampilkan URL bundle ke stdout
—no-kunci	boolean	Lepaskan kunci penandatanganan dan kirim update yang jelas
—no-code-periksa	boolean	Lepaskan periksa apakah notifyAppReady() dipanggil di sumber code dan indeks ada di folder root
—tampilkan-iv-sesi	boolean	Tampilkan di konsol kunci IV dan sesi yang digunakan untuk mengenkripsi update
-b,	string	Nomor versi bundel yang akan diunggah
—tautan	string	Tautan ke sumber eksternal (misalnya GitHub rilis)
—komentar	string	Komentar tentang versi ini, bisa menjadi catatan rilis, hash commit, pesan commit, dll.
—versi-minimum untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di channel	string	Tetapkan versi update minimum berdasarkan paket native
Ignores metadata (node_modules) saat mengunggah	boolean	Ignores cek checksum saat mengunggah
Menggunakan cek CRC32 untuk unggah (mengatasi deteksi otomatis)	boolean	Waktu tunggu untuk proses unggah dalam detik
—versi-minimum untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di channel	boolean	Tetapkan versi update minimum berdasarkan paket native
Ignores metadata (node_modules) saat mengunggah	boolean	Ignores cek checksum saat mengunggah
Menggunakan cek CRC32 untuk unggah (mengatasi deteksi otomatis)	string	Waktu tunggu untuk proses unggah dalam detik
—multipart	boolean	Gunakan protokol multipart untuk unggah ke S3
—zip	boolean	Unggah bundle menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Unggah bundle menggunakan TUS ke Capgo cloud
—tus-chunk-size	string	Ukuran chunk dalam byte untuk unggah TUS 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	Upload delta updates (hanya file yang berubah) untuk pembaruan instan dan sangat cepat, bukan download zip besar
—delta-only	boolean	Upload hanya delta updates tanpa bundel lengkap untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
—no-delta	boolean	Matikan pembaruan delta bahkan jika Direct Update diaktifkan
—encrypted-checksum	string	Checksum yang dienkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundel eksternal
—auto-set-bundle	boolean	Atur bundel di capacitor.config.json
—dry-upload	boolean	Unggah secara kering proses bundel, artinya tidak akan mengunggah file tetapi menambahkan baris di database (Digunakan oleh Capgo untuk tes internal)
—package-json	string	Jalur ke file package.json untuk monorepos (dipisahkan koma)
—node-modules	string	Jalur ke direktori node_modules untuk monorepos (dipisahkan koma)
—encrypt-partial	boolean	Enkripsi file update delta (dijalankan secara otomatis untuk pembaruan > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Mencari bundle terkait yang saat ini terhubung ke saluran yang Anda coba unggah, dan menghapusnya
—no-brotli-patterns	string	File untuk dikecualikan dari kompresi Brotli (glokal, misalnya “.jpg,.png”)
—nonaktifkan-brotli	boolean	Mengaktifkan pengurangan brotli sepenuhnya bahkan jika versi pembaruan mendukungnya
—versi-sudah-ada-ok	boolean	Keluar dengan sukses jika versi paket sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
—self-assign	boolean	Izinkan perangkat untuk bergabung secara otomatis ke dalam saluran ini (pengaturan saluran pembaruan)
—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)
—verbose	boolean	Aktifkan output yang rinci dengan logging yang 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	Jenis	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 monorepos (dipisahkan koma)
—node-modules	string	Jalur ke direktori node_modules untuk proyek monorepos (dipisahkan koma)
—supa-host	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase (untuk self-hosting)

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

Parameter:	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 monorepos (dipisahkan koma)
—node-modules	string	Jalur ke direktori node_modules untuk monorepos (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 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 pengembangan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan sendiri)

📋 Daftar

Singkatan: 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 Dibuat Sendiri (untuk penggunaan sendiri atau pengembangan Capgo)
—supa-anon	string	Kunci Supabase anonim (untuk penggunaan sendiri)

🧹 Cleanup

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Hapus paket lama di Capgo Cloud, menyimpan jumlah paket versi terbaru yang ditentukan. Paket yang terkait dengan saluran disimpan 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 aplikasi untuk dihapus
-a,	string	Kunci API untuk menghubungkan ke akun Anda
-k,	string	Jumlah versi yang harus disimpan
-f,	string	Pembatalan paksa
—ignore-channel	boolean	Hapus paket 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

Paket yang dihapus bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)

Contoh:

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

Pilihan:

Param	Jenis	Deskripsi
—kunci	string	Jalur kustom untuk kunci tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
-j,	string	Output dalam JSON
—package-json	string	Jalur ke file package.json untuk monorepos (dipisahkan koma)

🔓 Mengenkripsi

npx @capgo/cli@latest bundle decrypt

🔓 Mengenkripsi 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 khusus 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 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	Jenis	Penguraian
-p,	string	Jalur folder untuk mengunggah, 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,	string	Tampilkan hasil dalam format JSON
—no-code-check	boolean	Lepaskan pengecekan apakah 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 monorepos (dipisahkan koma)

Teruskan dari bundle

Jika Anda menggunakan bundle untuk merencanakan keamanan dan kelayakan, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kelayakan untuk detail implementasi di Kelayakan, Capgo Scanner Keamanan untuk alur kerja produk di Capgo Scanner Keamanan, Keamanan Capgo untuk alur kerja produk di Keamanan Capgo dan Tengah Kepercayaan Capgo untuk alur kerja produk di Tengah Kepercayaan Capgo.