네트워크 진단

@capgo/capacitor-네트워크 진단 플러그인 사용

RESTRICTED Wi-Fi, 캡티브 게이트웨이, 차단된 포트, WebSocket 실패, 다운로드 속도 저하 및 패킷 손실과 같은 제한된 Wi-Fi, 캡티브 게이트웨이, 차단된 포트, WebSocket 실패, 다운로드 속도 저하 및 패킷 손실과 같은 네이티브 네트워크 진단을 위한 Capacitor 앱에 대한 네이티브 네트워크 진단

설치

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

이 플러그인이 제공하는 내용

• getNetworkStatus - 네이티브 연결 유형과 플랫폼 네트워크 플래그를 읽습니다.
• testUrl - HTTP 또는 HTTPS URL에 대한 상태 code 및 지연 시간을 확인합니다.
• testPort - 호스트와 포트에 대한 네이티브 TCP 소켓을 열어줍니다.
• testWebSocket 또는 ws:// 수신 wss:// - 네이티브 다운로드 속도 측정
• testDownloadSpeed - 네이티브 다운로드 속도 측정
• testPacketLoss - 애플리케이션 수준 패킷 손실을 반복적인 프로브를 통해 추정합니다.
• runDiagnostics - 결함 목록을 반환하는 데 사용되는 결합된 진단 패스를 실행합니다.

예시 사용

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

지원 워크플로우

영향을 받은 사용자에게 문제가 있는 Wi-Fi 또는 접속점에 연결된 상태에서 진단을 실행하도록 요청합니다. 지원에 결과를 보내야 하는 항목은 다음과 같습니다:

• 연결 유형 및 OS 네트워크 플래그
• 실패한 URL, 포트 또는 WebSocket 엔드포인트
• 다운로드 Mbps
• 패킷 손실 퍼센트
• 네이티브 오류 코드 및 메시지

iOS 및 Android 앱에서 Raw ICMP ping은 이동성이 없으므로 패킷 손실은 반복적인 TCP 또는 HTTP 프로브를 통해 측정됩니다.

전체 참조

• GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
• Docs: /docs/plugins/network-diagnostics/