Pembaruan Delta

Sistem Perbarui Langsung Capgo dapat mengirimkan perbaruan lebih cepat dan lebih efisien dengan hanya mengirimkan file yang berubah, bukan bundle JS keseluruhan.

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

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

Bagaimana Perbaruan Delta (Manifest) Bekerja

Perbaruan delta (manifest) di Capgo diatur oleh plugin Capgo yang terinstal di aplikasi Anda. Ketika Anda mengunggah versi baru aplikasi menggunakan flag --delta Capgo melakukan hal berikut:

1. Masing-masing file dalam build Anda diunggah secara individu
2. Checksums dibuat untuk setiap file
3. Manifest json baru dibuat, menampilkan semua file dan checksum mereka
4. Manifest ini diunggah ke database Capgo

Ketika perangkat yang menjalankan aplikasi Anda memeriksa pembaruan, plugin Capgo menerima manifest baru dari server. Plugin ini membandingkan manifest ini dengan yang saat ini, mengidentifikasi file mana yang telah berubah berdasarkan checksum dan jalur file.

Plugin kemudian mengunduh hanya file yang telah berubah, bukan bundle JS seluruhnya. Plugin ini merekonstruksi versi baru aplikasi dengan menggabungkan file yang telah diunduh dengan file yang tidak berubah yang sudah ada.

Manifest

Pada kasus pembaruan Delta (manifest), perangkat menyimpan semua file yang diunduh ke 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 ini saat mengunggah versi baru: --delta ]}

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

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

Pembaruan Delta dengan batasan

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

Mengaktifkan Pengunggahan Delta (Manifest)

Flag: --delta-only Jendela terminal

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

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

Mungkin Anda ingin menggunakan --delta-only jika:

• Anda selalu ingin menggunakan pembaruan Delta (manifest) dan tidak ingin memungkinkan unggahan bundle penuh
• Anda sedang mengatur pipeline CI/CD dan ingin memastikan semua unggahan otomatis menggunakan Delta (manifest)
• Aplikasi Anda besar dan bandwidth terbatas, sehingga Anda perlu meminimalkan ukuran unggahan/download

Jika Anda perlu melakukan unggahan bundle penuh sementara --delta-only dipasang, cukup jalankan perintah unggahan tanpa --delta-only. Ini akan mengatasi pengaturan untuk unggahan tunggal, memungkinkan Anda untuk mengunggah bundle penuh ketika diperlukan

Pengaturan

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

• Anda menggunakan --delta Menggunakan bendera setiap kali Anda mengunggah versi baru
• Jika menggunakan --delta-onlypastikan Anda tidak sengaja mengabaikan bendera --delta Bendera
• Ponsel Anda menjalankan versi terbaru dari plugin Capgo
• Ponsel Anda memiliki koneksi jaringan stabil dan dapat mencapai server-server Capgo

Selain itu, Anda juga dapat menggunakan webapp Capgo untuk memeriksa detail upload terakhir Anda:

1. Pergi ke webapp
2. Klik pada aplikasi Anda
3. Klik pada angka paket di barikade statistik.
4. Pilih paket terakhir
5. Periksa lapangan 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 diproses dengan benar dan perangkat menerima manifest yang diperbarui.

Itu saja! Flag ini meminta __CAPGO_KEEP_0__ untuk melakukan unggahan 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.

setiap kali Anda mengunggah versi baru yang ingin Anda kirim sebagai pembaruan Delta (manifest). Jika Anda melewatkan flag, __CAPGO_KEEP_0__ akan mengunggah bundle JS keseluruhan sebagai file tunggal, dan perangkat akan mengunduh bundle seluruhnya bahkan jika hanya bagian kecil yang berubah. --delta every time you upload a new version that you want to be delivered as a Delta (manifest) update. If you omit the flag, Capgo will upload the entire JS bundle as a single file, and devices will download the whole bundle even if only a small part has changed.

Bab berjudul “Teruskan dari pembaruan Delta”

pembaruan Delta __CAPGO_KEEP_0__ untuk merencanakan pengiriman update live, hubungkannya dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur, Sikap Update untuk detail implementasi di Sikap Update, dan Jenis Update untuk detail implementasi di Jenis Update.