Aller au contenu principal
@capgo/capacitor-live-reload Mises à jour Open source

Live Reload Plugin Capacitor

Connectez-vous à votre serveur de dev pour un hot reloading instantané pendant le développement

Installer

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

Guide

Comment utiliser le Live Reload dans Capacitor

Utiliser @capgo/capacitor-live-reload

Le plugin Capacitor pour le live reload des apps Capacitor depuis un serveur de dev Vite distant.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
configureServer Enregistre les paramètres du serveur de dev distant pour les connexions suivantes.
connect Établit une connexion WebSocket si aucune n'est déjà active.
disconnect Ferme la connexion WebSocket actuelle et désactive la reconnexion automatique.
getStatus Renvoie le statut de la connexion actuelle.
reload Déclenche un rechargement complet de la WebView Capacitor.
reloadFile Recharge un seul fichier/module si le runtime le permet (sinon, rechargement complet).

Exemples

configureServer()

Enregistre les paramètres du serveur de dev distant pour les connexions suivantes.

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

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

connect()

Établit une connexion WebSocket si aucune n'est déjà active.

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

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

disconnect()

Ferme la connexion WebSocket actuelle et désactive la reconnexion automatique.

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

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

getStatus()

Renvoie le statut de la connexion actuelle.

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

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

reload()

Déclenche un rechargement complet de la WebView Capacitor.

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

await LiveReload.reload();

reloadFile()

Recharge un seul fichier/module si le runtime le permet (sinon, rechargement complet).

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

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

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou LiveReload.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuer depuis Using @capgo/capacitor-live-reload

Si vous utilisez Utiliser @capgo/capacitor-live-reload pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-live-reload pour les détails d'implémentation dans @capgo/capacitor-live-reload, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.

FAQ

FAQ du plugin Live Reload

Comment installer le plugin Live Reload dans une app Capacitor ?

Exécutez "bun add @capgo/capacitor-live-reload" (ou "npm install @capgo/capacitor-live-reload"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-live-reload" dans votre code.

Est-ce que @capgo/capacitor-live-reload fonctionne avec React, Vue et Angular ?

Oui. Live Reload est un package Capacitor, il fonctionne donc avec n'importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et du JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-live-reload ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-live-reload est gratuit et open source ?

Oui. Le code source est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-live-reload/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Live Reload sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez vos changements Live Reload sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo