Lompat ke konten
Capgo - Perbarui Langsung untuk Aplikasi Capacitor Capgo

Perbaruan Delta

Capgo’s Sistem Perbarui Langsung dapat mengirimkan perbarui lebih cepat dan lebih efisien dengan hanya mengirimkan file yang berubah, bukan bundle JS seluruhnya.

Hal ini sangat bermanfaat bagi pengguna yang memiliki koneksi jaringan 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.

Cara Kerja Perbarui Delta (Manifest)

Bab berjudul “Cara Kerja Perbarui Delta (Manifest)”

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

  1. Setiap file dalam build Anda diunggah secara individu
  2. Checksums dibuat untuk setiap file
  3. Manifest JSON baru dibuat, yang mencantum semua file dan checksum-nya
  4. Manifest ini diunggah ke database Capgo

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

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

Mengaktifkan Pembaruan Delta (Manifest)

Judul bagian “Mengaktifkan Pembaruan Delta (Manifest)”

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

Jendela Terminal
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. Pengaturan Legacy masih dideteksi. Gunakan directUpdate untuk memaksa unggah bundle penuh. --no-delta Menggunakan Pembaruan Delta (Manifest)

Bagian berjudul “Menggunakan Pembaruan Delta (Manifest)”

Menggunakan Pembaruan 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:

Jendela terminal
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 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 jika sudah diatur, cukup jalankan perintah unggah tanpa --delta-only Ini akan menggantikan pengaturan untuk unggah tunggal, memungkinkan Anda untuk mendorong bundle lengkap ketika dibutuhkan.

Pengaturan

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

Anda menggunakan flag

  • setiap kali Anda 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__
  • 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 dari upload terakhir Anda:

  1. Pergi ke Aplikasi Web
  2. Klik pada aplikasi Anda
  3. Klik pada jumlah bundle di bar statistik.
  4. Pilih bundle terakhir
  5. Periksa Partial laporan jenis bundle

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 sedang diproses dengan benar dan perangkat menerima manifest yang diperbarui.

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

Judul bagian “Teruskan dari pembaruan Delta”

Jika Anda menggunakan pembaruan Delta untuk merencanakan pengiriman pembaruan hidup, hubungkannya dengan Capgo Pembaruan Hidup untuk alur kerja produk di Capgo Pembaruan Hidup, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur-Fitur, Perubahan Update untuk detail implementasi di Perubahan Update, dan Jenis Update untuk detail implementasi di Jenis Update.