Perubahan Delta

Capgo's Live Update sistem dapat mengirimkan pembaruan lebih cepat dan efisien dengan hanya mengirimkan file yang berubah, bukan bundle JS keseluruhan.

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

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

Bagaimana Delta (Manifest) Pembaruan Bekerja

Perbaruan delta (manifest) di Capgo diatur oleh plugin Capgo yang terpasang 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. Manifest json baru dibuat, yang mencantumkan semua file dan checksums mereka
3. Manifest ini diunggah ke database __CAPGO_KEEP_0__
4. Ketika perangkat yang menjalankan aplikasi Anda memeriksa perbaruan, plugin Capgo menerima manifest baru dari server. Ia membandingkan manifest ini dengan yang ada sekarang, mengidentifikasi file mana yang telah berubah berdasarkan checksums 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

Pada kasus perbaruan delta (manifest), perangkat menyimpan semua file yang diunduh ke cache umum. __CAPGO_KEEP_0__ tidak pernah membersihkannya, tetapi sistem operasi dapat membersihkannya kapan saja.

In case of Delta (manifest) updates, the device stores all downloaded files in a common cache. Capgo never cleans it, but the OS can at any time.

Mengaktifkan Perbaruan Delta (Manifest)

Untuk mengaktifkan perbaruan Delta (manifest) untuk aplikasi Capgo Anda, cukup gunakan --delta flag ketika mengunggah versi baru:

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

Jika directUpdate dihubungkan di capacitor.config, CLI mendeteksinya. Di lingkungan non-interaktif, CLI mengirimkan perbaruan Delta (manifest) secara otomatis, dan di lingkungan interaktif, CLI meminta Anda untuk mengonfirmasi sebelum mengunggah. Gunakan --no-delta untuk memaksa unggah bundle penuh.

Mengaktifkan Perbaruan Delta (Manifest)

Jika Anda ingin memastikan bahwa semua unggahan adalah Delta (manifest) update 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 Delta (manifest) update tidak akan dapat mengunduh update.

Anda mungkin ingin menggunakan --delta-only if:

• Anda selalu ingin menggunakan Delta (manifest) update dan tidak pernah ingin memungkinkan unggahan bundle penuh
• Anda sedang mengatur pipeline CI/CD dan ingin memastikan semua unggahan otomatis adalah 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 dijadikan, cukup jalankan perintah unggah tanpa --delta-only. Ini akan menggantikan pengaturan untuk unggah tunggal, memungkinkan Anda untuk mendorong bundle lengkap ketika dibutuhkan.

Pengaturan

Anda menggunakan flag

• Jika menggunakan --delta , pastikan Anda tidak sengaja mengabaikan flag
• Perangkat Anda menjalankan versi terbaru dari plugin __CAPGO_KEEP_0__ --delta-onlyPerangkat Anda memiliki koneksi jaringan stabil dan dapat mencapai server __CAPGO_KEEP_0__ --delta Pengaturan
• Your device is running the latest version of the Capgo plugin
• Your device has a stable network connection and can reach the Capgo servers

Anda juga dapat menggunakan aplikasi web Capgo untuk memeriksa detail upload terakhir Anda:

1. Pergi ke aplikasi web
2. Klik pada aplikasi Anda
3. Klik pada jumlah bundle di barikade statistik.
4. Pilih bundle terakhir
5. Periksa Partial laporan

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

Itu saja! Flag ini memerintahkan __CAPGO_KEEP_0__ untuk melakukan upload file individu dan pengembangan manifest yang diperlukan untuk pembaruan Delta (manifest). --delta Jika Anda masih mengalami masalah, silakan menghubungi Capgo untuk bantuan lebih lanjut.

Perlu diingat bahwa Anda harus menggunakan --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 telah berubah.