📦 bundle

📦 Kelola bundle aplikasi untuk pengiriman di Capgo Cloud, termasuk unggah, pengecekan kompatibilitas, dan enkripsi.

⬆️ Unggah

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Unggah aplikasi bundle 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	API kunci 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 IV dan kunci sesi untuk URL bundle eksternal
—s3-region	string	Wilayah untuk bucket S3 Anda
—s3-apikey	string	Kunci API untuk endpoint S3 Anda
—s3-apisecret	string	Kunci rahasia API untuk endpoint S3 Anda
—s3-endpoint	string	URL endpoint S3 Anda
—s3-bucket-name	string	Nama untuk wadah S3 Anda
—s3-port	string	Port untuk endpoint S3 Anda
—no-s3-ssl	boolean	Nonaktifkan SSL untuk unggah S3
—key-v2	string	Rute khusus untuk kunci tanda tangan privat (sistem v2)
—key-data-v2	string	Kunci tanda tangan privat (sistem v2)
—bundle-url	boolean	Tampilkan URL bundle ke stdout
—no-key	boolean	Abai kunci tanda tangan dan kirimkan update yang 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 bundel untuk diunggah
—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-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-minimal-otomatis	boolean	Tetapkan versi update minimal berdasarkan paket native
—abaikan-pemeriksaan-metadata	boolean	Mengabaikan pemeriksaan metadata (node_modules) saat mengunggah
—abaikan-pemeriksaan-checksum	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
—tus-chunk-size	string	Ukuran chunk dalam byte untuk unggahan upload 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 alih-alih download zip besar
—delta-only	boolean	Unggah hanya pembaruan delta tanpa bundel penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
—no-delta	boolean	Matikan pembaruan delta bahkan jika Pembaruan Langsung Direktur diaktifkan
—encrypted-checksum	string	Suatu ceksum yang dienkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal.
—atur-otomatis-bundle	boolean	Atur bundle di capacitor.config.json
—unggah-kering	boolean	Unggah proses bundle kering, berarti tidak akan mengunggah file tetapi menambahkan baris di database (Digunakan oleh Capgo untuk tes internal)
—json-package	string	Jalur ke file package.json untuk repositori monorepo (dipisahkan koma)
—modul-node	string	Jalur ke direktori node_modules untuk repositori monorepo (dipisahkan koma)
—enkripsi-sebagian	boolean	Enkripsi file update delta (diaktifkan otomatis untuk pembaruan > 6.14.4)
—hapus-bundle-tersambung-pada-unggah	boolean	Mencari bundle yang terkait saat ini di saluran yang Anda coba unggah, dan menghapusnya
—no-brotli-patterns	string	File untuk dikecualikan dari kompresi Brotli (globs terpisah dengan koma, misalnya “.jpg,.png”)
—disable-brotli	boolean	Menghapus kompresi Brotli bahkan jika versi pembaruan mendukungnya
—version-exists-ok	boolean	Keluar dengan status berhasil jika versi bundle sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
—self-assign	boolean	Mengizinkan perangkat untuk bergabung secara otomatis ke saluran ini (mengubah pengaturan saluran)
—supa-host	string	URL Host Supabase Pribadi (untuk penggunaan sendiri atau Capgo pengembangan)
—supa-anon	string	Kunci Anonim Supabase (untuk penggunaan sendiri)
—verbose	boolean	Tampilkan output detail dengan logging yang lebih banyak

🧪 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	Kunci API untuk menghubungkan ke akun Anda
-c,	string	Saluran untuk memeriksa konsistensi dengan
—teks	boolean	Tampilkan teks keluaran bukan emoji
—package-json	string	Jalur ke file package.json untuk monorepos (dipisahkan koma)
—node-modules	string	Jalur direktori node_modules untuk monorepos (dipisahkan koma)
—supa-host	string	URL host Supabase yang diatur sendiri (untuk pengembangan atau Capgo self-hosting)
—supa-anon	string	Kunci anon Supabase yang diatur sendiri (untuk pengembangan)

🔹 Tipe 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 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 direktori node_modules untuk monorepos (dipisahkan koma)
—supa-host	string	URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Kunci anon Supabase yang diatur sendiri (untuk pengembangan sendiri)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

Hapus sebuah bundle tertentu dari Capgo Cloud, dengan memilih versi tertentu jika perlu.

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

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

Parameter	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)

🧹 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 akan tetap dipertahankan 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 bundle aplikasi untuk dihapus
-a,	string	Kunci API untuk menghubungkan ke akun Anda
-k,	string	Banyaknya versi untuk menjaga
-f,	string	Menghapus paksa
—ignore-channel	boolean	Hapus bundle bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
—supa-host	string	URL host Supabase yang disesuaikan (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk pengembangan sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

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

Contoh:

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

Pilihan:

Parameter	Jenis	Deskripsi
—kunci	string	Jalur pribadi untuk kunci tanda tangan yang disesuaikan
—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)

🔓 Enkripsi

npx @capgo/cli@latest bundle decrypt

🔓 Mengenkripsi Paket yang Dikripsi (utamanya untuk pengujian). Cetak kunci sesi base64 untuk verifikasi.

Contoh:

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

Pilihan:

Param	Tipe	Deskripsi
—kunci	string	Jalur khusus untuk kunci tanda tangan privat
—kunci-data	string	Kunci tanda tangan privat
—checksum	string	Checksum 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 aplikasi bundle 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

Opsi:

Param	Tipe	Deskripsi
-p,	string	Path direktori untuk mengunggah, jika tidak disediakan maka akan menggunakan webDir yang ditetapkan di capacitor.config
-b,	string	Versi bundle zip file
-n,	string	Nama file zip
-j,	string	Tampilkan hasil dalam format JSON
—tidak-lakukan-code-periksa	boolean	Lepaskan periksa apakah notifyAppReady() dipanggil di sumber code dan index ada di folder root
—kunci-v2	boolean	Gunakan enkripsi v2
—package-json	string	Jalur ke file package.json untuk monorepos (dipisahkan koma)

Lanjutkan dari bundle

Jika Anda menggunakan bundle untuk merencanakan keamanan dan kinerja, hubungkannya dengan Enkripsi untuk detail implementasi di Pengamanan Kriptografi, Kemampuan Kompatibilitas untuk detail implementasi di Kemampuan Kompatibilitas, 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.