Memulai dengan Cordova Updater

Copy prompt setup berisi langkah install dan panduan markdown lengkap untuk plugin ini.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/cordova-updater`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/cordova-updater/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Panduan ini akan memandu Anda menambahkan @capgo/cordova-updater ke aplikasi Cordova agar Anda bisa menerima Capgo live updates di iOS dan Android.

Prerequisites

Cordova CLI 12+
Cordova Android 13+ dan/atau Cordova iOS 7+
Akun Capgo (capgo.app/register)

Instalasi

Instal plugin dari npm dan masukkan Capgo app ID Anda:

cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID

Opsional: timpa pengaturan default saat instalasi (variabel yang sama dengan Capacitor updater):

cordova plugin add @capgo/cordova-updater \
  --variable APP_ID=YOUR_CAPGO_APP_ID \
  --variable DEFAULT_CHANNEL=production \
  --variable UPDATE_URL=https://plugin.capgo.app/updates \
  --variable AUTO_UPDATE=atBackground

Siapkan native project setelah mengubah variabel plugin:
Jendela terminal
```
cordova prepare android ios
```

Mulai cepat

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

Masalah umum

Jangan gunakan cordova-plugin-ionic-webview dengan plugin ini.
Panggil notifyAppReady() segera setelah bundle dimuat—sebelum proses UI yang berat menunda jendela rollback.
Pastikan pengaturan scheme Cordova sudah benar.

Penggunaan JavaScript

Setelah deviceready, plugin ini tersedia sebagai cordova.plugins.Updater:

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

  await Updater.notifyAppReady();

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

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

Tipe TypeScript disertakan dalam paket npm:

import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };

Membutuhkan Cordova Android 13+ agar WebView disajikan dari default https://localhost/ scheme default.
Plugin ini mendaftarkan CordovaPluginPathHandler untuk menyajikan aset bundle yang diunduh.

Membutuhkan Cordova iOS 7+ dengan app://localhost/ scheme default.
Plugin ini mengimplementasikan CDVPluginSchemeHandler untuk mencegat request bundle.

Upload bundle pertama Anda

Build web assets Anda, lalu upload menggunakan Capgo CLI (workflow yang sama dengan Capacitor):

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

Next steps

Bandingkan pengaturan dengan konfigurasi Capacitor updater — sebagian besar opsi sesuai dengan plugin.xml variabel.
Baca kompatibilitas Live update sebelum merilis perubahan plugin native.
Migrasi ke Capacitor nanti? Tetap gunakan Capgo app ID dan channel yang sama; hanya package plugin client yang berubah.