Dari V3 ke V4

Mengapa perlu upgrade ini

Setelah banyak diskusi di komunitas Discord bersama Anda. Saya menemukan bahwa mode manual sangat terlalu manual dan tidak aman untuk digunakan, misalnya, auto-revert tidak mungkin, jadi jika Anda gagal melakukan update secara manual, pengguna harus menghapus aplikasi dan menginstal kembali, yang sangat buruk untuk pengalaman pengguna.

Sementara itu, saya mengambil kesempatan ini untuk memberikan lebih banyak kebebasan kepada Anda, dan menghapus semua hal buruk code yang saya buat.

Pasang

npm i @capgo/capacitor-updater@4

Perbarui cloud otomatis

Jika Anda menggunakan contoh dasar di aplikasi Anda, Anda aman untuk melakukan migrasi ke versi baru, nikmati!

Perbarui self-hosted otomatis

Bagi Anda, masih sederhana, perubahan adalah:

• Nama pengaturan dari autoUpdateUrl di updateUrl
• Metode Endpoint telah berubah dari GET ke POST

Pengguna Manual

Bagi Anda, perubahan ini paling signifikan, tetapi untuk yang terbaik! Anda mendapatkan banyak perbaikan, Baca dengan teliti.

Perubahan

• autoUpdateUrl menjadi updateUrl karena pengaturan ini dapat digunakan dalam mode manual sekarang juga
• Penghapusan cancelDelay dan delayUpdate dalam kepentingan setDelay
• Tidak ada lagi versionName dalam set
• Ubah version kunci, yang dikembalikan dalam fungsi ke objek BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

• Nama yang menyesatkan telah diubah (meskipun tidak bisa dijelaskan dengan jelas, tetapi pada penggunaan mudah dipahami nama baru):
  • apa yang disebut version sekarang merujuk pada bundle
  • id merujuk ke yang lama version yang merupakan string acak 10 karakter, ini id adalah satu-satunya cara yang dapat diandalkan dan unik untuk mengakses bundle Anda, contoh 7Dfcd2RedN.
  • version sekarang merujuk ke versionName Anda memilih untuk bundle contoh 1.0.0
• updateUrl dari get ke post, karena header kustom menjadi masalah bagi beberapa orang dan post lebih logis, semua header sebelumnya pergi ke body dan prefix cap_ hilang.
• versionName metode dihapus, digantikan oleh getId
• daftar kembali sekarang mengembalikan daftar dari BundleInfo
• Ubah Nama getId di getDeviceId
• autoUpdate sudah menjadi true secara default, jika Anda menggunakan mode Manual, atur ke false.

Berita

• Metode getLatest, metode ini memungkinkan Anda untuk mendapatkan dari server Anda yang telah ditetapkan dengan updateUrl versi terakhir yang tersedia.
• Metode setDelay yang mengambil {jenis: “latar belakang” | “hancurkan” | “versi native” | “tanggal”, nilai? : string} sebagai argumen untuk menetapkan delay ke mode yang berbeda.
• Metode next, untuk menetapkan versi di latar belakang berikutnya, di sisi lain dari set yang melakukannya secara langsung.
• Metode isAutoUpdateEnabled, untuk memberitahu Anda jika Anda berada dalam konteks auto-update
• Event downloadComplete ketika download mencapai 100%
• Ditambahkan lapangan wajib version di metode download
• notifyAppReady juga menjadi wajib dalam mode manual, jika tidak dipanggil setelah 10 detik aplikasi kembali ke versi sebelumnya.

Kontributor

@lincolnthree Terima kasih banyak atas kerja sama Anda, tidak mungkin membuat update ini berjalan tanpa Anda.