Zum Hauptinhalt springen
@capgo/capacitor-live-reload Updates Open Source

Live Reload Capacitor Plugin

Verbinde dich mit deinem Dev-Server für instant Hot Reloading während der Entwicklung

Installieren

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

Anleitung

Live Reload in Capacitor nutzen

Verwendung von @capgo/capacitor-live-reload

Capacitor Plugin für Live Reload von Capacitor Apps via Remote Vite Dev Server.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
configureServer Speichert die Remote-Dev-Server-Einstellungen für nachfolgende Verbindungen.
connect Stellt eine WebSocket-Verbindung her, falls noch keine aktiv ist.
disconnect Schließt die aktuelle WebSocket-Verbindung und deaktiviert den Auto-Reconnect.
getStatus Gibt den aktuellen Verbindungsstatus zurück.
reload Löst einen vollständigen Reload der Capacitor WebView aus.
reloadFile Reloadet eine einzelne Datei/ein Modul, sofern die Runtime dies unterstützt (Fallback: Full Reload).

Beispiele

configureServer()

Speichert die Remote-Dev-Server-Einstellungen für nachfolgende Verbindungen.

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

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

connect()

Stellt eine WebSocket-Verbindung her, falls noch keine aktiv ist.

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

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

disconnect()

Schließt die aktuelle WebSocket-Verbindung und deaktiviert den Auto-Reconnect.

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

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

getStatus()

Gibt den aktuellen Verbindungsstatus zurück.

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

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

reload()

Löst einen vollständigen Reload der Capacitor WebView aus.

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

await LiveReload.reload();

reloadFile()

Reloadet eine einzelne Datei/ein Modul, falls die Runtime dies unterstützt (Fallback: Full Reload).

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

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

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder LiveReload.removeAllListeners() auf, um alle Listener zu entfernen.

Vollständige Referenz

Weiter mit der Nutzung von @capgo/capacitor-live-reload

Wenn du es nutzt Nutzung von @capgo/capacitor-live-reload Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-live-reload für die Implementierungsdetails in @capgo/capacitor-live-reload, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

Live Reload Plugin FAQ

Wie installiere ich das Live Reload Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-live-reload" (oder "npm install @capgo/capacitor-live-reload") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-live-reload".

Funktioniert @capgo/capacitor-live-reload mit React, Vue und Angular?

Ja. Live Reload ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-live-reload?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-live-reload kostenlos und Open Source?

Ja. Der code Source Code ist auf GitHub unter https://github.com/Cap-go/capacitor-live-reload/ öffentlich einsehbar und das Package lässt sich kostenlos über npm installieren. Bug Reports und Pull Requests sind willkommen.

Kann ich code mit Live Reload aktualisieren, ohne auf eine App Store Review zu warten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Live Reload Änderungen ohne App-Review ausrollen

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo