Zum Hauptinhalt springen
@capgo/capacitor-wifi Device-APIs Open Source

WLAN Capacitor Plugin

Verwalte die WiFi-Verbindung deiner Capacitor App

Installieren

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

Anleitung

WiFi in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR code zur WiFi-Plugin-Vorschau

Mit @capgo/capacitor-wifi

WiFi-Plugin zur Verwaltung der WLAN-Verbindung des Geräts.

Installieren

bun add @capgo/capacitor-wifi
bunx cap sync

Was dieses Plugin bereitstellt

  • addNetwork - Zeigt einen Systemdialog an, um ein Wi-Fi-Netzwerk zum Gerät hinzuzufügen. Auf Android SDK 30+ öffnet dies die System-Wi-Fi-Einstellungen mit vorausgefülltem Netzwerk. Auf iOS wird direkt mit dem Netzwerk verbunden.
  • connect - Mit einem WLAN verbinden. Unter Android wird eine temporäre Verbindung erstellt, die den Traffic standardmäßig nicht über das Netzwerk routet. Setze autoRouteTraffic auf true, um den App-Traffic an das verbundene Netzwerk zu binden (nützlich für lokale/vom Gerät gehostete APs). Nutze für eine dauerhafte Verbindung unter Android stattdessen addNetwork(). Unter iOS wird eine dauerhafte Verbindung erstellt.
  • disconnect - Trennt die Verbindung vom aktuellen Wi-Fi-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.
  • getAvailableNetworks - Ruft eine Liste der verfügbaren Wi-Fi-Netzwerke vom letzten Scan ab. Nur auf Android verfügbar.

Anwendungsbeispiel

addNetwork

Zeigt einen Systemdialog an, um dem Gerät ein WLAN-Netzwerk hinzuzufügen. Auf Android SDK 30+ öffnet sich damit die WLAN-Einstellungen mit bereits eingetragenem Netzwerk. Auf iOS wird direkt eine Verbindung zum Netzwerk hergestellt.

import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

connect

Stellt eine Verbindung zu einem WLAN-Netzwerk her. Auf Android wird eine temporäre Verbindung erstellt, die standardmäßig keinen Traffic über das Netzwerk routet. Setze autoRouteTraffic auf true, um den App-Traffic an das verbundene Netzwerk zu binden (nützlich für lokale bzw. vom Gerät gehostete APs). Für eine dauerhafte Verbindung auf Android nutze stattdessen addNetwork(). Auf iOS wird eine dauerhafte Verbindung hergestellt.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.connect({
  ssid: 'MyNetwork',
  password: 'mypassword',
  autoRouteTraffic: true // Android only: route app traffic through this network
});

disconnect

Trennt die Verbindung zum aktuellen WLAN-Netzwerk. Auf iOS werden nur Netzwerke getrennt, die über dieses Plugin hinzugefügt wurden.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.disconnect();

getAvailableNetworks

Ruft eine Liste der verfügbaren WLAN-Netzwerke aus dem letzten Scan ab. Nur auf Android verfügbar.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

Vollständige Referenz

Weiterlesen: Using @capgo/capacitor-wifi

Wenn du es nutzt Mit @capgo/capacitor-wifi um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-wifi für das Implementierungsdetail in @capgo/capacitor-wifi, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

WiFi Plugin FAQ

Wie installiere ich das WiFi Plugin in einer Capacitor-App?

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

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

Ja. WiFi ist ein Capacitor-Paket 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-wifi?

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-wifi kostenlos und Open Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-wifi/ verfügbar, und das Paket lässt sich kostenlos von npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code aktualisieren, das WiFi nutzt, ohne eine App-Store-Prüfung?

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.

WLAN-Änderungen ausliefern, ohne auf das App-Review zu warten

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