Pasar al contenido principal
@capgo/capacitor-diagnósticos-de-red Herramientas de desarrollador Fuente abierta

Diagnósticos de red plugin de Capacitor

Ejecuta diagnósticos de red nativos para la accesibilidad de URL, puertos TCP, handshakes de WebSocket, velocidad y pérdida de paquetes

Instalar

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

Guía

Cómo utilizar Diagnósticos de Red en Capacitor

Usando @capgo/capacitor-diagnósticos de red

Diagnostics de red nativos para aplicaciones Capacitor que necesitan depurar Wi-Fi restringido, puertas de enlace captivas, puertos bloqueados, fallas de WebSocket, descargas lentas y pérdida de paquetes.

Instalar

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

¿Qué expone este plugin?

  • getNetworkStatus - Leer el tipo de conexión nativa y las banderas de red de plataforma.
  • testUrl - Comprobar la accesibilidad de una URL HTTP o HTTPS con estado code y latencia.
  • testPort - Abrir un socket TCP nativo a un host y puerto.
  • testWebSocket - Validar ws:// una wss:// mano
  • testDownloadSpeed - Medir el rendimiento de descarga nativa.
  • testPacketLoss Estimar pérdidas de paquetes a nivel de aplicación con sondas repetidas.
  • runDiagnostics - Ejecutar un paso de diagnóstico combinado y devolver una lista de problemas.

Ejemplo de uso

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

Flujo de trabajo de soporte

Pida al usuario afectado que ejecute diagnósticos mientras está conectado a la Wi-Fi o punto de acceso problemático. Envíe los resultados a soporte con:

  • connection type and OS network flags
  • URLs, puertos o puntos finales de WebSocket fallidos
  • velocidad de descarga en Mbps
  • porcentaje de pérdida de paquetes
  • códigos y mensajes de error nativos

El ping ICMP bruto no es portable en aplicaciones de iOS y Android, por lo que la pérdida de paquetes se mide con probar TCP o HTTP repetidos.

Referencia completa

FAQ

FAQ sobre el plugin de diagnósticos de red

How se instala el plugin de Diagnósticos de Red en una aplicación Capacitor?

Corre "bun add @capgo/capacitor-network-diagnostics" (o "npm install @capgo/capacitor-network-diagnostics"), luego corre "bunx cap sync" para que los proyectos iOS y Android capturen el nativo code. Importarlo desde "@capgo/capacitor-network-diagnostics" en la aplicación code.

¿Funciona @capgo/capacitor-network-diagnostics con React, Vue y Angular?

Sí. Diagnósticos de Red es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-network-diagnostics?

Los plugins de Capgo siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-network-diagnostics gratuito y de código abierto?

Sí. El código fuente de code está público en GitHub en https://github.com/Cap-go/capacitor-network-diagnostics/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Diagnósticos de Red sin una revisión de la Tienda de Aplicaciones?

Instalar o actualizar el plugin cambia el nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Envíe cambios de diagnósticos de red sin esperar la revisión de la aplicación

Una vez que el plugin está en su edición de tienda, Capgo actualizaciones en vivo empujan sus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Inicie con Capgo