Langsung ke konten utama
@capgo/cordova-updater Update Open source

Updater Cordova Plugin Cordova

OTA live updates untuk Cordova iOS dan Android dengan API yang sama seperti pada capacitor-updater

Instal

bun add @capgo/cordova-updater
npm, pnpm atau yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

Panduan

Cara menggunakan Cordova Updater di Cordova

Menggunakan @capgo/cordova-updater

@capgo/cordova-updater membawa Capgo live updates ke aplikasi Cordova iOS dan Android dengan API JavaScript yang sama seperti @capgo/capacitor-updater. Instal plugin Cordova, panggil notifyAppReady() setiap kali diluncurkan, dan upload bundle dengan @capgo/cli.

Instalasi

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

Penggunaan dasar

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const downloaded = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: downloaded.id });
  }
});

Persyaratan platform

  • Cordova Android 13+ dan Cordova iOS 7+
  • Skema default Cordova WebView (https://localhost/ di Android, app://localhost/ di iOS)
  • Hindari cordova-plugin-ionic-webview — ini mencegah bundle swapping

Deploy bundle baru

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Saran praktis

  • Gunakan kembali Capgo app ID dan channel yang sama jika Anda juga merilis klien Capacitor atau Electron.
  • Perlakukan upgrade plugin native atau platform Cordova seperti perubahan native lainnya: rilis binary store baru sebelum mengandalkan API native baru di JavaScript bundle.
  • Detail setup lengkap ada di dokumentasi updater Cordova.

FAQ

FAQ plugin Cordova Updater

Bagaimana cara menginstal plugin Cordova Updater di aplikasi Cordova?

Jalankan "bun add @capgo/cordova-updater" (atau "npm install @capgo/cordova-updater"), lalu ikuti langkah setup Cordova di panduan dan README GitHub.

Apakah @capgo/cordova-updater bekerja dengan React, Vue, dan Angular?

Ya. Cordova Updater adalah paket Cordova, jadi bekerja dengan framework web apa pun yang berjalan di dalam Cordova, termasuk React, Vue, Angular, Svelte, dan JavaScript murni.

Apakah @capgo/cordova-updater gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/cordova-updater/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request sangat diterima.

Rilis perubahan Cordova Updater tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo