Mulai dengan Cordova Updater

Copas 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/cordova-updater kepada aplikasi Cordova sehingga Anda dapat menerima Capgo pembaruan hidup di iOS dan Android.

ini plugin.

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

Pemasangan

Pasang plugin dari npm dan masukkan ID aplikasi Capgo Anda:
Tampilan jendela terminal
```
cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID
```

Opsional: atur default pada saat pemasangan (variabel yang sama dengan pengatur 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 proyek native setelah mengubah variabel plugin:
Tampilan jendela terminal
```
cordova prepare android ios
```

Penggunaan JavaScript

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

Jenis data TypeScript dikirimkan bersama dengan paket npm:

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

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

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

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

Unggah bundle pertama Anda

Bangun 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 berikutnya

Bandingkan pengaturan dengan Capacitor konfigurasi pembaruan — sebagian besar pilihan terkait dengan plugin.xml Baca
Read Kompatibilitas Live update sebelum mengirimkan perubahan plugin native.
Migrating to Capacitor later? Keep the same Capgo app ID and channels; only the client plugin package changes.