Mulai dengan Cordova Updater

Copy sebuah 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 mengantarmu untuk menambahkan __CAPGO_KEEP_0__ @capgo/cordova-updater untuk sebuah aplikasi Cordova sehingga Anda dapat menerima Capgo pembaruan live di iOS dan Android.

Bagian berjudul “Prasyarat”

Cordova CLI 12+
Akun __CAPGO_KEEP_0__ (
A Capgo account (Daftar Aplikasi capgo)

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: atur default pada saat pemasangan (variabel yang sama seperti pembarui 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 });
  }
});

Tipe TypeScript dikirimkan bersama dengan paket npm :

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

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

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

Memerlukan Cordova iOS 7+ dengan skema app://localhost/ scheme.
Plugin ini menerapkan CDVPluginSchemeHandler untuk mengintersepsi permintaan bundle.

Unggah bundle pertama Anda

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

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

Langkah selanjutnya

Bandingkan pengaturan dengan Capacitor konfigurasi pembaruan. — sebagian besar pilihan terkait dengan plugin.xml variabel.
Baca Kemampuan pembaruan hidup sebelum mengirimkan perubahan plugin native.
Migrasi ke Capacitor di kemudian hari? Simpan ID aplikasi dan saluran yang sama Capgo; hanya paket plugin klien yang berubah.