Live reload convierte el lento ciclo de build, sync y run en guardar y ver. En una Mac, el Capacitor CLI's --live-reload flag funciona casi siempre. En Windows y Linux, el mismo flag también funciona, pero los firewalls, la red del emulador y el enrutamiento USB causan la mayoría de los informes de "no se recarga". Esta guía cubre cada caso.
Cómo funciona live reload en Capacitor
La app nativa normalmente carga dist/ desde dentro del APK. Con server.url establecido, el WebView carga desde una URL en su lugar, que es tu servidor de desarrollo de Vite o framework. El reemplazo de módulos en caliente (HMR) funciona exactamente como en un navegador de escritorio. Nada nativo cambia; solo cambia el origen de la página.
Dos consecuencias:
- El dispositivo necesita acceso a la red de tu computadora.
- Plain
http://necesitacleartext: true, porque Android bloquea el tráfico en texto plano por defecto.
Opción A: la bandera CLI
El Capacitor CLI puede configurar esto para una sola ejecución:
bun run dev -- --host 0.0.0.0 &
bunx cap run android --live-reload --host 192.168.1.20 --port 5173
Reemplaza el host con la IP LAN de tu computadora. El CLI escribe una configuración temporal, lanza la app y restaura la configuración después. Si tu servidor de desarrollo usa un puerto diferente, pásalo.
Este es el camino más rápido. El resto de esta guía usa la configuración explícita, que es más fácil de depurar y funciona con el servidor de desarrollo de cualquier framework.
Opción B: configuración explícita
Inicia el servidor de desarrollo unido a todas las interfaces:
# 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
Luego crea una configuración de Capacitor solo para desarrollo. Capacitor lee capacitor.config.ts, así que activa una variable de entorno:
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;
Ejecuta con la variable definida:
CAP_LIVE_RELOAD_URL=http://10.0.2.2:5173 bunx cap sync android
bunx cap run android
En Windows PowerShell:
$env:CAP_LIVE_RELOAD_URL="http://10.0.2.2:5173"; bunx cap sync android
bunx cap run android
Sin la variable, cap sync escribe una configuración normal y los builds de release son seguros.
Emulador: usa 10.0.2.2
Dentro del emulador de Android, 10.0.2.2 es tu computadora. Funciona en Windows y Linux sin cambiar el firewall, porque el tráfico nunca sale de la máquina. Si sigue fallando, confirma que el dev server esté unido a 0.0.0.0 y no solo a 127.0.0.1; un servidor unido a loopback no es accesible desde la red virtual del emulador.
Teléfono USB: adb reverse
La opción más limpia para un dispositivo físico, y no requiere Wi-Fi ni reglas de firewall:
adb reverse tcp:5173 tcp:5173
Ahora localhost:5173 en el teléfono apunta a tu ordenador. Configura la URL en consecuencia:
CAP_LIVE_RELOAD_URL=http://localhost:5173 bunx cap sync android
adb reverse se limpia cuando el dispositivo se reconecta, así que vuelve a ejecutarlo después de desconectarlo. CLI puede hacerlo por ti: bunx cap run android --live-reload --host localhost --port 5173 --forwardPorts 5173:5173. Los usuarios de Linux necesitan la regla udev de la guía de configuración de Linux antes adb ve el teléfono.
Teléfono por Wi-Fi: IP de LAN y firewall
Si el USB no es una opción, usa la IP de la LAN de tu equipo y abre el puerto.
Busca la IP:
# Linux
ip -4 addr show | grep inet
# Windows
ipconfig
Abre el puerto en Windows. Desde un PowerShell con permisos de administrador:
netsh advfirewall firewall add rule name="Vite dev server" dir=in action=allow protocol=TCP localport=5173
Los perfiles de red pública de Windows bloquean las conexiones entrantes incluso con una regla, en algunas configuraciones corporativas; cambia la red Wi-Fi a Privada en Configuración si el teléfono sigue sin conectar.
En Linux con ufw:
sudo ufw allow 5173/tcp
En Fedora con firewalld:
sudo firewall-cmd --add-port=5173/tcp
Luego:
CAP_LIVE_RELOAD_URL=http://192.168.1.20:5173 bunx cap sync android
bunx cap run android
Ambos dispositivos deben estar en la misma subred. Las redes Wi-Fi de invitados suelen aislar a los clientes, lo que parece exactamente un problema de firewall.
Detalles de WSL2
Cuando Vite corre dentro de WSL2, el host de Windows no expone el puerto automáticamente. Activa el mirrored networking en .wslconfig o añade un port proxy en Windows. Los detalles están en la guía de WSL2.
Problemas con el websocket de HMR
¿La página carga pero los cambios no se aplican? El websocket de HMR intenta conectar con el host incorrecto. Indica a Vite la dirección pública:
// 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 y Next.js tienen opciones equivalentes; el síntoma es el mismo y la solución es fijar el host del websocket.
Depurar con Chrome DevTools
Abrir chrome://inspect en Chrome o Edge en tu ordenador. El WebView aparece bajo el dispositivo con la URL del dev server. Tienes consola, network, sources y breakpoints, tanto en Windows como en Linux. Si el dispositivo no aparece, comprueba adb devices y que la depuración USB esté aceptada.
Nunca publiques la config de dev
Un build de release con server.url set carga desde una máquina que no existe, y la app muestra una pantalla en blanco. Evítalo:
- Usa el patrón de variable de entorno anterior para que la configuración predeterminada no tenga
serverblock. - Añade una comprobación de CI que falle si el
android/app/src/main/assets/capacitor.config.jsoncontiene"url". - Si también usas Live Updates de Capgo, ten en cuenta que un
server.urlconfig anula el bundle del actualizador; mantén los dos flujos de trabajo separados.
Resumen
Live reload en Android funciona desde Windows y Linux con tres detalles bien hechos: vincula el servidor de desarrollo a todas las interfaces, elige la dirección a la que el dispositivo puede acceder realmente (10.0.2.2 para el emulador, adb reverse para USB, LAN IP con una regla de firewall para Wi-Fi), y mantén la configuración de dev fuera de los builds de release. Una vez que el ciclo de iteración es rápido en Android, la capa web compartida ya está probada antes de llegar a iOS mediante Build de Capgo.