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.

Ini adalah panduan yang akan mengantarkan Anda untuk menambahkan @capgo/cordova-updater ke dalam aplikasi Cordova sehingga Anda dapat menerima Capgo pembaruan live di iOS dan Android.

dengan plugin ini. Ionic WebView menghindari penggunaan handler skema Cordova, sehingga bundle yang diunduh tidak akan terbuka.

Cordova CLI 12+
Android Cordova 13+ dan/atau iOS Cordova 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: override default pada waktu pemasangan (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 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 });
  }
});

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 skema default. https://localhost/ Plugin ini mendaftarkan sebuah
untuk menyajikan aset bundle yang diunduh. CordovaPluginPathHandler Memerlukan Cordova iOS 7+ dengan skema default.

Plugin ini menerapkan app://localhost/ untuk mengintercept permintaan bundle.
Unggah bundle pertama Anda CDVPluginSchemeHandler Judul bagian “Unggah bundle pertama Anda”

Buatlah aset web Anda, kemudian unggah dengan __CAPGO_KEEP_0 CAPGO_KEEP_1 (sama dengan alur kerja CAPGO_KEEP_2__):

Build your web assets, then upload with the Capgo CLI (same workflow as Capacitor):

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

Langkah selanjutnya

Bandingkan pengaturan dengan konfigurasi Capacitor updater configuration baca plugin.xml Kompatibilitas pembaruan hidup
sebelum mengirimkan perubahan plugin native. Migrasi ke kemudian? Simpan ID aplikasi dan saluran yang sama; hanya paket plugin klien yang berubah. Baca
Migrating to Capacitor later? Keep the same Capgo app ID and channels; only the client plugin package changes.