Perbaruan 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 metered, 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.

Bagaimana Cara Kerja Perbarui Delta (Manifest)

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 berikut: --delta flag, Capgo does the following:

1. Checksums dihasilkan untuk setiap file
2. Manifest json baru dibuat, yang mencantumkan semua file dan checksumnya
3. Manifest ini diunggah ke database __CAPGO_KEEP_0__
4. Ketika perangkat yang menjalankan aplikasi Anda memeriksa perbarui, 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

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

Memungkinkan Pembaruan Delta (Manifest)

Untuk memungkinkan 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

diatur ke mode aplikasi instan ( autoUpdate atau"atInstall", "onLaunch") di aplikasi Anda "always"diatur ke mode aplikasi instan ( capacitor.configPerlu diingat, CLI mendeteksi hal tersebut. Di lingkungan non-interaktif, ia mengirimkan pembaruan Delta (manifest) secara otomatis, dan di lingkungan interaktif ia meminta konfirmasi sebelum mengunggah. Legacy directUpdate Pengaturan konfigurasi masih terdeteksi. Gunakan --no-delta untuk memaksa unggah bundle penuh.

Penggunaan Delta

• Bab berjudul “Batasan Pembaruan Delta” The CLI logs Ignoring empty file... __CAPGO_KEEP_0__ merekam
• dan mengabaikan file kosong dari manifest Delta. Ia tidak gagal mengunggah, sehingga menambahkan file kosong dapat mengubah bundle hasil tanpa menghentikan proses peluncuran. Jangan termasuk file kosong dalam jalur bundle Delta. Spasi di jalur:

Pembaruan Delta gagal sebelum mengunggah file ketika jalur bundle mengandung spasi. Ubah nama file atau direktori untuk menghilangkan spasi sebelum mengunggah pembaruan Delta.

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.

Mungkin Anda ingin menggunakan --delta-only if:

• Selalu ingin menggunakan Delta (manifest) update dan tidak 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/dowload

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

Penyelesaian Masalah

Judul bagian berjudul “Penyelesaian Masalah”

• Jika pembaruan Delta (manifest) tidak tampaknya berfungsi (yaitu perangkat selalu mengunduh bundle JS lengkap bahkan untuk perubahan kecil), periksa kembali bahwa: --delta Kamu menggunakan
• flag setiap kali kamu unggah versi baru --delta-onlyJika menggunakan --delta , pastikan kamu tidak sengaja mengabaikan
• Your device is running the latest version of the Capgo plugin
• Perangkat kamu menjalankan versi terbaru dari plugin Capgo

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

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

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

Itu saja! Flag tersebut menginstruksikan __CAPGO_KEEP_0__ untuk melakukan unggah file individu dan pengembangan 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.

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 berubah.

Teruskan dari pembaruan Delta

Jika Anda menggunakan Pembaruan Delta context Capgo Live Updates for the product workflow in Capgo Live Updates, Pembaruan Hidup __CAPGO_KEEP_0__ context Page/area: Halaman produk pembaruan hidup. 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 Hidup Pahlawan). untuk detail implementasi di Fitur-Fitur Tindakan Perbarui untuk detail implementasi di Tindakan Perbarui, dan Jenis Perbarui untuk detail implementasi di Jenis Perbarui.