是否可以在 Android Q 上添加网络配置？

Question

背景

我注意到在WifiManager 类中有一个名为addNetwork 的函数，如果我想恢复或保存网络信息（网络名称AKA SSID，以及密码和类型），它可能很有用，这样我也可以连接到它。

问题

我找不到太多关于如何做这样的事情的信息。我在 StackOverflow 上看到过各种示例，如果我以 Android API 28（或更低版本）为目标，我确实成功地使它添加了网络，甚至连接到它。

但是，当面向 Android 29 (Android Q) 时，它无法添加网络。

我发现了什么

由于我正在使用 Android Q beta 4 尝试 Pixel 2，我认为这可能是因为 addNetwork 已被弃用，所以文档甚至这么说，如果我以 Android Q 为目标，它将无法工作，实际上它不起作用：

兼容性说明：适用于面向 Build.VERSION_CODES.Q 的应用程序 或以上，此 API 将始终返回 -1。

在Android Q（不包括）之前它似乎应该工作的方式是准备WifiConfiguration并添加它。以后如果我愿意，我也可以连接到它。在 Android Q 上，它似乎被WifiNetworkSuggestion 取代，但似乎根本不是要添加网络：

Network Suggestion 对象用于为以下用户提供 Wi-Fi 网络 自动连接到网络时的考虑。应用程序不能直接 创建这个对象，他们必须使用 WifiNetworkSuggestion.Builder#build() 获取此实例 对象。

应用可以使用以下方式向平台提供此类网络的列表 WifiManager#addNetworkSuggestions(List)。

这是我当前的代码，适用于 pre-Android-Q

@WorkerThread
fun addNetwork(context: Context, networkName: String, networkPassword: String? = null, keyMgmt: Int = WifiConfiguration.KeyMgmt.NONE) {
    val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager
    val conf = WifiConfiguration()
    conf.SSID = "\"$networkName\""
    conf.preSharedKey = if (networkPassword.isNullOrEmpty()) "" else "\"$networkPassword\""
    conf.allowedKeyManagement.set(keyMgmt)
    when (keyMgmt) {
        WifiConfiguration.KeyMgmt.WPA_PSK -> {
            //WPA/WPA2
        }
        WifiConfiguration.KeyMgmt.IEEE8021X -> {
        }
        WifiConfiguration.KeyMgmt.WPA_EAP -> {
        }
        WifiConfiguration.KeyMgmt.NONE -> {
            if (networkPassword.isNullOrEmpty()) {
                //open network
                conf.wepKeys[0] = "\"\""
            } else {
                //wep
                conf.wepKeys[0] = "\"" + networkPassword + "\""
                conf.wepTxKeyIndex = 0
                conf.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.WEP40)
            }
        }
    }
    if (networkPassword.isNullOrEmpty()) {
        //open network
        conf.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.NONE)
    } else {
    }
    wifiManager.isWifiEnabled = true
    while (!wifiManager.pingSupplicant()) {
        Log.d("AppLog", "waiting to be able to add network")
    }
    val networkId = wifiManager.addNetwork(conf)
    if (networkId == -1)
        Log.d("AppLog", "failed to add network")
    else {
        wifiManager.enableNetwork(networkId, false)
        Log.d("AppLog", "success to add network")
    }
}

似乎只需要这些权限：

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>

但无论如何，只要您不以 Android Q (API 29) 及更高版本为目标，这将有效。当你瞄准它时，我确实总是得到“-1”，这意味着它失败了。

我还在问题跟踪器上发现了一个问题（here，我写了关于它here），告诉有人需要返回 API，但我不确定它是否与添加网络有关。

查看WifiNetworkSuggestion，我没有看到它可以通过其构建器设置与WifiConfiguration 一样多的东西，所以这是我怀疑它与添加网络无关的另一个原因。

但我还是试过了。这是我尝试过的代码，例如，添加一个普通的 WPA 网络：

@WorkerThread
fun addNetworkAndroidQ(context: Context, networkName: String, networkPassword: String? = null) {
    val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager
    val list = ArrayList<WifiNetworkSuggestion>()
    val builder = WifiNetworkSuggestion.Builder().setSsid(networkName)
    if (!networkPassword.isNullOrEmpty())
        builder.setWpa2Passphrase(networkPassword)
    list.add(builder.build())
    val result = wifiManager.addNetworkSuggestions(list)
    if (result == WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS)
        Log.d("AppLog", "success")
    else Log.d("AppLog", "failed")
}

运行时（在让操作系统忘记它之后，我给了它我的 Wifi 网络详细信息），它说它成功了，但操作系统的 Wifi 设置上没有发生任何事情。使用我添加的密码的网络不存在。所以我真的不明白它做了什么......

几秒钟后，我注意到一条通知，询问我是否可以连接到应用创建的建议网络：

但是当我选择接受时，它什么也没做，和以前一样。

我尝试制作另一个 POC，以为我可能做错了，但后来它甚至没有显示通知。由于我认为这整个行为是一个错误，我已经报告了它here。

不仅如此，我还发现，如果它确实应该以某种方式添加网络，它仍然有一些严重的限制，例如最大添加网络 (here) 并在卸载时被删除应用程序 (here)

问题

1. 究竟应该如何处理Android Q？真的没有API来添加网络了吗？

2. 如果WifiNetworkSuggestion 不是关于添加网络，那么它到底是用来做什么的？

3. 由于我对添加网络的花絮不够熟悉，我的代码对于添加网络的所有可能方式是否正确？我问这个是因为有人写了here 说人们应该启用 Wifi 并确保pingSupplicant 返回 true。这是真的吗？还是打电话给addNetwork就够了？

4. 如果现在无法使用普通 API 添加网络，是否可以使用根设备代替解决方案？也许是一些 adb 命令？

---

编辑：不确定如何正式执行，但使用 adb，您 might be able 在 Android 11 上添加 Wifi-networks 。需要检查adb shell cmd wifi help。

Answer 1

我希望我能回答你所有的问题，因为我目前正在努力解决类似的问题。

经过几个小时后，我终于能够使用这种方法连接到所需的网络：

val wifiNetworkSpecifier = WifiNetworkSpecifier.Builder()
    .setSsid(ssid)
    .setWpa2Passphrase(passphrase)
    .setBssid(mac)
    .build()

val networkRequest = NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
    .setNetworkSpecifier(wifiNetworkSpecifier)
    .build()

val connectivityManager = applicationContext.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager?

connectivityManager?.requestNetwork(networkRequest, ConnectivityManager.NetworkCallback())

您可以通过ConnectivityManager.NetworkCallback() 接收大量活动。

Answer 2

我遇到了同样的问题，但不知何故我达到了连接所需网络的可重现状态，我想分享我的发现，这可能会有所帮助。

总结一下： 在应用WifiNetworkSuggestion 逻辑之前，您必须禁用所有自动连接

更多详情，请阅读以下内容：

我使用了以下代码（与您使用的类似）：

private fun connectUsingNetworkSuggestion(ssid: String, password: String) {
    val wifiNetworkSuggestion = WifiNetworkSuggestion.Builder()
        .setSsid(ssid)
        .setWpa2Passphrase(password)
        .build()

    // Optional (Wait for post connection broadcast to one of your suggestions)
    val intentFilter =
        IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION);

    val broadcastReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if (!intent.action.equals(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) {
                return
            }
            showToast("Connection Suggestion Succeeded")
            // do post connect processing here
        }
    }
    registerReceiver(broadcastReceiver, intentFilter)

    lastSuggestedNetwork?.let {
        val status = wifiManager.removeNetworkSuggestions(listOf(it))
        Log.i("WifiNetworkSuggestion", "Removing Network suggestions status is $status")
    }
    val suggestionsList = listOf(wifiNetworkSuggestion)
    var status = wifiManager.addNetworkSuggestions(suggestionsList)
    Log.i("WifiNetworkSuggestion", "Adding Network suggestions status is $status")
    if (status == WifiManager.STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_DUPLICATE) {
        showToast("Suggestion Update Needed")
        status = wifiManager.removeNetworkSuggestions(suggestionsList)
        Log.i("WifiNetworkSuggestion", "Removing Network suggestions status is $status")
        status = wifiManager.addNetworkSuggestions(suggestionsList)
    }
    if (status == WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
        lastSuggestedNetwork = wifiNetworkSuggestion
        lastSuggestedNetworkSSID = ssid
        showToast("Suggestion Added")
    }
}

以下是步骤：

1. 安装新版本/或删除您之前添加的所有建议
2. 确保您忘记了所有周围的网络，以免您的设备自动连接
3. 添加wifi网络建议列表
4. 转到 Wifi 设置以扫描网络或等待下一次扫描运行
5. 会出现通知提示：

6.当您按下“是”时，系统将通过您的应用程序自动连接它并且互联网将正常工作。请参阅以下内容：

请注意以下几点：

1. 如果您从 Wifi 设置断开网络（即按下下图中的断开连接图标），即使您使用 wifiManager.removeNetworkSuggestions(listOf(it)) 删除了建议的网络并再次添加，您的网络也将被阻止 24 小时自动连接。即使您再次卸载并安装您的应用

不幸的是，这是Android系统添加的限制，如here所述：

如果用户在连接到某个网络建议时使用 Wi-Fi 选择器明确断开与它的连接，则该网络将被列入黑名单 24 小时。在黑名单期间，即使应用移除并重新添加该网络对应的网络建议，也不会考虑自动连接该网络。

1. 如果您在连接到建议的 WiFi 时卸载应用程序，系统将自动关闭连接。
2. 如果您有多个建议，您可以使用WifiNetworkSuggestion.Builder().setPriority(<Priority Integer>) 对它们进行优先排序，如here 所述：

在同一应用提供的其他网络建议中指定此网络的优先级（优先级对不同应用的建议没有影响）。数字越大，优先级越高（即值 0 = 最低优先级）。

4. 如果您在通知提示中按“否”，您可以按照here 的说明从(Settings > Apps & notifications > Special App access > Wi-Fi Control > App name) 更改它：

拒绝网络建议通知的用户会从应用中删除 CHANGE_WIFI_STATE 权限。用户可以稍后通过进入 Wi-Fi 控制菜单（设置 > 应用和通知 > 特殊应用访问 > Wi-Fi 控制 > 应用名称）来授予此批准。

Answer 3

@Sebastian Helzer 的回答对我有用。我在我的应用程序中使用 java。这可能对 java 用户有所帮助...

WifiNetworkSpecifier wifiNetworkSpecifier = new WifiNetworkSpecifier.Builder()
                .setSsid(ssid)
                .setWpa2Passphrase(password)
                .build();
NetworkRequest networkRequest = new NetworkRequest.Builder()
                .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
                .setNetworkSpecifier(wifiNetworkSpecifier)
                .build();
ConnectivityManager connectivityManager = (ConnectivityManager)this.getApplicationContext().getSystemService(Context.CONNECTIVITY_SERVICE);
connectivityManager.requestNetwork(networkRequest, new ConnectivityManager.NetworkCallback());

Answer 4

看起来他们已经在 Android 11(API 30) 中添加了对添加网络配置的支持，该网络配置在应用程序范围之外持续存在并保存为系统网络配置，就像使用已弃用的 WiFiManager 方法 addNetwork 一样。您需要做的就是使用ACTION_WIFI_ADD_NETWORKS 显示一个系统对话框，询问用户是否要继续向系统添加新的 Wifi 建议。这就是我们启动该对话框的方式：

// used imports
import android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
import android.provider.Settings.EXTRA_WIFI_NETWORK_LIST
import android.app.Activity
import android.content.Intent
import android.net.wifi.WifiNetworkSuggestion





// show system dialog for adding new network configuration
    val wifiSuggestionBuilder = WifiNetworkSuggestion.Builder()
                .setSsid("network SSID")
                .build()

    val suggestionsList = arraylistOf(wifiSuggestionBuilder)
    val intent = new Intent(ACTION_WIFI_ADD_NETWORKS)
    intent.putParcelableArrayListExtra(EXTRA_WIFI_NETWORK_LIST, suggestionsList);
    activity.startActivityForResult(intent, 1000)

对话框如下所示：

然后我们只需要像这样在onActivityResult 方法中处理一个结果：

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (requestCode == 1000) {
        if (resultCode == Activity.RESULT_OK) {
            // network succesfully added - User pressed Save
        } else if (resultCode == Activity.RESULT_CANCELED) {
            // failed attempt of adding network to system - User pressed Cancel
        }
    }
}

但是，当我在安装了较旧 Android 版本（低于 API30）的 Android 设备上测试此代码时，每次我希望它显示用于添加新网络配置的对话框时都会崩溃。这是崩溃：

java.lang.RuntimeException: Unable to start activity: android.content.ActivityNotFoundException: No Activity found to handle Intent { act=android.settings.WIFI_ADD_NETWORKS (has extras) }

看起来新方法没有开箱即用的支持。因此，对于 API30，我们可以使用新的 Intent 操作，对于 API 28 及以下版本，我们仍然可以使用添加网络的旧方法，但对于 API29，我们有一些灰色区域，我还没有找到好的解决方案。如果有人知道还能做什么，请与我分享。 ;)