Allez directement au contenu principal
@capgo/capacitor-diagnostics-de-réseau Outils de développement Source

Diagnostics de réseau plugin Capacitor

Exécutez des diagnostics réseau natifs pour la disponibilité d'URL, les ports TCP, les échanges de WebSocket, la vitesse et les pertes de paquets.

Installer

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

Guide

Comment utiliser les diagnostics de réseau dans Capacitor

Utilisation de @capgo/capacitor-network-diagnostics

Diagnostic réseau natif pour les applications Capacitor qui nécessitent la débogage de Wi-Fi restreint, de portails captifs, de ports bloqués, d'échecs de WebSocket, de téléchargements lents et de pertes de paquets.

Installer

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

Ce que ce plugin expose

  • getNetworkStatus - Lit le type de connexion natif et les drapeaux de réseau de la plateforme.
  • testUrl Vérifiez la disponibilité d'une URL HTTP ou HTTPS avec le statut code et la latence.
  • testPort - Ouvrez un socket TCP natif vers un hôte et un port.
  • testWebSocket - Validez un ws:// - ou wss:// handshake.
  • testDownloadSpeed - Effectuez un échange de main.
  • testPacketLoss - Estime la perte de paquets au niveau de l'application avec des sondages répétés.
  • runDiagnostics - Estimez la perte de paquets au niveau de l'application avec des sondages répétés.

Exemple d'utilisation

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

- Exemple d'utilisation

Demandez à l'utilisateur affecté d'exécuter des diagnostics tout en étant connecté au Wi-Fi ou au point d'accès problématique. Envoyez les résultats au support avec :

  • connection type and OS network flags
  • URLs, ports ou points de terminaison WebSocket échoués
  • téléchargement Mbps
  • taux de perte de paquets
  • codes et messages d'erreur natifs

Le ping ICMP brut n'est pas portable sur les applications iOS et Android, donc la perte de paquets est mesurée avec des sondes TCP ou HTTP répétées.

Référence complète

FAQ

FAQ du plugin Network Diagnostics

Comment installer le plugin Network Diagnostics dans une application Capacitor ?

Exécutez la commande « bun add @capgo/capacitor-network-diagnostics » (ou « npm install @capgo/capacitor-network-diagnostics »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-network-diagnostics » dans votre application code.

Le plugin @capgo/capacitor-network-diagnostics fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin Network Diagnostics est un package Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-network-diagnostics ?

Les Capgo plugins 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). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-network-diagnostics est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-network-diagnostics/ et le package est gratuit pour l'installer depuis npm. Les rapports de bugs et les demandes de pull sont les bienvenus.

Peut-on mettre à jour code qui utilise les diagnostics de réseau sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin change le code natif, il faut donc une nouvelle build de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Envoyez les modifications des diagnostics de réseau sans attendre l'examen de l'application

Une fois le plugin est dans votre build de magasin, Capgo les mises à jour en direct poussent vos modifications JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Commencez avec Capgo