Zum Hauptinhalt springen
@capgo/capacitor-netzwerkdiagnose Entwicklerwerkzeuge Offene Quelle

Netzwerkdiagnose Capacitor-Plugin

Führen Sie native Netzwerkdiagnosen für die Erreichbarkeit von URLs, TCP-Ports, WebSocket-Handshaken, Geschwindigkeit und Paketverlust durch.

Installieren

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

Richtlinie

So verwenden Sie Netzwerkdiagnosen in Capacitor

Auf Gerät testen

Laden Sie die Capgo-App herunter, dann scannen Sie das QR-code.

Netzwerk-Diagnose-Plugin-Vorschau-QR code

Verwendung von @capgo/capacitor-netzwerk-diagnostics

Native Netzwerkdiagnose für Capacitor-Apps, die eine Debugging von eingeschränkten Wi-Fi, Captive Portals, blockierten Ports, WebSocket-Fehlern, langsamen Downloads und Paketverlust benötigen.

Installieren

npm install @capgo/capacitor-network-diagnostics
npx cap sync

Was dieses Plugin enthüllt

  • getNetworkStatus - Lese die native Verbindungstyp und Plattform-Netzwerkflags.
  • testUrl - Überprüfe die HTTP- oder HTTPS-URL-Zugriffbarkeit mit Status code und Latenz.
  • testPort - Eine native TCP-Socket zu einem Host und Port öffnen.
  • testWebSocket - Überprüfe eine ws:// oder wss:// Händedruck.
  • testDownloadSpeed - Die native Herunterladegeschwindigkeit messen.
  • testPacketLoss - Die Anwendungsverluste mit wiederholten Proben schätzen.
  • runDiagnostics - Eine kombinierte Diagnose durchführen und eine Liste von Problemen zurückgeben.

Beispielhafte Verwendung

import { NetworkDiagnostics } from '@capgo/capacitor-network-diagnostics';

const report = await NetworkDiagnostics.runDiagnostics({
  urls: [{ url: 'https://api.example.com/health' }],
  ports: [{ host: 'api.example.com', port: 443 }],
  websockets: [{ url: 'wss://ws.example.com/socket' }],
  packetLoss: {
    mode: 'tcp',
    host: 'api.example.com',
    port: 443,
    count: 10,
  },
});

console.log(report.status);
console.log(report.issues);

Werkfluss zum Support

Bitten Sie den betroffenen Benutzer auf, Diagnosen durchzuführen, während er mit dem problematischen Wi-Fi oder Zugangspunkt verbunden ist. Senden Sie die Ergebnisse an den Support mit:

  • Verbindungstyp und Betriebssystem-Netzwerkflags
  • fehlgeschlagene URLs, Ports oder WebSocket-Endpunkte
  • Herunterladegeschwindigkeit in Mbps
  • Verlustprozentsatz der Pakete
  • nativische Fehlercodes und -meldungen

Die Roh-ICMP-Ping ist auf iOS- und Android-Anwendungen nicht portable, daher wird der Paketverlust mit wiederholten TCP- oder HTTP-Proben gemessen.

Vollständige Referenz

FAQ

FAQ für das Netzwerk-Diagnose-Plugin

Wie installiere ich die Netzwerkdiagnose-Plugin in einer Capacitor-App?

Führen Sie "bun add @capgo/capacitor-netzwerkdiagnose" (oder "npm install @capgo/capacitor-netzwerkdiagnose"), dann führen Sie "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code-Datei aufnehmen. Importieren Sie sie aus "@capgo/capacitor-netzwerkdiagnose" in Ihrer code-Anwendung.

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

Ja. Das Netzwerk-Diagnose-Plugin ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

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

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie die Plugin-Version, die Ihrem Capacitor-Majorversion entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README enthält die unterstützten Versionen.

Ist @capgo/capacitor-netzwerkdiagnose kostenlos und Open-Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-netzwerkdiagnose/ verfügbar und das Paket kann kostenlos installiert werden von npm. Bugberichte und Pull-Requests sind willkommen.

Kann ich code aktualisieren, das Network Diagnostics verwendet, ohne eine App-Store-Bewertung?

code oder eine Aktualisierung des Plugins ändert die native code, daher benötigt es eine neue Build im Store. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Netzwerkdiagnose-Änderungen ohne Wartezeit für die App-Überprüfung schicken

Einmal der Plugin in Ihrem Store-Build ist, Capgo Live-Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Mit Capgo beginnen