Perbarui delta

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

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

Benefit lainnya 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 Pembaruan Delta Bekerja

Pembaruan delta 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 melakukan hal berikut:

1. Setiap file dalam build Anda diunggah secara individu sebagai file delta
2. Checksums dibuat untuk setiap file delta
3. Daftar file delta beserta jalur dan checksumnya disimpan di database Capgo.

When a device running your app checks for an update, the Capgo plugin receives the list of delta files for the new bundle. It compares it to the files it already has, identifying which files have changed based on the checksums and file paths.

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

Cache file delta

Dengan pembaruan Delta, perangkat menyimpan semua file delta yang diunduh dalam cache umum. Capgo tidak pernah membersihkannya, tetapi sistem operasi dapat membersihkannya kapan saja.

Perangkat mana yang mendapatkan Delta dan mana yang mendapatkan zip penuh

Bundle yang diunggah dengan --delta memiliki baik zip penuh dan file delta. Pada saluran dengan format unduh default Zip + delta format unduh, perangkat masing-masing mendapatkan paket terbaik yang didukung:

• Perangkat pada versi plugin dengan dukungan Delta (“5.10.0+, 6.25.0+, 7.0.35+, atau 8+Unduh hanya delta file yang berubah.
• Perangkat pada versi plugin yang lebih tua tanpa dukungan Delta mengunduh zip penuh.
• Tidak ada bundle yang diunggah --delta Tidak ada delta file, jadi setiap perangkat mengunduh zip penuh.

Jadi masih ada beberapa unduhan zip penuh setelah Anda mengaktifkan Delta. Mereka berasal dari perangkat yang masih menjalankan build asli dengan versi plugin yang lebih tua. Mereka akan hilang ketika pengguna memperbarui aplikasi dari toko.

Anda dapat mengubah ini per saluran dengan menggunakan Pengaturan Format Unduh setting.

Pengaturan dan penggunaan bandwidth Delta

Delta updates also lower your Capgo bandwidth usage. Bandwidth only counts the files a device actually downloads, so with Delta only the changed files count, not the whole bundle. Files or full zips already cached at the edge do not count, and interrupted downloads resume where they stopped without counting the downloaded part twice. See Bagaimana Bandwidth Dihitung?.

Mengaktifkan Perbaruan Delta

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

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

Gunakan --delta dengan mode apply instan

When autoUpdate Ketika "atInstall", "onLaunch"adalah "always", unggah dengan --deltaSaat pengguna menunggu, mode-mode tersebut mempengaruhi pengalaman pengguna. Mereka juga memerlukan autoSplashscreen: true dan @capacitor/splash-screen bersama launchAutoHide: false. Lihat Sikap 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 secara otomatis, dan di lingkungan interaktif ia meminta konfirmasi sebelum mengunggah. Konfigurasi legacy masih dideteksi. Gunakan directUpdate untuk memaksa unggah bundle penuh. --no-delta Mengunggah paket lengkap secara paksa.

Keterbatasan pembaruan delta

• File kosong: The CLI logs Ignoring empty file... dan mengabaikan file kosong dari file delta. Ini tidak akan gagal mengunggah, sehingga menambahkan file kosong dapat mengubah bundle hasil tanpa menghentikan proses pengembangan. Jangan termasuk file kosong dalam jalur bundle Delta.
• Spasi dalam jalur: Pengunggahan delta gagal sebelum mengunggah file ketika jalur bundle mengandung spasi. Ubah nama file atau direktori untuk menghilangkan spasi sebelum mengunggah pembaruan Delta.

Menggunakan Pembaruan Delta

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

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

Mengapa --delta-only Digunakan, Capgo hanya akan mengunggah file delta, tanpa zip penuh. Apapun perangkat pada versi plugin tanpa dukungan Delta tidak akan dapat mengunduh pembaruan.

Mungkin Anda ingin menggunakan --delta-only Jika:

• Selalu ingin menggunakan pembaruan Delta dan tidak ingin memungkinkan unggah bundle penuh
• Anda sedang mengatur pipeline CI/CD dan ingin memastikan semua unggahan otomatis menggunakan Delta
• Aplikasi Anda besar dan bandwidth terbatas, jadi Anda perlu meminimalkan ukuran upload/download

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

Pengaturan Masalah

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

• Anda menggunakan Live Update. --delta tandai setiap kali Anda mengunggah versi baru
• Jika menggunakan --delta-onlyPastikan Anda tidak sengaja mengabaikan. --delta flag
• Perangkat Anda menjalankan versi plugin dengan dukungan Delta ("5.10.0+, 6.25.0+, 7.0.35+, or 8+)
• Format download kanal tidak tersedia Arsip lengkap
• Perangkat kamu memiliki koneksi jaringan stabil dan dapat mencapai server Capgo

Kamu juga dapat menggunakan aplikasi web Capgo untuk memeriksa detail dari upload terakhirmu:

1. Pergi ke aplikasi Aplikasi
2. Klik pada aplikasi kamu
3. Klik pada jumlah paket di barikade statistik.
4. Pilih paket terakhir
5. Periksa Delta files Tidak ada file delta Tidak ada file delta ketika paket tersebut diunggah sebagai zip penuh saja.

If you continue to have trouble, please reach out to Capgo support for further assistance. They can check the server logs to confirm that your Delta uploads are being processed correctly and that devices are receiving the delta files.

Sudah selesai! Itu adalah --delta flag menginformasikan Capgo untuk mengunggah file delta individu yang diperlukan untuk pembaruan Delta.

Teruskan dari pembaruan Delta --delta every time you upload a new version that you want to be delivered as a Delta 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.

Jika Anda menggunakan pembaruan Delta

Jika Anda menggunakan Perubahan Delta untuk merencanakan pengiriman live update, hubungkan dengan Capgo Perbarui Langsung untuk alur kerja produk dalam Capgo Live Updates, Overview untuk detail implementasi di Ringkasan Fitur untuk detail implementasi di Fitur Perilaku Perbarui untuk detail implementasi di Perilaku Perbarui, dan Jenis Perbarui untuk detail implementasi di Jenis Perbarui.