Dari V2 ke V3

Dokumentasi ini akan menjelaskan cara upgrade ke versi 3 auto-update.

Pertama, migrasi ke tooling terbaru:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Hapus semua konfigurasi sebelumnya:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

agar hanya menyisakan ini:

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ Jika Anda menggunakan server Anda, dengan autoUpdateURL, saya akan segera memperbarui panduan ini untuk Anda. Sementara itu, lihat opsi upload baru external yang memungkinkan Anda hanya mengirim link zip, bukan code di cloud Capgo. Ini dibuat untuk perusahaan dengan kebijakan privasi ketat. Dalam mode eksternal, code tidak akan pernah sampai ke server Capgo, kami hanya menyimpan URL dan mengirimkannya ke perangkat, yang akan langsung men-download-nya. Dengan cara standar, code di-zip dan disimpan di server kami, tapi kami tidak akan pernah membukanya atau menggunakannya juga.

Apa yang berubah

Semua konfigurasi untuk auto-update kini ada di sisi server, agar Anda lebih punya kontrol atas cara mengirim update ke pengguna.

Ini memungkinkan kami melakukan revert, bahkan deploy hanya ke satu user dengan channels! Pengaturan ini ditambahkan kembali ke antarmuka web:

• nonaktifkan revert pada native
• nonaktifkan update di atas versi major

⚠️ Ini akan otomatis bernilai true untuk semua channel

Ini juga akan mengurangi frekuensi update plugin, karena sebagian besar update dilakukan di sisi server, dan Anda akan mendapatkannya tanpa perlu mengubah apa pun di sisi Anda.

⚠️ Akan direset saat sebuah update menjadi default, jadi jika Anda tidak ingin menghapus semua versi download saat update dari store, lakukan ini:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

Update code Anda

Terakhir, update semua import JS Anda dari:

import { CapacitorUpdater } from 'capacitor-updater'

ke

import { CapacitorUpdater } from '@capgo/capacitor-updater'

Lalu build code Anda lagi npm run build dan salin aset sekali lagi npx cap copy.

Sekarang Anda sudah bisa mengetes sistem auto-update terbaru

Kirim versi Anda dengan:

npx @capgo/cli@latest bundle upload

alih-alih

npx capgo upload

Evolusi mendatang

Saat ini baru channel publik pertama yang digunakan, ke depannya, public akan berubah menjadi multi public channels jika lebih dari satu diatur.

Masalah umum:

• Masalah build setelah upgrade: jika Anda sudah membuka source code plugin di Android Studio atau Xcode, terkadang sinkronisasi tidak menghapusnya, dan itulah penyebab masalahnya. Buka IDE native dan hapus capacitor-updater secara manual dan lakukan npx cap sync ini seharusnya menyelesaikan masalah.

Lanjutkan dari Dari V2 ke V3

Jika Anda menggunakan Dari V2 ke V3 untuk merencanakan pengiriman live update, hubungkan dengan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates, Ikhtisar untuk detail implementasi di Overview, Fitur untuk detail implementasi di Features, Perilaku Update untuk detail implementasi di Update Behavior, dan Tipe Update untuk detail implementasi di Update Types.