Langsung ke konten
Capgo

V3 から V4 へ

Mengapa upgrade ini

Setelah banyak diskusi di komunitas discord dengan Anda, saya menemukan mode manual sangat terlalu manual dan tidak aman untuk digunakan, misalnya, auto-revert tidak dimungkinkan, jadi jika Anda gagal memperbarui secara manual, pengguna harus menghapus aplikasi dan menginstal kembali, yang merupakan UX yang buruk

Sementara itu, saya mengambil kesempatan ini untuk memberi Anda lebih banyak kebebasan, dan menghapus semua kode buruk yang saya buat

Instalasi

npm i @capgo/capacitor-updater@4

Auto-update cloud

Jika Anda menggunakan contoh dasar di aplikasi Anda, Anda aman untuk bermigrasi ke versi baru, selamat menikmati!

Auto-update self-hosted

Untuk Anda, tetap sederhana, perubahannya adalah:

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

Pengguna manual

Untuk Anda, ini adalah perubahan yang paling signifikan, tetapi untuk yang terbaik! Anda mendapatkan banyak peningkatan, Baca dengan seksama

Perubahan

  • autoUpdateUrl menjadi updateUrl karena pengaturan ini sekarang dapat digunakan dalam mode manual juga
  • Penghapusan cancelDelay dan delayUpdate digantikan oleh setDelay
  • Tidak ada lagi versionName dalam set
  • Perubahan kunci version, yang dikembalikan di sebagian besar fungsi ke objek BundleInfo
interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}
  • Penamaan ulang nama yang menyesatkan sekarang (bahkan untuk menjelaskan tidak bisa jelas, tetapi pada penggunaan mudah memahami yang baru):
    • yang disebut version sekarang mengacu pada bundle
    • id mengacu pada version lama yang merupakan string acak 10 karakter, id ini adalah satu-satunya cara yang dapat dipercaya dan unik untuk mengakses bundle Anda, contoh 7Dfcd2RedN
    • version sekarang mengacu pada versionName yang Anda pilih untuk bundle, contoh 100
  • updateUrl berpindah dari get ke post, karena header kustom menjadi masalah bagi beberapa dari Anda dan post lebih logis, semua header sebelumnya masuk ke body dan prefix cap_ menghilang
  • Metode versionName dihapus, digantikan oleh getId
  • list sekarang mengembalikan daftar BundleInfo
  • Mengganti nama getId menjadi getDeviceId
  • autoUpdate menjadi true secara default, jika Anda menggunakan mode Manual, atur ke false

Berita

  • Metode getLatest, metode ini memungkinkan Anda mendapatkan dari server Anda yang diatur dengan updateUrl versi terakhir yang tersedia
  • Metode setDelay yang mengambil {kind: "background" | "kill" | "nativeVersion" | "date", value?: string} sebagai argumen untuk mengatur delay ke mode berbeda
  • Metode next, untuk mengatur versi di background berikutnya, berlawanan dengan set yang melakukannya secara instan
  • Metode isAutoUpdateEnabled, untuk memberi tahu Anda jika Anda berada dalam konteks auto-update
  • Event downloadComplete ketika download mencapai 100%
  • Menambahkan field wajib version dalam metode download
  • notifyAppReady menjadi wajib dalam mode manual juga, jika tidak dipanggil setelah 10 detik aplikasi kembali ke versi sebelumnya

Kontributor

@lincolnthree Terima kasih banyak telah memulai pekerjaan ini, tidak mungkin membuat pembaruan ini berhasil tanpa Anda