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 install 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 mendeteksi code native. Import dari "@capgo/capacitor-live-reload" di dalam code aplikasi Anda.

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

Ya. Live Reload 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-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 bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-live-reload/ dan package ini gratis untuk diinstall dari npm. Laporan bug dan pull request sangat kami terima.

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.

Deploy 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