跳转到正文

Android 配置

GitHub

插件会自动声明所需的 Android 权限:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  • 连接状态使用 ConnectivityManager 以及 NetworkCapabilities.
  • URL 和下载测试使用原生 HttpURLConnection.
  • TCP 端口测试使用原生 socket。
  • WebSocket 测试通过 TCP 或 TLS 执行原生 WebSocket upgrade 握手。

强制门户与已验证网络

“Captive portal 与互联网验证”章节

Android 可以显示当前网络是否已通过互联网验证,或被标记为支持 captive portal。这些标志位有助于解释设备已连接 Wi-Fi 但应用无法访问后端的情况。

优先使用 https:// 以及 wss:// 目标。如果你需要诊断明文 http:// 或 ws:// endpoint(Android 9 或更高版本)时,宿主应用可能需要 Network Security Config 或 android:usesCleartextTraffic="true" 用于该诊断目标。