📦 bundle

📦 Atur paket aplikasi untuk pengiriman ke Capgo Cloud, termasuk unggah, pengecekan kompatibilitas, dan enkripsi.

⬆️ Upload

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

Pilihan:

Param	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
-e,	string	Menghubungkan ke URL eksternal daripada mengunggah ke Capgo Cloud
—iv-session-key	string	Tetapkan IV dan kunci sesi untuk URL bundle eksternal
—wilayah-s3	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
—s3-nama-bucket	string	Nama untuk bucket S3 AWS Anda
—s3-port	string	Port untuk endpoint S3 Anda
—no-s3-ssl	boolean	Matikan SSL untuk unggah S3
—key-v2	string	Jalur khusus untuk kunci tanda tangan pribadi (sistem v2)
—key-data-v2	string	Kunci tanda tangan pribadi (sistem v2)
—bundle-url	boolean	Tampilkan URL bundle ke stdout
—no-key	boolean	Lupakan kunci tanda tangan dan kirimkan perbarui jelas
—no-code-check	boolean	Lupakan memeriksa jika notifyAppReady() dipanggil di sumber code dan index ada di folder root
—tampilkan-sesi-iv	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 berupa catatan rilis, hash commit, pesan commit, dll.
—versi-update-minimal	string	Versi minimal yang diperlukan untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di channel
—versi-update-otomatis-minimal	boolean	Atur versi update minimal berdasarkan paket native
—ignore-metadata-check	boolean	Mengabaikan periksa metadata (node_modules) saat mengunggah
—ignore-checksum-check	boolean	Mengabaikan periksa cek checksum saat mengunggah
—force-crc32-checksum	boolean	Menggunakan cek CRC32 paksa untuk unggah (mengatasi deteksi otomatis)
—timeout	string	Waktu tunggu untuk proses unggah dalam detik
—multipart	boolean	Gunakan —tus sebaliknya. Menggunakan protokol multipart untuk unggah S3
—zip	boolean	Unggah bundle menggunakan zip ke Capgo cloud (legacy)
—tus	boolean	Upload bundle menggunakan TUS ke Capgo cloud
—tus-chunk-size	string	Ukuran chunk dalam byte untuk upload TUS yang dapat diulang (default: otomatis)
—partial	boolean	[DEPRECATED] Gunakan —delta sebaliknya. Upload update incremental
—partial-only	boolean	[DEPRECATED] Gunakan —delta-only sebaliknya. Upload hanya update incremental, lewati bundle penuh
—delta	boolean	Upload update delta (hanya file yang berubah) untuk update instan, sangat cepat alih-alih download zip besar
—delta-only	boolean	Upload hanya update delta tanpa bundle penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
—no-delta	boolean	Matikan pembaruan delta bahkan jika Pembaruan Langsung diaktifkan
—encrypted-checksum	string	Checksum yang dienkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal.
—auto-set-bundle	boolean	Atur bundle di capacitor.config.json
—dry-upload	boolean	Unggah proses bundle secara kering, 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 repositori monorepo (dipisahkan koma)
—node-modules	string	Jalur ke direktori node_modules untuk repositori monorepo (dipisahkan koma)
—enkripsi-sebagian	boolean	Enkripsi file update delta (otomatis diaktifkan untuk pembaruan > 6.14.4)
—hapus-bundel-tetangga-pada-upload	boolean	Mencari bundel yang terkait saat ini di saluran yang Anda coba unggah, dan menghapusnya
—tidak-buat-pola-brotli	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 pembaruan mendukungnya
—versi-sudah-ada-oke	boolean	Keluar dengan sukses jika versi bundel sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
Mengasign-kan sendiri	boolean	Biarkan perangkat untuk bergabung secara otomatis ke dalam saluran ini (aturan saluran update)
Menghost-kan sendiri	string	URL host Supabase yang disesuaikan (untuk menghost sendiri atau pengembangan Capgo)
Mengunci anonim	string	Kunci anonim Supabase yang disesuaikan (untuk menghost sendiri)
Membuat detail	boolean	Aktifkan output yang rinci dengan logging yang detail

🧪 Kompatibilitas

npx @capgo/cli@latest bundle compatibility

Periksa konsistensi dari sebuah bundle dengan sebuah 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	Teks keluaran daripada emoji
—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 kustom (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Kunci anonim Supabase kustom (untuk pengembangan 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 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)
—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 memilih versi tertentu.

Contoh:

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

Pilihan:

Param	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	Kunci API 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)

🧹 Cleanup

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 akan tetap dipertahankan 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,	string	Paksa penghapusan
—ignore-channel	boolean	Hapus bundel bahkan jika terhubung ke saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL Host Supabase kustom (untuk penghosan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anon Supabase kustom (untuk penghosan sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi sebuah bundle zip untuk penyimpanan eksternal yang aman. Mengembalikan ivSessionKey untuk unggah/pencairan. Dapatkan ceklis menggunakan ‘bundle zip —json’.

Contoh:

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

Pilihan:

Parameter	Tipe	Deskripsi
—kunci	string	Jalur khusus untuk kunci tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
-j,	string	Tampilkan hasil dalam format JSON
—package-json	string	Jalur ke file package.json untuk repositori monorepos (dipisahkan koma)

🔓 Dekripsi

npx @capgo/cli@latest bundle decrypt

🔓 Dekripsi sebuah bundle yang dienkripsi (utamanya untuk testing). Tampilkan kunci sesi base64 untuk verifikasi.

Contoh:

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

Pilihan:

Param	Tipe	Deskripsi
—key	string	Jalur pribadi untuk kunci tanda tangan
—key-data	string	Kunci tanda tangan pribadi
—checksum	string	Checksum dari bundle, untuk memastikan integritas bundle
—package-json	string	Jalur file package.json untuk repositori monorepos (dipisahkan koma)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Buat file zip dari bundle aplikasi Anda. Kembalikan checksum untuk digunakan 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	Deskripsi
-p,	string	Alamat folder untuk mengunggah, jika tidak disediakan maka akan menggunakan webDir yang ditetapkan di capacitor.config
-b,	string	Nomor versi bundel untuk nama file zip
-n,	string	Nama file zip
-j,	string	Keluaran dalam JSON
—no-code-check	boolean	Lepaskan pengecekan 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 monorepo (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, Capgo Keamanan untuk alur kerja produk di Capgo Keamanan, dan Capgo Pusat Kepercayaan untuk alur kerja produk di Capgo Pusat Kepercayaan.