Android10+(API29+) Flutter如何后台程序化连接指定WiFi
后台静默连接指定WiFi的实现方案
现有实现的失效根因
当前代码使用的WifiNetworkSpecifier是Android 10为临时WiFi连接场景设计的专用API,系统层面存在不可绕过的硬限制:
- 所有通过该API发起的连接请求,必须在应用处于前台、屏幕点亮可交互的状态下才会被系统受理,请求触发后系统会弹出用户确认连接的弹窗
- 一旦应用退到后台、屏幕熄屏,系统会直接判定请求无效,不会执行WiFi扫描、匹配动作,立刻触发
onUnavailable回调 - 该API的设计初衷就不支持静默后台连接,无论做多少保活优化,都无法绕开前台状态校验的规则
合规可落地的实现路径
全版本适配的官方方案:改用NetworkSuggestion托管WiFi配置
NetworkSuggestion是Android 12正式稳定开放的官方接口,专门用于让应用向系统推荐可自动连接的WiFi网络,无任何前台状态限制,完全匹配目标WiFi频繁断连、需要无交互自动重连的业务场景:
- 核心实现逻辑:
- 构建
WifiNetworkSuggestion对象,传入目标WiFi的SSID、BSSID、加密类型和连接密码,原代码中WPA2/WPA3加密类型的判断逻辑可以完全复用 - 若目标WiFi无公网访问能力(对应原代码中移除
NET_CAPABILITY_INTERNET的逻辑),直接调用setNoInternetRequired()标记该网络为无网网络即可 - 调用
WifiManager.addNetworkSuggestions()将构建好的WiFi配置提交给系统托管
- 构建
- 系统接管后的特性:
- 无任何前台交互要求,在应用退到后台、屏幕完全熄屏的状态下,只要检测到目标WiFi信号存在,就会自动完成连接
- 当目标WiFi频繁断连、信号消失再恢复时,系统会自动重新发起连接,完全不需要应用手动触发请求
- 权限门槛低:仅需要申请
ACCESS_FINE_LOCATION、CHANGE_WIFI_STATE权限即可,Android 13及以上版本额外申请NEARBY_WIFI_DEVICES,无需特殊系统权限
特殊场景权限路径
如果应用属于企业设备管理类应用、系统定制应用,可以申请android.permission.NETWORK_SETTINGS系统级权限,直接调用旧版WifiManager.addNetwork()接口添加WiFi配置,连接效果和系统托管方案一致,但这类权限普通消费级应用无法获取,不具备通用性
配套状态感知优化
系统托管连接后,为了让应用能实时感知WiFi连接状态、触发对应业务逻辑,需要适配:
- 开启类型为
connectedDevice的前台服务,适配Android 14及以上版本的前台服务类型强制要求 - 在前台服务中注册全局网络监听回调,实时获取目标WiFi的连接状态,不需要手动发起重连请求,只需要在状态变化时触发对应业务逻辑即可
避坑提醒
- 不要尝试修改
WifiNetworkSpecifier的回调逻辑、或者通过强保活让应用常驻前台来绕过系统的前台校验,这类方式在Android高版本上的拦截强度会持续提升,合规性没有保障 - 切换到
NetworkSuggestion方案后,不要沿用之前removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)的写法,该逻辑是临时网络请求的配置项,对系统托管的WiFi配置不生效 - 不需要在托管连接后手动调用
connectivityManager.bindProcessToNetwork()绑定进程网络,系统会自动按照全局网络路由规则分配网络,若需要强制将业务流量走该WiFi,可单独配合网络绑定逻辑处理
注意:提交的
NetworkSuggestion配置会出现在系统WiFi设置的可用列表中,用户可手动删除该配置,符合系统隐私规范
内容的提问来源于stack exchange,提问作者Honza Kuchař
相关产品推荐
相关产品推荐

