Pembaruan Otomatis

Mode ini memungkinkan pengembang untuk menggunakan capacitor-updater dengan mode auto-update dan mengirim pembaruan melalui channel Capgo atau yang setara

Prasyarat

Pastikan versi aplikasi Anda menggunakan https://semverorg/ sebelum menggunakan auto-update Capgo

Ini adalah konvensi yang digunakan untuk mengelola versi di Capgo

Ada dua cara untuk mengatur versi di aplikasi Anda:

Cara baru: Gunakan field version di file capacitorconfigjson Anda

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true, // Aktifkan auto-update, true secara default
      "appId": "comexampleapp", // Digunakan untuk mengidentifikasi aplikasi di server
      "version": "100" // Digunakan untuk memeriksa pembaruan
    }
  }
}

Opsi ini akan digunakan oleh plugin untuk memeriksa pembaruan, dan CLI untuk mengunggah versi

Cara lama: Di 3 file dalam proyek Anda:

• packagejson di version
• android/app/buildgradle di versionName
• ios/App/Appxcodeproj/projectpbxproj di CURRENT_PROJECT_VERSION

Tutorial

Siapkan aplikasi Anda dalam 5 menit

Update aplikasi capacitor Anda dengan mulus menggunakan capacitor updater

Siapkan CI Anda dalam 5 menit

Build dan rilis otomatis dengan GitHub actions

Instalasi

npm install @capgo/capacitor-updater
npx cap sync

Pendahuluan

Klik daftar untuk membuat akun Anda

Server memungkinkan Anda mengelola channel dan versi dan banyak lagi

autoUpdate akan menggunakan data dari capacitorconfig untuk mengidentifikasi server Capgo

Note

Anda masih dapat menggunakan Capgo Cloud tanpa mengirim kode Anda ke server kami jika hal tersebut tidak diizinkan oleh perusahaan Anda

Validasi versi

Ketika auto-update diatur, Anda harus memberi tahu dari dalam JS bahwa aplikasi Anda hidup dan siap

Ini dapat dilakukan dengan memanggil notifyAppReady dalam aplikasi Anda

Lakukan sesegera mungkin

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

CapacitorUpdaternotifyAppReady()

Alur pengguna

• Pengguna membuka aplikasi, aplikasi memanggil server untuk memeriksa pembaruan, jika ditemukan akan diunduh di latar belakang
• Pengguna meninggalkan aplikasi, versi baru diatur sebagai aktif
• Pengguna membuka aplikasi lagi, kita memuat versi aktif baru dan mengaturnya sebagai default
• Jika notifyAppReady() dipanggil, ketika pengguna meninggalkan aplikasi, versi sebelumnya dihapus
• Pengguna melanjutkan alur normal aplikasi sampai siklus pembaruan berikutnya

Danger

⚠️ Tidak memanggil notifyAppReady() dalam aplikasi Anda, akan membuat versi saat ini ditandai sebagai tidak valid dan akan kembali ke bundle atau stok valid sebelumnya

Alur pengembangan

Saat Anda mengembangkan fitur baru, pastikan untuk memblokir autoUpdate, karena capgo akan terus menimpa pekerjaan Anda dengan bundle pembaruan terbaru Atur autoUpdate ke false dalam konfigurasi Anda Jika karena suatu alasan Anda terjebak pada pembaruan, Anda dapat menghapus aplikasi dan menginstalnya kembali Pastikan untuk mengatur autoUpdate ke false dalam konfigurasi Anda sebelum melakukannya Dan kemudian build lagi dengan Xcode atau Android studio

Untuk mengunggah versi di setiap commit, atur CI/CD dengan panduan ini

Build dan rilis otomatis dengan GitHub actions

Event Major Available

Ketika disableAutoUpdateBreaking diatur ke true, Anda dapat mendengarkan event untuk mengetahui kapan aplikasi menolak untuk melakukan pembaruan major breaking

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

CapacitorUpdateraddListener('majorAvailable', (info: any) => {
  consolelog('majorAvailable was fired', infoversion)
})