Live reload mengubah siklus build, sync, run yang lambat menjadi simpan dan lihat. Di Mac, Capacitor CLI's --live-reload flag ini biasanya langsung berfungsi. Di Windows dan Linux, flag yang sama juga bekerja, tetapi firewall, jaringan emulator, dan routing USB menjadi penyebab utama laporan "tidak reload". Panduan ini membahas setiap kasus.
Cara kerja live reload di Capacitor
Aplikasi native biasanya memuat dist/ dari dalam APK. Dengan server.url diset, WebView memuat dari URL, yaitu dev server Vite atau framework Anda. Hot module replacement kemudian bekerja persis seperti di browser desktop. Tidak ada perubahan native; hanya origin halaman yang berubah.
Dua konsekuensinya:
- Perangkat membutuhkan akses jaringan ke komputer Anda.
- Plain
http://membutuhkancleartext: true, karena Android memblokir trafik cleartext secara default.
Opsi A: flag CLI
Capacitor CLI dapat mengatur ini untuk satu kali eksekusi:
bun run dev -- --host 0.0.0.0 &
bunx cap run android --live-reload --host 192.168.1.20 --port 5173
Ganti host dengan IP LAN komputer Anda. CLI menulis konfigurasi sementara, meluncurkan aplikasi, dan memulihkan konfigurasi setelahnya. Jika dev server Anda menggunakan port lain, berikan port tersebut.
Ini jalur tercepat. Sisanya dari panduan ini menggunakan konfigurasi eksplisit, yang lebih mudah di-debug dan berfungsi dengan dev server framework apa pun.
Opsi B: konfigurasi eksplisit
Mulai dev server yang terikat ke semua antarmuka:
# Vite
bun run dev -- --host 0.0.0.0
# Angular
bunx ng serve --host 0.0.0.0
# Next.js
bun run dev -- -H 0.0.0.0
Lalu buat konfigurasi Capacitor khusus dev. Capacitor membaca capacitor.config.ts, jadi aktifkan melalui variabel lingkungan:
import type { CapacitorConfig } from '@capacitor/cli';
const liveReloadUrl = process.env.CAP_LIVE_RELOAD_URL;
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'my-app',
webDir: 'dist',
...(liveReloadUrl
? { server: { url: liveReloadUrl, cleartext: true } }
: {}),
};
export default config;
Jalankan dengan variabel yang diset:
CAP_LIVE_RELOAD_URL=http://10.0.2.2:5173 bunx cap sync android
bunx cap run android
Di Windows PowerShell:
$env:CAP_LIVE_RELOAD_URL="http://10.0.2.2:5173"; bunx cap sync android
bunx cap run android
Tanpa variabel, cap sync menulis konfigurasi normal dan build release aman.
Emulator: gunakan 10.0.2.2
Di dalam emulator Android, 10.0.2.2 adalah komputer Anda. Berjalan di Windows dan Linux tanpa perlu mengubah firewall, karena trafik tidak pernah keluar dari mesin. Jika masih gagal, pastikan dev server terikat ke 0.0.0.0 dan bukan hanya 127.0.0.1; server yang terikat ke loopback tidak dapat diakses dari jaringan virtual emulator.
HP via USB: adb reverse
Opsi paling bersih untuk perangkat fisik, tanpa perlu Wi-Fi maupun aturan firewall:
adb reverse tcp:5173 tcp:5173
Sekarang localhost:5173 di HP mengarah ke komputer Anda. Atur URL-nya sebagai berikut:
CAP_LIVE_RELOAD_URL=http://localhost:5173 bunx cap sync android
adb reverse akan terhapus saat perangkat menyambung ulang, jadi jalankan lagi setelah mencabut kabel. CLI bisa melakukannya untuk Anda: bunx cap run android --live-reload --host localhost --port 5173 --forwardPorts 5173:5173. Pengguna Linux perlu aturan udev dari panduan setup Linux sebelum adb mendeteksi HP tersebut.
HP via Wi-Fi: IP LAN plus firewall
Jika USB tidak memungkinkan, gunakan LAN IP komputer Anda dan buka portnya.
Cari IP-nya:
# Linux
ip -4 addr show | grep inet
# Windows
ipconfig
Buka port di Windows. Gunakan PowerShell dengan akses administrator:
netsh advfirewall firewall add rule name="Vite dev server" dir=in action=allow protocol=TCP localport=5173
Profil jaringan Public di Windows memblokir koneksi masuk meski sudah ada rule, terutama di beberapa setup korporat; ubah jaringan Wi-Fi ke Private di Settings jika ponsel tetap tidak bisa terhubung.
Di Linux dengan ufw:
sudo ufw allow 5173/tcp
Di Fedora dengan firewalld:
sudo firewall-cmd --add-port=5173/tcp
Lalu:
CAP_LIVE_RELOAD_URL=http://192.168.1.20:5173 bunx cap sync android
bunx cap run android
Kedua perangkat harus berada di subnet yang sama. Jaringan Wi-Fi Guest sering mengisolasi client, yang terlihat persis seperti masalah firewall.
Khusus WSL2
Saat Vite berjalan di dalam WSL2, host Windows tidak otomatis mengekspos port tersebut. Aktifkan mirrored networking di .wslconfig atau tambahkan port proxy di Windows. Detailnya ada di panduan WSL2.
Masalah websocket HMR
Halaman termuat tapi perubahan tidak diterapkan? HMR websocket mencoba terhubung ke host yang salah. Beri tahu Vite alamat publiknya:
// vite.config.ts
export default defineConfig({
server: {
host: '0.0.0.0',
hmr: {
host: '192.168.1.20', // or 10.0.2.2 for the emulator
port: 5173,
},
},
});
Angular dan Next.js punya opsi yang setara; gejalanya sama persis dan solusinya adalah mem-pin host websocket.
Debugging dengan Chrome DevTools
Buka chrome://inspect di Chrome atau Edge di komputer Anda. WebView muncul di bawah perangkat dengan URL dev server. Anda mendapatkan console, network, sources, dan breakpoints, baik di Windows maupun Linux. Jika perangkat tidak muncul, periksa adb devices dan pastikan USB debugging diterima.
Jangan pernah ship konfigurasi dev
Release build dengan server.url set memuat dari mesin yang tidak ada, dan aplikasi menampilkan layar kosong. Lindungi dari hal ini:
- Gunakan pola variabel lingkungan di atas agar config default tidak memiliki
serverblock. - Tambahkan pemeriksaan CI yang gagal jika
android/app/src/main/assets/capacitor.config.jsonberisi"url". - Jika Anda juga menggunakan Live Updates Capgo, perhatikan bahwa
server.urlconfig menimpa bundle updater; pisahkan kedua alur kerja tersebut.
Ringkasan
Live reload di Android berfungsi dari Windows dan Linux dengan tiga detail yang benar: bind dev server ke semua antarmuka, pilih alamat yang benar-benar dapat dijangkau perangkat (10.0.2.2 untuk emulator, adb reverse untuk USB, IP LAN dengan aturan firewall untuk Wi-Fi), dan pastikan konfigurasi dev tidak masuk ke build rilis. Begitu loop iterasi di Android sudah cepat, lapisan web bersama sudah teruji sebelum sampai ke iOS melalui Build Capgo.