📦 Paket

📦 Pengaturan dan manajemen paket aplikasi untuk pengiriman di Capgo Cloud, termasuk unggah, pengecekan kompatibilitas, dan enkripsi.

⬆️ Muat Tampung

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Muat Tampung aplikasi baru ke Capgo Cloud untuk distribusi. Versi harus > 0.0.0 dan unik. Versi yang terhapus 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

Bump otomatis versi semver berikutnya dari saluran (atau versi aplikasi remote terbaru) ketika Anda tidak memasukkan --bundleGunanya dalam CI ketika package.json sudah sesuai dengan versi Capgo yang ada:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Dengan --auto-bump ai, Capgo Cloudflare Pekerja AI membandingkan file bundle lokal dengan manifest delta sebelumnya Capgo/saluran, menginfer major | minor | patch | metadata, dan mencetak alasan singkat di CLI log. Jika tidak ada versi sebelumnya Capgo yang ada, AI dilewati dan bump beralih ke patch.

Pilihan:

Param	Tipe	Deskripsi
-a	string	API kunci untuk menghubungkan ke akun Anda
-p	string	Path folder untuk mengunggah, jika tidak disediakan akan menggunakan webDir yang ditetapkan di capacitor.config
-c	string	Sambungkan ke saluran. Gunakan koma untuk beberapa saluran, misalnya produksi,beta
—rollout	string	Setel bundle yang diunggah sebagai target rollout saluran ini pada persentase dari 0 hingga 100
—stable	boolean	Pada saluran yang telah dikonfigurasi rollout, gantikan fallback stabil daripada menetapkan target rollout
—rollout-percentage-bps	string	Setel persentase rollout bundle yang diunggah dalam basis poin dari 0 hingga 10000
—rollout-cache-ttl-seconds	string	TTl cache keputusan rollout Cloudflare dalam detik
-e	string	Tautan ke URL eksternal daripada mengunggah ke Capgo Cloud
—iv-session-key	string	Atur kunci IV dan sesi untuk URL bundle eksternal
—s3-region	string	Wilayah untuk bucket S3 Anda
—s3-apikey	string	API kunci untuk endpoint S3 Anda
—s3-apisecret	string	API rahasia untuk endpoint S3 Anda
—s3-endpoint	string	URL endpoint S3
—s3-bucket-name	string	Nama bucket S3 untuk Anda
—s3-port	string	Menghapus SSL untuk unggah ke S3
—no-s3-ssl	boolean	Kunci pribadi untuk sistem v2
—key-v2	string	Rute khusus untuk kunci tanda tangan pribadi (sistem v2)
__CAPGO_KEEP_0__	string	Kunci pribadi tanda tangan (sistem v2)
__CAPGO_KEEP_0__	boolean	Tampilkan URL bundle ke stdout
—no-kunci	boolean	Ignore signing key and send clear update
—no-code-periksa	boolean	Tidak memeriksa 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 pembaruan
-b	string	Nomor versi bundle yang akan diunggah
—auto-bump	string	Menggunakan otomatis dari bundle terkait saluran, atau versi aplikasi remote terakhir. Tingkat: utama, minor (default), patch (alias fix), metadata, atau ai (AI kerja kerja infers tingkat dari lokal vs delta manifest sebelumnya; kembali ke patch jika tidak ada versi Capgo sebelumnya). Meningkatkan hingga nama gratis ditemukan (nama yang dihapus tetap diisi)
—link	string	Menghubungkan ke sumber eksternal (misalnya GitHub release)
– 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 tidak diatur ke metadata di channel
– auto-versi-update-minimal	boolean	Tetapkan versi update minimal berdasarkan paket native
– abaikan-periksa-metadata	boolean	Mengabaikan periksa metadata (node_modules) saat mengunggah
– gagal-kan-kompatibilitas	boolean	Biarkan proses unggah gagal (keluar dengan kode non-nol) jika bundel tidak kompatibel dengan paket native channel saat ini. Dalam terminal interaktif, Anda masih bisa memilih build native; menolak gagal. Tidak bisa digabungkan dengan –abaikan-periksa-metadata.
– abaikan-periksa-checksum	boolean	Mengabaikan periksa checksum saat mengunggah
—force-crc32-checksum	boolean	Menggunakan ceksum CRC32 untuk unggah (mengatasi deteksi otomatis)
—timeout	string	Masa tunggu untuk proses unggah dalam detik
—multipart	boolean	[DEPRECATED] Gunakan —tus sebaliknya. Menggunakan protokol multipart untuk unggah 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 TUS unggah yang dapat diulang (default: otomatis)
--- parsial	boolean	[DEPRECATED] Gunakan ---delta sebaliknya. Unggah update incremental
--- parsial-saja	boolean	[DEPRECATED] Gunakan ---delta-saja sebaliknya. Unggah hanya update incremental, lewati bundle penuh
--- delta	boolean	Unggah update delta (hanya file yang berubah) untuk update instan, sangat cepat alih-alih download zip besar
--- delta-saja	boolean	Unggah hanya update delta tanpa bundle penuh untuk kecepatan maksimum (bermanfaat untuk aplikasi besar)
--- tidak-delta	boolean	Matikan update delta bahkan jika update instan diaktifkan
--- ceksum-terenkripsi	string	Sebuah ceksum terenkripsi (tanda tangan). Digunakan hanya ketika mengunggah bundle eksternal
---otomatis-buat-bundle	boolean	Set bundle di capacitor.config.json
---kering-unggah	boolean	Proses unggah bundle kering: tambahkan baris di database tanpa mengunggah file atau memperbarui channel (Digunakan oleh Capgo untuk tes internal)
---json-package	string	Jalur file package.json untuk monorepos (dipisahkan koma)
---modul-node	string	Jalur direktori node_modules untuk monorepos (dipisahkan koma)
---enkripsi-sebagian	boolean	Enkripsi file update delta (otomatis diaktifkan untuk updater > 6.14.4)
---hapus-bundle-tersambung-pada-unggah	boolean	Temukan bundle yang terkait saat ini di channel yang Anda coba unggah, dan hapusnya
---tidak-brotli-patterns	string	File-file untuk dikecualikan dari kompresi Brotli (globs terpisah koma, misalnya ".jpg,.png"
---nonaktifkan-brotli	boolean	Nonaktifkan sepenuhnya kompresi Brotli bahkan jika versi pembaruan mendukungnya
---versi-sudah-ada-oke	boolean	Keluar dengan status sukses jika versi bundle sudah ada, berguna untuk alur kerja CI/CD dengan monorepos
---self-assign	boolean	Biarkan perangkat untuk bergabung secara otomatis ke saluran ini (aturan saluran update)
---qr-preview	boolean	Cetak kode QR terminal untuk code pratinjau bundle setelah unggah
—kirim-notifikasi-perbarui	boolean	Kirim notifikasi perbarui asli untuk perangkat setelah mengupdate paket kanal terkait
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Kunci anon Supabase yang disesuaikan (untuk penggunaan sendiri)
—verbose	boolean	Tampilkan output rinci dengan log yang lebih 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	Tipe	context
Deskripsi	string	kunci API 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 untuk menghubungkan ke akun Anda
-c	string	Saluran untuk dibandingkan
—package-json	string	Jalur file package.json untuk repositori monorepo (dipisahkan koma)
—node-modules	string	Jalur direktori node_modules untuk repositori monorepo (dipisahkan koma)
—supa-host	string	URL host Supabase yang diatur sendiri (untuk pengembangan sendiri atau Capgo)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🗑️ Hapus

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Hapus 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	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

Opsi:

Param	Jenis	Tipe
Deskripsi	string	Kunci API untuk menghubungkan ke akun Anda
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🧹 Membersihkan

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 diselamatkan kecuali —ignore-channel digunakan.

Contoh:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Pilihan:

Param	Jenis	Deskripsi
-b	string	Nomor versi paket aplikasi untuk dihapus
-a	string	API kunci untuk menghubungkan ke akun Anda
-k	string	Jumlah versi untuk disimpan
-f	boolean	Hapus paket dengan paksa
--ignore-channel	boolean	Hapus paket bahkan jika terkait dengan saluran (PERINGATAN: menghapus saluran juga)
--supa-host	string	URL Host Supabase Pribadi (untuk hosting sendiri atau Capgo pengembangan)
–supa-anon	string	Kunci Anon Supabase (untuk hosting sendiri)

🔒 Enkripsi

npx @capgo/cli@latest bundle encrypt

🔒 Enkripsi sebuah zip bundle 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:

Param	Tipe	Pengenalan
—kunci	string	Jalan pintas untuk kunci tanda tangan pribadi
—kunci-data	string	Kunci tanda tangan pribadi
-j	boolean	Tampilkan dalam JSON
—json-package	string	Jalur ke file package.json untuk repositori monorepos (dipisahkan koma)

🔓 Enkripsi

npx @capgo/cli@latest bundle decrypt

Dekripsi Paket yang Dikripsi (utamanya untuk pengujian). 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 privat
—key-data	string	Kunci tanda tangan privat
—checksum	string	Checksum bundle untuk memastikan integritas bundle
—package-json	string	Rute file package.json untuk repositori monorepo (dipisahkan koma)

🔹 Arsip Zip

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	Alamat 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	Name of the zip file
-j	boolean	Keluaran dalam 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 repositori monorepo (dipisahkan koma)