Lompat ke konten utama
@capgo/capacitor-updater Update Open source

Updater plugin Capacitor

Deploy live update Ionic dan Capacitor secara instan ke pengguna tanpa penundaan review App Store

Instal

bun add @capgo/capacitor-updater bunx cap sync
npm, pnpm, atau yarn
  • npm install @capgo/capacitor-updater
  • pnpm add @capgo/capacitor-updater
  • yarn add @capgo/capacitor-updater

Panduan

Cara menggunakan Updater di Capacitor

Tes di perangkat

Unduh aplikasi Capgo, lalu pindai QR code.

QR preview plugin Updater code

Live updates Ionic dan Capacitor dengan @capgo/capacitor-updater

@capgo/capacitor-updater adalah plugin updater open-source di balik live updates Capgo untuk aplikasi Ionic dan Capacitor. Plugin ini mengunduh web bundle yang disetujui, menerapkannya dengan proteksi rollback native, dan menjaga perubahan binary tetap pada jalur review App Store dan Play yang normal.

Gunakan ini saat Anda butuh update OTA untuk HTML, CSS, JavaScript, assets, dan perubahan web-layer lainnya setelah native shell Anda disetujui.

Instal

npm install @capgo/capacitor-updater
npx cap sync

Cara Kerjanya

Bagi tim Ionic, live updates biasanya berarti workflow yang sama: kirim web bundle baru tanpa memaksa setiap user melewati full store release. Capgo menangani workflow tersebut untuk aplikasi Capacitor dengan fitur channels, pengecekan kompatibilitas, kontrol rollout, device logs, dan rollback.

Plugin native, entitlements, perubahan Android manifest, perubahan iOS plist, dan update binary SDK tetap memerlukan rilis app store normal. Kelola perubahan tersebut di pipeline Native Build Anda dan gunakan live updates untuk web layer yang sudah disetujui.

Yang Diekspos Plugin Ini

  • notifyAppReady - Beri tahu native layer bahwa JavaScript berhasil diinisialisasi.
  • setUpdateUrl - Atur URL update aplikasi secara dinamis saat runtime.
  • setStatsUrl - Atur URL statistik aplikasi secara dinamis saat runtime.
  • setChannelUrl - Atur URL channel aplikasi secara dinamis saat runtime.

Contoh Penggunaan

notifyAppReady

Beri tahu native layer bahwa JavaScript berhasil diinisialisasi.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

const result = await CapacitorUpdater.notifyAppReady();
console.log(result);

setUpdateUrl

Atur URL update aplikasi secara dinamis saat runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });

setStatsUrl

Atur URL statistik aplikasi secara dinamis saat runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });

setChannelUrl

Atur URL channel aplikasi secara dinamis saat runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });

Referensi Lengkap

Lanjutkan bersama @capgo/capacitor-updater

Jika Anda menggunakan @capgo/capacitor-updater untuk merencanakan live updates, hubungkan dengan Live Updates untuk alur kerja produk, @capgo/capacitor-updater untuk detail implementasi, Panduan Memulai, Channel, dan Rollback.

FAQ

FAQ plugin Updater

Bagaimana cara install plugin Updater di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-updater" (atau "npm install @capgo/capacitor-updater"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-updater" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-updater mendukung React, Vue, dan Angular?

Ya. Updater adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-updater?

Plugin Capgo mengikuti versi major Capacitor: gunakan versi major plugin yang cocok dengan versi major Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang di-maintain.

Apakah @capgo/capacitor-updater gratis dan open source?

Ya. Source code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-updater/ dan package ini gratis untuk diinstall dari npm. Bug reports dan pull requests sangat kami terima.

Bisakah saya mengupdate code yang menggunakan Updater tanpa melalui review App Store?

Install atau upgrade plugin akan mengubah code native, sehingga butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin tersebut bisa langsung dikirim via Capgo live updates.

Rilis perubahan Updater tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, Capgo live updates mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo