Mulai dengan Cordova Updater

Salin prompt pengaturan dengan langkah instalasi 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 mengajarkan Anda cara menambahkan @capgo/cordova-updater ke dalam aplikasi Cordova sehingga Anda dapat menerima Capgo pembaruan hidup secara langsung di iOS dan Android.

Prasyarat

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

Pemasangan

Pasang plugin dari npm dan masukkan ID aplikasi Capgo Anda:

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

Opsional: menggantikan default pada saat instalasi (variabel yang sama dengan pembaruan Capacitor):

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 proyek native setelah mengubah variabel plugin:
Jendela terminal
```
cordova prepare android ios
```

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 });
  }
});

npm menyediakan jenis TypeScript:

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

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

Memerlukan Cordova Android 13+ sehingga WebView disajikan dari skema default. https://localhost/ Plugin mendaftarkan sebuah
untuk menyajikan aset bundle yang diunduh. CordovaPluginPathHandler Memerlukan Cordova iOS 7+ dengan skema default

__CAPGO_KEEP_0__ app://localhost/ skema.
Plugin ini mengimplementasikan CDVPluginSchemeHandler untuk mengintersepsi permintaan bundle.

Unggah bundle pertama Anda

Buat aset web Anda, kemudian unggah dengan Capgo CLI (alur kerja yang sama seperti Capacitor):

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

Langkah selanjutnya

Bandingkan pengaturan dengan konfigurasi pembaruan __CAPGO_KEEP_0__ Konfigurasi pembaruan Capacitor — sebagian besar opsi menerjemahkan ke plugin.xml variabel.
Baca Kompatibilitas pembaruan langsung Sebelum mengirimkan perubahan plugin native.
Migrasi ke Capacitor nanti? Simpan ID aplikasi dan saluran yang sama Capgo; hanya perubahan paket plugin klien.