Perbarui Delta

Capgo's Sistem Live Update dapat mengirimkan update lebih cepat dan efisien dengan hanya mengirimkan file yang berubah, bukan bundle JS seluruhnya.

Hal ini sangat bermanfaat bagi pengguna yang memiliki koneksi internet yang lambat atau berbayar, karena mengurangi jumlah data yang perlu diunduh.

A manfaat kedua adalah ketika aplikasi memiliki aset besar yang berubah jarang, seperti gambar atau video, dibandingkan dengan file JS yang dikompres, maka hanya akan diunduh sekali.

How Delta (Manifest) Updates Work

Perbarui Delta (manifest) di Capgo diatur oleh plugin Capgo yang terinstal di aplikasi Anda. Ketika Anda mengunggah versi baru aplikasi menggunakan flag Capgo, maka Capgo melakukan hal-hal berikut: --delta flag, Capgo does the following:

1. Checksums dihasilkan untuk setiap file
2. Dibuatlah json manifest baru, yang mencantumkan semua file dan checksum-nya
3. Manifest ini diunggah ke database __CAPGO_KEEP_0__
4. Ketika perangkat yang menjalankan aplikasi Anda memeriksa update, plugin Capgo menerima manifest baru dari server. Lalu, plugin tersebut membandingkan manifest tersebut dengan yang sudah ada, mengidentifikasi file mana yang telah berubah berdasarkan checksum dan jalur file.

When a device running your app checks for an update, the Capgo plugin receives the new manifest from the server. It compares this manifest to the one it currently has, identifying which files have changed based on the checksums and file paths.

Manifest

Manifest

Pada kasus pembaruan Delta (manifest), perangkat menyimpan semua file yang diunduh ke dalam cache umum. Capgo tidak pernah membersihkannya, tetapi sistem operasi dapat membersihkannya kapan saja.

Mengaktifkan Pembaruan Delta (Manifest)

Untuk mengaktifkan pembaruan Delta (manifest) untuk aplikasi Capgo Anda, cukup gunakan flag berikut ketika mengunggah versi baru: --delta Tampilan jendela terminal

npx @capgo/cli@latest bundle upload --delta

Ketika

adalah autoUpdate Salin ke clipboard "atInstall", "onLaunch"atau "always"unggah dengan --delta. Mode-mode tersebut berlaku selama pengguna menunggu, sehingga zip penuh memperlambat pengalaman pengguna. Mereka juga memerlukan autoSplashscreen: true dan @capacitor/splash-screen bersama launchAutoHide: false. Lihat Siklus Perbarui.

Jika autoUpdate diatur ke mode aplikasi instan ("atInstall", "onLaunch"atau "always") di capacitor.config, CLI mendeteksinya. Di lingkungan non-interaktif, ia mengirimkan perbarui Delta (manifest) secara otomatis, dan di lingkungan interaktif ia meminta konfirmasi sebelum mengunggah. Legacy directUpdate Konfigurasi masih terdeteksi. Gunakan --no-delta untuk memaksa unggah bundle penuh.

Pembatasan update Delta

• File kosong: Log CLI Ignoring empty file... dan mengabaikan file kosong dari manifest Delta. Ini tidak akan gagal unggah, jadi menambahkan file kosong dapat mengubah bundle hasil tanpa menghentikan pengembangan. Jangan termasuk file kosong dalam jalur bundle Delta.
• Spasi dalam jalur: Unggah Delta gagal sebelum mengunggah file ketika jalur bundle mengandung spasi. Ubah nama file atau direktori untuk menghilangkan spasi sebelum mengunggah update Delta.

Menggunakan Delta (Manifest) Update

Jika Anda ingin memastikan bahwa semua unggahan adalah update Delta (manifest) dan mencegah unggahan bundle penuh secara tidak sengaja, Anda dapat menggunakan --delta-only flag:

npx @capgo/cli@latest bundle upload --delta-only

Ketika --delta-only digunakan, Capgo hanya akan mengunggah file individu dan menghasilkan manifest. Apapun perangkat yang tidak mendukung pembaruan Delta (manifest) tidak akan dapat mengunduh pembaruan tersebut.

Mungkin Anda ingin menggunakan --delta-only if:

• Selalu ingin menggunakan pembaruan Delta (manifest) dan tidak ingin memungkinkan unggah bundle penuh
• Melakukan pengaturan CI/CD pipeline dan ingin memastikan semua unggahan otomatis menggunakan pembaruan Delta (manifest)
• Aplikasi Anda besar dan bandwidth terbatas, sehingga Anda perlu meminimalkan ukuran unggahan/unduhan

Jika Anda perlu melakukan unggahan bundle penuh sementara --delta-only diatur, cukup jalankan perintah unggahan tanpa --delta-only. Ini akan menggantikan pengaturan untuk unggahan tunggal tersebut, memungkinkan Anda untuk mengirim bundle lengkap ketika diperlukan.

Pengaturan

Jika pembaruan Delta (manifest) tidak tampaknya berfungsi (yaitu perangkat selalu mengunduh bundle JS lengkap bahkan untuk perubahan kecil), periksa kembali bahwa:

• Anda menggunakan flag setiap kali mengunggah versi baru --delta Jika menggunakan
• , pastikan Anda tidak sengaja mengabaikan flag --delta-onlyPerangkat Anda menjalankan versi terbaru dari plugin __CAPGO_KEEP_0__ --delta Perangkat Anda memiliki koneksi jaringan stabil dan dapat mencapai server __CAPGO_KEEP_0__
• Anda juga dapat menggunakan aplikasi web Capgo untuk memeriksa detail unggahan terakhir Anda:
• Your device has a stable network connection and can reach the Capgo servers

You can also use the Capgo webapp to check the details of your last upload:

1. Pergi ke webapp
2. Klik pada aplikasi Anda
3. Klik pada jumlah paket di bar statistik.
4. Pilih paket terakhir
5. Periksa Partial lapangan

Jika Anda masih mengalami masalah, silakan menghubungi dukungan Capgo untuk bantuan lebih lanjut. Mereka dapat memeriksa log server untuk memastikan bahwa unggahan Delta (manifest) Anda sedang diproses dengan benar dan perangkat menerima manifest yang diperbarui.

Itu saja! Flag tersebut memerintahkan __CAPGO_KEEP_0__ untuk melakukan unggahan file individu dan penghasilan manifest yang diperlukan untuk pembaruan Delta (manifest). --delta flag tells Capgo to perform the individual file uploads and manifest generation needed for Delta (manifest) updates.

bun --delta setiap kali Anda mengunggah versi baru yang ingin Anda kirim sebagai pembaruan Delta (manifest). Jika Anda melewatkan flag, Capgo akan mengunggah seluruh bundle JS sebagai file tunggal, dan perangkat akan mengunduh seluruh bundle bahkan jika hanya bagian kecil yang berubah.

Teruskan dari pembaruan Delta

Jika Anda menggunakan Pembaruan Delta context: Halaman/area: Halaman produk/harga perusahaan. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman enterprise.astro. Pesan kunci `enterprise_delta_updates` (Pembaruan Delta Perusahaan). Capgo Live Updates Capgo Pembaruan Live context: Halaman/area: Halaman produk pembaruan live. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman live-update.astro. Simpan istilah produk/merek dan istilah pengembang Capgo secara tepat. Pesan kunci `live_update_hero_badge` (Lambang Pembaruan Live). untuk alur kerja produk di __CAPGO_KEEP_0__ Pembaruan Live, Ringkasan untuk detail implementasi di Ringkasan, dan Perilaku Update untuk detail implementasi di Perilaku Update, dan Jenis Update untuk detail implementasi di Jenis Update.