V2 ke V3
Dokumentasi ini akan menjelaskan cara meningkatkan ke versi 3 dari auto-update
Pertama migrasikan ke tooling terbaru:
npm remove -g capgonpm remove capacitor-updater
npm i @capgo/clinpm i @capgo/capacitor-updater@3npx cap sync
Hapus semua konfigurasi sebelumnya:
{ CapacitorUpdater: { autoUpdateURL: "https",
},}
sehingga hanya tersisa ini:
{ "CapacitorUpdater": { "autoUpdate": true }}
⚠️ Jika Anda menggunakan server Anda sendiri dengan
autoUpdateURL
, saya akan segera memperbarui panduan ini untuk Anda. Sementara itu, lihat opsi upload baruexternal
yang memungkinkan Anda untuk hanya mengirim tautan zip Anda, bukan kode di Capgo cloud. Ini dibuat untuk perusahaan dengan kebijakan privasi yang ketat. Dalam mode external, kode tidak akan pernah masuk ke server Capgo, kami hanya menyimpan URL dan mengirimkannya ke perangkat, yang akan langsung mengunduhnya. Dalam cara standar, kode dikompresi dan disimpan di server kami, tetapi kami tidak akan pernah membukanya atau menggunakannya juga
Apa yang berubah
Semua konfigurasi menjadi server-side untuk auto-update, untuk memberi Anda lebih banyak kontrol tentang bagaimana Anda mengirim pembaruan ke pengguna
Hal ini memungkinkan kita untuk mengembalikan, bahkan menerapkan hanya ke satu pengguna dengan channel! Pengaturan ini ditambahkan kembali ke antarmuka web:
- menonaktifkan pengembalian di bawah native
- menonaktifkan pembaruan di atas major
⚠️ Mereka akan menjadi true secara default untuk semua channel
Ini juga akan menghilangkan kebutuhan untuk sering memperbarui plugin, kebanyakan pembaruan akan dilakukan di sisi server, dan Anda akan mendapatkannya tanpa perubahan apa pun di sisi Anda
⚠️ Reset ketika pembaruan menjadi default, jadi jika Anda lebih suka untuk tidak menghapus semua versi unduhan saat memperbarui dari toko, lakukan ini:
{ "CapacitorUpdater": { "autoUpdate": true, "resetWhenUpdate": false }}
Perbarui kode Anda
Terakhir, perbarui semua impor di JS dari:
import { CapacitorUpdater } from 'capacitor-updater'
menjadi
import { CapacitorUpdater } from '@capgo/capacitor-updater'
Kemudian build kode Anda lagi npm run build
dan salin aset sekali lagi npx cap copy
Sekarang Anda seharusnya bisa menguji sistem auto-update terbaru
Kirim versi Anda dengan:
npx @capgo/cli@latest bundle upload
alih-alih
npx capgo upload
Evolusi mendatang
Untuk saat ini hanya channel publik pertama yang digunakan, di masa depan, publik akan berubah untuk multi channel publik, jika lebih dari satu diatur
Masalah umum:
- Masalah build setelah upgrade: jika Anda sudah membuka source code plugin di Android studio atau Xcode, terkadang sync tidak menghapusnya, itu penyebab masalahnya. Buka IDE native dan hapus
capacitor-updater
secara manual dan lakukannpx cap sync
ini seharusnya menyelesaikan masalah