Lompat ke konten
Capgo - Perbarui Langsung untuk Aplikasi Capacitor Capgo

Perbaruan Delta

Sistem Capgo’s Live Update dapat mengirimkan pembaruan lebih cepat dan 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 Cara Kerja Pembaruan Delta (Manifest)

Judul bagian “Bagaimana Cara Kerja Pembaruan Delta (Manifest)”

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

  1. Setiap file dalam pembangunan Anda diunggah secara individu
  2. Checksums dibuat 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. 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. Legacy directUpdate konfigurasi masih dideteksi. Gunakan --no-delta untuk memaksa unggah bundle penuh.

Menggunakan Pembaruan Delta (Manifest)

Judul bagian “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/turunannya

Jika Anda perlu melakukan unggahan bundle penuh sementara --delta-only dijadikan, cukup jalankan perintah unggah tanpa --delta-onlyIni akan menggantikan pengaturan untuk unggah tunggal, memungkinkan Anda untuk mendorong bundle lengkap ketika dibutuhkan.

Pengaturan

Jika pembaruan Delta (manifest) tidak tampaknya berfungsi (yaitu perangkat selalu mengunduh bundle JS lengkap bahkan untuk perubahan kecil), pastikan:

Anda menggunakan

  • flag setiap kali Anda unggah versi baru --delta Jika menggunakan
  • , pastikan Anda tidak sengaja mengabaikan --delta-onlyflag --delta Perangkat Anda menjalankan versi terbaru dari plugin __CAPGO_KEEP_0__
  • Perangkat Anda memiliki koneksi jaringan stabil dan dapat mencapai server Capgo
  • Your device has a stable network connection and can reach the Capgo servers

Andamu 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 paket di bar statistik.
  4. Pilih paket terakhir
  5. Periksa Partial laporan jenis paket

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 Live Updates untuk alur kerja produk di Capgo Live Updates, Ringkasan untuk detail implementasi di Ringkasan, Fitur untuk detail implementasi di Fitur-Fitur Perilaku Update untuk detail implementasi di Perilaku Update, dan Jenis Update untuk detail implementasi di Jenis Update.