📦 bundel

📦 Atur paket aplikasi untuk pengiriman ke 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

Pilihan:

Param	Tipe	Deskripsi
-a,	string	Kunci API untuk menghubungkan ke akun Anda
-p,	string	Jalur folder untuk mengunggah, jika tidak disediakan maka akan menggunakan webDir yang ditetapkan di capacitor.config
-c,	string	Saluran untuk menghubungkan
-e,	string	Hubungkan ke URL eksternal daripada mengunggah ke Capgo Cloud
—iv-session-key	string	Tetapkan kunci IV dan sesi untuk URL bundle eksternal
—wilayah-s3	string	Wilayah untuk bucket S3 Anda
—apikey-s3	string	API kunci API untuk endpoint S3 Anda
—rahasia-s3	string	API rahasia untuk endpoint S3 Anda
—endpoint-s3	string	URL endpoint S3 Anda
—nama-bucket-s3	string	Nama untuk bucket S3 AWS Anda
—port-s3	string	Port untuk endpoint S3 Anda
—no-s3-ssl	boolean	Nonaktifkan 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	Luputkan kunci tanda tangan dan kirimkan update jelas
—no-code-check	boolean	Luputkan memeriksa apakah notifyAppReady() dipanggil di sumber code dan indeks 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-minimal-update	string	Versi minimal yang diperlukan untuk memperbarui ke versi ini. Digunakan hanya jika pengaturan auto update diatur ke metadata di channel
—versi-minimal-update-otomatis	boolean	Atur versi minimal update berdasarkan paket native
—ignore-metadata-check	boolean	Mengabaikan pengecekan metadata (node_modules) saat mengunggah
—ignore-checksum-check	boolean	Mengabaikan pengecekan checksum saat mengunggah
—force-crc32-checksum	boolean	Menggunakan checksum CRC32 paksa 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	Mengunggah 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)
—tidak-delta	boolean	Nonaktifkan pembaruan delta bahkan jika Pembaruan Langsung diaktifkan
—checksum-terenkripsi	string	Checksum terenkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal.
—atur-bundle-otomatis	boolean	Atur bundle di capacitor.config.json
—unggah-kering	boolean	Unggah proses bundle secara kering, artinya tidak akan mengunggah file tetapi menambahkan baris di database (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 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
—mengasignasi sendiri	boolean	Izinkan perangkat untuk bergabung secara otomatis ke dalam saluran ini (aturan saluran diperbarui)
—host-supra	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo)
—anon-supra	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan sendiri)
—verbose	boolean	Aktifkan output yang rinci dengan logging yang detail

🧪 Kemampuan Kompatibilitas

npx @capgo/cli@latest bundle compatibility

Periksa konsistensi dari sebuah 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
—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 penghosan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci anonim Supabase kustom (untuk penghosan 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 file package.json untuk proyek monorepos (dipisahkan koma)
—node-modules	string	Jalur direktori node_modules untuk proyek 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 jika diinginkan.

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

🧹 Pembersihan

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 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	API kunci untuk menghubungkan ke akun Anda
-k,	string	Jumlah versi untuk disimpan
-f,	string	Paksa penghapusan
—ignore-channel	boolean	Hapus bundel bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL Host Supabase Pribadi (untuk penggunaan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci Akses Supabase Pribadi (untuk penggunaan sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi sebuah bundle zip untuk penyimpanan eksternal yang aman. Mengembalikan ivSessionKey untuk unggah/pencairan. Periksa checksum 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 pribadi
—kunci-data	string	Kunci tanda tangan pribadi
-j,	string	Tampilkan hasil dalam format JSON
—package-json	string	Jalur ke file package.json untuk repositori monorepos (dipisahkan koma)

🔓 Mengembalikan

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
—kunci	string	Rute khusus untuk kunci tanda tangan pribadi
—key-data	string	Kunci tanda tangan pribadi
—checksum	string	Checksum dari bundle, untuk memverifikasi integritas bundle
—package-json	string	Rute-rute file package.json untuk repositori monorepo (dipisahkan koma)

🔹 Arsip

npx @capgo/cli@latest bundle zip

🗜️ Buatlah arsip 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	Tipe	Deskripsi
-p,	string	Path direktori untuk mengunggah, 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,	string	Tampilkan dalam JSON
—no-code-check	boolean	Luputkan 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)