Memulai dengan Cordova Updater
Salin prompt setup yang berisi langkah install 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 memandu Anda menambahkan @capgo/cordova-updater ke aplikasi Cordova agar Anda bisa menerima Capgo live updates di iOS dan Android.
Prerequisites
Bagian berjudul “Prasyarat”- Cordova CLI 12+
- Cordova Android 13+ dan/atau Cordova iOS 7+
- Akun Capgo (capgo.app/register)
Instalasi
Bagian berjudul “Instalasi”-
Install plugin dari npm dan berikan app ID Capgo Anda:
Jendela terminal cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID -
Opsional: override nilai default saat instalasi (variabel yang sama dengan updater Capacitor):
Jendela terminal 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 project native setelah mengubah variabel plugin:
Jendela terminal cordova prepare android ios
Mulai cepat
Bagian berjudul “Mulai cepat”document.addEventListener('deviceready', async () => { await cordova.plugins.Updater.notifyAppReady();});Kesalahan umum
Bagian berjudul “Kesalahan umum”- Jangan gunakan cordova-plugin-ionic-webview dengan plugin ini.
- Panggil
notifyAppReady()segera setelah bundle dimuat—sebelum proses UI yang berat menunda jendela rollback. - Pastikan pengaturan scheme Cordova sudah benar.
Penggunaan JavaScript
Bagian berjudul “JavaScript usage”Setelah deviceready, plugin ini tersedia melalui 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 sudah termasuk dalam paket npm:
import type { UpdaterPlugin } from '@capgo/cordova-updater';
declare const cordova: { plugins: { Updater: UpdaterPlugin } };Catatan platform
Bagian berjudul “Catatan platform”- Memerlukan Cordova Android 13+ agar WebView disajikan dari default
https://localhost/scheme default. - Plugin ini mendaftarkan sebuah
CordovaPluginPathHandleruntuk menyajikan aset bundle yang diunduh.
- Membutuhkan Cordova iOS 7+ dengan
app://localhost/scheme default. - Plugin ini mengimplementasikan
CDVPluginSchemeHandleruntuk mencegat request bundle.
Upload bundle pertama Anda
Bagian berjudul “Upload bundle pertama Anda”Build web assets Anda, lalu upload dengan Capgo CLI (workflow yang sama dengan Capacitor):
bun run buildnpx @capgo/cli@latest bundle upload --channel=productionLangkah berikutnya
Bagian berjudul “Langkah selanjutnya”- Bandingkan pengaturan dengan Konfigurasi updater Capacitor — sebagian besar opsi dipetakan ke
plugin.xmlvariabel. - Baca Kompatibilitas Live update sebelum merilis perubahan plugin native.
- Migrasi ke Capacitor nanti? Tetap gunakan Capgo app ID dan channel yang sama; hanya package plugin client yang berubah.