Saltar al contenido principal
@capgo/capacitor-live-reload Actualizaciones Código abierto

Live Reload plugin Capacitor

Conéctate a tu servidor de desarrollo para hot reloading instantáneo

Instalar

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

Guía

Cómo usar Live Reload en Capacitor

Uso de @capgo/capacitor-live-reload

Plugin Capacitor para live reload de apps Capacitor desde un servidor de desarrollo Vite remoto.

Instalar

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

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
configureServer Guarda la configuración del servidor de desarrollo remoto para conexiones posteriores.
connect Establece una conexión WebSocket si no hay una activa.
disconnect Cierra la conexión WebSocket actual y desactiva la reconexión automática.
getStatus Devuelve el estado actual de la conexión.
reload Ejecuta un reload completo de la WebView de Capacitor.
reloadFile Recarga un solo archivo/módulo si el runtime lo permite (si no, recurre a un reload completo).

Ejemplos

configureServer()

Guarda la configuración del servidor de desarrollo remoto para conexiones posteriores.

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

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

connect()

Establece una conexión WebSocket si no hay una activa.

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

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

disconnect()

Cierra la conexión WebSocket actual y desactiva la reconexión automática.

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

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

getStatus()

Devuelve el estado actual de la conexión.

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

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

reload()

Ejecuta un reload completo de la WebView de Capacitor.

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

await LiveReload.reload();

reloadFile()

Recarga un solo archivo/módulo si el runtime lo permite (si no, recurre a un reload completo).

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

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

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o LiveReload.removeAllListeners() para limpiar todos los listeners.

Referencia completa

Continúa desde Using @capgo/capacitor-live-reload

Si estás usando Uso de @capgo/capacitor-live-reload para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-live-reload para los detalles de implementación en @capgo/capacitor-live-reload, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Live Reload

¿Cómo instalo el plugin Live Reload en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-live-reload" (o "npm install @capgo/capacitor-live-reload"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-live-reload" en el code de tu app.

¿Funciona @capgo/capacitor-live-reload con React, Vue y Angular?

Sí. Live Reload es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-live-reload?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-live-reload gratuito y open source?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-live-reload/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code con Live Reload sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Live Reload sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo