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

Updater plugin Capacitor

Deploy live update Ionic dan Capacitor secara instan ke user tanpa delay 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

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin Updater code

Live update 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, aset, dan perubahan web-layer lainnya setelah native shell Anda sudah disetujui.

Instal

npm install @capgo/capacitor-updater
npx cap sync

Di mana cocoknya

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

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

Apa 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 dari @capgo/capacitor-updater

Jika Anda menggunakan @capgo/capacitor-updater untuk merencanakan live updates, hubungkan dengan Live Update 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 bisa dipakai dengan React, Vue, dan Angular?

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

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

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih 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-nya gratis diinstal dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya update code yang memakai Updater tanpa review App Store?

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

Rilis perubahan Updater tanpa menunggu review aplikasi

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

Mulai dengan Capgo