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.

Petunjuk ini akan membantu Anda menambahkan @capgo/cordova-updater ke dalam aplikasi Cordova sehingga Anda dapat menerima Capgo pembaruan hidup pada iOS dan Android.

Prasyarat

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: atur default pada saat 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 });
  }
});

Jenis 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/ Skema default.
Plugin ini mendaftarkan sebuah CordovaPluginPathHandler untuk menyajikan aset bundle yang diunduh.

Memerlukan Cordova iOS 7+ dengan skema app://localhost/ Skema default.
Plugin ini menerapkan CDVPluginSchemeHandler untuk mengintercept permintaan bundle.

Unggah bundle pertama Anda

Buat 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

Sesuaikan pengaturan dengan Capacitor pengaturan pembaruan — sebagian besar pilihan terkait dengan plugin.xml baca
Kompatibilitas pembaruan hidup sebelum mengirimkan perubahan plugin native. Migrasi ke __CAPGO_KEEP_0__ nanti? Simpan ID aplikasi dan saluran yang sama; hanya paket plugin klien yang berubah.
Migrating to Capacitor later? Keep the same Capgo app ID and channels; only the client plugin package changes.