Lompat ke konten
Capgo - Pembaruan Live untuk Aplikasi Capacitor Capgo

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

Keuntungan 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) Bekerja

Judul Bagian “Bagaimana Perbarui Delta (Manifest) Bekerja”

Perbarui delta (manifest) di Capgo diolah oleh plugin Capgo yang terinstal di aplikasi Anda. Ketika Anda mengunggah versi baru aplikasi menggunakan --delta flag, 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

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

Plugin tersebut kemudian mengunduh hanya file yang telah berubah, bukan bundle JS seluruhnya. Plugin tersebut 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)”

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

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

Jika directUpdate diaktifkan di pengaturan Anda, __CAPGO_KEEP_0__ akan mendeteksinya. Di lingkungan non-interaktif, __CAPGO_KEEP_0__ akan mengirimkan pembaruan Delta (manifest) secara otomatis, dan di lingkungan interaktif, __CAPGO_KEEP_0__ akan meminta konfirmasi sebelum mengunggah. Gunakan capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Use --no-delta 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 flag:

flag:

Enforcing Delta (Manifest) Updates --delta-only Section titled “Enforcing Delta (Manifest) Updates”

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 lengkap
  • 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 unggah/turun.

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

Pengaturan Masalah

Judul Bagian “Pengaturan Masalah”

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 __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. Pilih halaman webapp
  2. Klik pada aplikasi Anda
  3. Klik pada jumlah bundle di bar statistik.
  4. Pilih bundle terakhir
  5. Periksa Partial lapangan jenis bundle

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