Android 11及以上版本中WifiManager.startScan()废弃方法的替代方案？

问题背景 #

官方推荐的registerScanResultsCallback API仅负责监听扫描结果，本身不会主动发起WiFi扫描。目前没有完全替代startScan()的主动扫描API，即使startScan()已被标记为废弃，仍需调用它来触发扫描动作。

解决步骤 #

1. 确认权限与系统设置

   • 确保已声明并动态获取以下权限：
     • Android 13+：NEARBY_WIFI_DEVICES
     • 全版本：ACCESS_FINE_LOCATION、ACCESS_WIFI_STATE
   • 必须开启设备的位置服务，否则扫描会被系统拦截

2. 正确的实现流程
   先注册扫描回调，再调用startScan()触发扫描，回调会在扫描完成后收到结果：

// 获取WifiManager实例
val wifiManager = applicationContext.getSystemService(WifiManager::class.java)

// 注册扫描结果回调
wifiManager.registerScanResultsCallback(mainExecutor, object : WifiManager.ScanResultsCallback {
    override fun onScanResultsAvailable() {
        // 获取并处理扫描结果
        val scanResults = wifiManager.scanResults
        scanResults.forEach { result ->
            Log.d("WiFiScan", "SSID: ${result.SSID}, 信号强度: ${result.level}")
        }
    }
})

// 主动发起扫描（虽标记废弃但仍需调用）
val scanInitiated = wifiManager.startScan()
if (!scanInitiated) {
    Log.e("WiFiScan", "扫描发起失败，检查权限或系统扫描频率限制")
}

3. 关键注意事项
   • 扫描频率限制：Android 8.0+ 对后台应用的扫描频率严格限制（10分钟内最多4次），前台应用限制较宽松，但仍需避免频繁调用startScan()
   • 废弃API兼容性：startScan()的废弃标记仅为隐私合规提示，目前各版本Android仍支持该功能，无需担心立即失效
   • 后台扫描优化：若需后台定期扫描，建议使用WorkManager或JobScheduler，遵守系统调度规则，避免被限流

内容的提问来源于stack exchange，提问作者Cosmin Telescu