Langsung ke konten utama

Live Reload plugin Capacitor

Hubungkan ke dev server untuk hot reloading instan selama development

Instal

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

Panduan

Cara menggunakan Live Reload di Capacitor

Menggunakan @capgo/capacitor-live-reload

Plugin Capacitor untuk live reload aplikasi Capacitor dari remote Vite dev server.

Instal

bun add @capgo/capacitor-live-reload
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { LiveReload } from '@capgo/capacitor-live-reload';

Sekilas tentang API

Metode Deskripsi
configureServer Simpan pengaturan remote dev server yang dipakai untuk koneksi berikutnya.
connect Buat koneksi WebSocket jika koneksi tersebut belum aktif.
disconnect Tutup koneksi WebSocket saat ini dan matikan auto reconnect.
getStatus Mengembalikan status koneksi saat ini.
reload Picu reload penuh pada Capacitor WebView.
reloadFile Reload satu file/modul jika runtime mendukungnya (fallback otomatis ke reload penuh).

Contoh

configureServer()

Simpan pengaturan remote dev server yang dipakai untuk koneksi berikutnya.

import { LiveReload } from '@capgo/capacitor-live-reload';

const result = await LiveReload.configureServer({ url: 'https://example.com' });
console.log(result);

connect()

Buat koneksi WebSocket jika koneksi tersebut belum aktif.

import { LiveReload } from '@capgo/capacitor-live-reload';

const result = await LiveReload.connect();
console.log(result);

disconnect()

Tutup koneksi WebSocket saat ini dan matikan auto reconnect.

import { LiveReload } from '@capgo/capacitor-live-reload';

const result = await LiveReload.disconnect();
console.log(result);

getStatus()

Mengembalikan status koneksi saat ini.

import { LiveReload } from '@capgo/capacitor-live-reload';

const result = await LiveReload.getStatus();
console.log(result);

reload()

Picu reload penuh pada Capacitor WebView.

import { LiveReload } from '@capgo/capacitor-live-reload';

await LiveReload.reload();

reloadFile()

Reload satu file/modul jika runtime mendukungnya (fallback otomatis ke reload penuh).

import { LiveReload } from '@capgo/capacitor-live-reload';

await LiveReload.reloadFile({ path: 'path/to/file' });

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau LiveReload.removeAllListeners() untuk menghapus semua listener.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-live-reload

Jika Anda menggunakan Menggunakan @capgo/capacitor-live-reload untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-live-reload untuk detail implementasi di @capgo/capacitor-live-reload, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.

FAQ

FAQ plugin Live Reload

Bagaimana cara menginstal plugin Live Reload di aplikasi Capacitor?

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

Apakah @capgo/capacitor-live-reload bekerja dengan React, Vue, dan Angular?

Ya. Live Reload adalah paket Capacitor, jadi bekerja dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung @capgo/capacitor-live-reload?

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-live-reload gratis dan open source?

Ya. Source code-nya publik di GitHub pada https://github.com/Cap-go/capacitor-live-reload/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request sangat diterima.

Bisakah saya memperbarui code yang menggunakan Live Reload 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 Live Reload 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