Saltare al contenuto principale
@capgo/capacitor-diagnostica-di-rete Strumenti per sviluppatori Sorgente aperta

Diagnostica di rete Plugin Capacitor

Esegui diagnosi di rete native per raggiungibilità dell'URL, porte TCP, mani mano WebSocket, velocità e perdita di pacchetti.

Installa

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

Guida

Come utilizzare le Diagnosi di Rete in Capacitor

Utilizzo di @capgo/capacitor-network-diagnostics

Diagnosi di rete native per le app Capacitor che devono debuggere Wi-Fi limitati, porte captive, porte bloccate, fallimenti WebSocket, download lenti e perdita di pacchetti.

Installa

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

Cosa questo plugin esporre

  • getNetworkStatus - Leggi il tipo di connessione nativa e le flag di rete della piattaforma.
  • testUrl - Controlla la raggiungibilità dell'URL HTTP o HTTPS con lo stato code e la latenza.
  • testPort - Apri una connessione TCP nativa a un host e una porta.
  • testWebSocket - Valuta un ws:// - o wss:// handshake.
  • testDownloadSpeed - Misura il throughput di download nativo.
  • testPacketLoss Stima la perdita di pacchetti a livello di applicazione con prove ripetute.
  • runDiagnostics - Esegui un passaggio diagnostico combinato e restituisci una lista di problemi.

- Esempio di utilizzo

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);

- Flusso di lavoro di supporto

- Chiedi all'utente interessato di eseguire le diagnostica mentre è connesso alla rete Wi-Fi problematica o all'access point. Inviare i risultati al supporto con:

  • tipologia di connessione e flag di rete OS
  • URLs, porte o endpoint WebSocket non riusciti
  • download Mbps
  • percentuale di perdita di pacchetti
  • codici e messaggi di errore nativi

La ping ICMP crudo non è portabile su app iOS e Android, quindi la perdita di pacchetti viene misurata con probe TCP o HTTP ripetuti.

Riferimento completo

FAQ

Domande frequenti sul plugin Network Diagnostics

Come posso installare il plugin Network Diagnostics in un'app Capacitor?

Esegui "bun add @capgo/capacitor-network-diagnostics" (o "npm install @capgo/capacitor-network-diagnostics"), quindi esegui "bunx cap sync" per far riconoscere ai progetti iOS e Android il nativo code. Importalo da "@capgo/capacitor-network-diagnostics" nella tua app code.

Funziona @capgo/capacitor-network-diagnostics con React, Vue e Angular?

Sì. Network Diagnostics è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-network-diagnostics?

Capgo plugin seguenti Capacitor versione maggiore: utilizza la versione maggiore del plugin che corrisponde alla tua Capacitor versione maggiore (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nella GitHub README elenca le versioni mantenute.

È @capgo/capacitor-network-diagnostics gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub in https://github.com/Cap-go/capacitor-network-diagnostics/ e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono graditi.

Posso aggiornare code che utilizza Network Diagnostics senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con Capgo aggiornamenti live.

Invia modifiche alle diagnosi di rete senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, le Capgo aggiornamenti in tempo reale inviano le modifiche JavaScript, HTML e CSS ai tuoi utenti in pochi minuti.

Inizia con Capgo