가이드
Capacitor에서 Network Diagnostics 사용법
@capgo/capacitor-network-diagnostics 사용
제한된 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 앱에서 원시 ICMP ping은 이식성이 없으므로, 반복적인 TCP 또는 HTTP 프로브를 사용하여 패킷 손실을 측정합니다.
전체 레퍼런스
- GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
- 문서: /docs/plugins/network-diagnostics/