Lompat ke konten
Capgo - Perbarui Hidup untuk Aplikasi Capacitor Capgo

Perbaruan Delta

Sistem Perbarui Langsung Capgo dapat mengirimkan perbarui 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.

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

Bagaimana Perbarui Delta (Manifest) Berfungsi

Bab berjudul “Bagaimana Perbarui Delta (Manifest) Berfungsi”

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

  1. Masing-masing file dalam build Anda diunggah secara individu
  2. Checksums dihasilkan untuk setiap file
  3. Manifest json baru dibuat, yang mencantumkan 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. Plugin ini 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. Plugin ini kemudian 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)”

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

Tampilan jendela Terminal
npx @capgo/cli@latest bundle upload --delta

Jika directUpdate diaktifkan di capacitor.config, CLI mendeteksi hal tersebut. Di lingkungan non-interaktif, CLI mengirimkan pembaruan Delta (manifest) secara otomatis, dan di lingkungan interaktif, CLI meminta konfirmasi Anda sebelum mengunggah. Gunakan --no-delta untuk memaksa unggah bundle penuh.

Mengaktifkan Pembaruan Delta (Manifest)

Bab yang berjudul “Mengaktifkan Pembaruan Delta (Manifest)”

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

Mungkin Anda ingin menggunakan --delta-only jika:

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

Jika Anda perlu melakukan unggah bundle penuh sementara --delta-only dipasang, cukup jalankan perintah unggah tanpa --delta-onlyIni akan mengatasi pengaturan untuk unggah tunggal itu, memungkinkan Anda untuk mengunggah bundle penuh ketika dibutuhkan

Pengaturan Perbaikan

Judul Bagian “Pengaturan Perbaikan”

Jika pembaruan Delta (manifest) tidak tampaknya berfungsi (yaitu perangkat selalu mengunduh bundle JS penuh 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-server __CAPGO_KEEP_0__
  • Anda juga dapat menggunakan aplikasi web Capgo untuk memeriksa detail unggahan terakhir Anda:
  • Your device has a stable network connection and can reach the Capgo servers

You can also use the Capgo webapp to check the details of your last upload:

  1. Pengaturan Perbaikan webapp
  2. Klik pada aplikasi Anda
  3. Klik pada jumlah paket di bar statistik.
  4. Pilih paket terakhir
  5. Periksa Partial lapangan jenis paket

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

Itu saja! Flag ini memerintahkan __CAPGO_KEEP_0__ untuk melakukan unggahan file individu dan penghasilan 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 ini, __CAPGO_KEEP_0__ akan mengunggah bundle JS keseluruhan sebagai file tunggal, dan perangkat akan mengunduh bundle keseluruhan bahkan jika hanya bagian kecil yang berubah. --delta That’s it! The flag tells Capgo to perform the individual file uploads and manifest generation needed for Delta (manifest) updates.