Saltar al contenido principal

Capacitor Live Reload en Android desde Windows y Linux

Consigue recarga instantánea en un emulador de Android o un teléfono por USB desde Windows o Linux: config de server.url, 10.0.2.2, adb reverse, reglas de firewall, cleartext traffic y cómo evitar publicar la config de dev.

Capacitor live reload en Android desde Windows y Linux Capgo ilustración del blog

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:// necesita cleartext: 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 server block.
  • Añade una comprobación de CI que falle si el android/app/src/main/assets/capacitor.config.json contiene "url".
  • Si también usas Live Updates de Capgo, ten en cuenta que un server.url config 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.

Live updates para apps Capacitor

Cuando un bug de la capa web está en producción, publica el fix a través de Capgo en lugar de esperar días a la aprobación de la app store. Los usuarios reciben la actualización en segundo plano mientras los cambios nativos siguen el flujo de revisión habitual.

Lo último de nuestro blog

Capgo te da la información clave que necesitas para crear una app móvil realmente profesional.