Auto Update

Salin permintaan pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Penjelasan ini akan menjelaskan cara menjalankan server auto-update Anda.

Sajikan paket Anda

Pastikan paket Anda disajikan melalui HTTPS, dan server memiliki header CORS yang tepat untuk memungkinkan aplikasi mengunduh update. e.g. https://myserver.com/app/updates/updates.json

Jika Anda tidak familiar dengan penyediaan bundle, kami merekomendasikan Anda mencoba Capgo Cloud atau melihat contoh di sini:

Penyediaan Bundle

Konfigurasi

Tambahkan updateUrl ke dalam capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

Pembaruan API

Plugin akan melakukan panggilan POST ke API Anda setiap kali aplikasi dibuka, dengan tubuh ini:

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

Server API harus menjawab, dalam format JSON, ke plugin pembarui capacitor-nya. Dengan data ini jika perbarui diperlukan:

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

Pada mode pembarui otomatis, server harus membandingkan versi dan mengembalikan yang tepat, jika kunci URL ada, plugin memulai proses download.

Jika Anda menambahkan kunci “pesan” dan “kesalahan”, versi tidak akan ditetapkan, dan pesan akan ditampilkan di log bukan.

version Kunci harus dalam semver format.

Arsip zip harus memiliki index.html sebagai file di root, atau hanya satu folder di root dengan index.html di dalamnya.

Anda dapat menggunakan perintah dari CLI untuk mengompres bundle Anda:

npx @capgo/cli bundle zip --path [/path/to/my/bundle]

Menghasilkan Ceksum Bundle

Penting: Anda harus menggunakan Capgo CLI untuk membuat file zip bundle Anda. Plugin Capgo memerlukan format dan struktur zip tertentu yang hanya dapat dipastikan ketika menggunakan alat resmi CLI. Utilitas zip standar mungkin menciptakan arsip yang tidak kompatibel.

Untuk menghasilkan ceksum untuk bundle Anda, gunakan perintah Capgo CLI zip dengan flag: --json Buat bundle dengan informasi ceksum

npx @capgo/cli bundle zip [appId] --json

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__

Buat file zip yang sesuai dengan format Capgo plugin
Generate checksum SHA256 untuk verifikasi integritas
Tampilkan informasi bundle dalam format JSON

Contoh output:

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

Gunakan checksum nilai dari output ini dalam respons API Anda untuk memastikan plugin dapat memverifikasi integritas bundle sebelum instalasi.

Teruskan dari Auto Update

Jika Anda menggunakan Auto Update untuk merencanakan migrasi dan operasi bisnis, hubungkannya dengan Penggunaan @capgo/capacitor-updater Penggunaan @capgo/capacitor-updater, Capgo Enterprise Penggunaan @Capgo/__CAPGO_KEEP_1__-updater untuk alur kerja produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise Penggunaan @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater untuk alur kerja produk di Alternatif Plugin Ionic Enterprise, Capgo Alternatif Penggunaan @Capgo/__CAPGO_KEEP_1__-updater untuk alur kerja produk di Capgo Alternatif, dan Capgo Konsultasi Penggunaan @Capgo/__CAPGO_KEEP_1__-updater untuk alur kerja produk di Capgo Konsultasi.