Android设备无用户交互自动连接WiFi的实现方法问询

问题背景 #

我需开发一款非公开、不上架Google Play商店的Android应用，实现无用户交互自动连接WiFi（注：该操作存在安全风险，故应用仅作特定用途）。当前使用ConnectivityManager的代码可正常运行，但会弹出用户确认连接的提示框，而应用场景中常无用户在场，因此需解决此问题，询问是否存在无需Root设备的实现方案，例如能否设置为仅首次提示，后续自动连接？

当前代码如下：

TextView textFeedback = findViewById(R.id.text);

ConnectivityManager.NetworkCallback wifiConnectionCallback = new ConnectivityManager.NetworkCallback(){
    @Override
    public void onAvailable(@NonNull Network network) {
        super.onAvailable(network);
        Log.e(logTAG, "wifi connected");
        textFeedback.setText("wifi connected");
    }

    @Override
    public void onLosing(@NonNull Network network, int maxMsToLive) {
        super.onLosing(network, maxMsToLive);
        Log.e(logTAG, "losing wifi connection");
        textFeedback.setText("losing wifi connection");
    }

    @Override
    public void onLost(@NonNull Network network) {
        super.onLost(network);
        Log.e(logTAG, "lost wifi connection");
        textFeedback.setText("lost wifi connection");
    }

    @Override
    public void onUnavailable() {
        super.onUnavailable();
        Log.e(logTAG, "user closed wifi connection");
        textFeedback.setText("user closed wifi connection");
    }
};

// instantiate connectivity manager
ConnectivityManager connectivityManager = (ConnectivityManager) this.getApplicationContext().getSystemService(this.CONNECTIVITY_SERVICE);

// connect to phl via wifi
Thread wifiConnectionThread = new Thread(new Runnable()
{
    @Override
    public void run()
    {
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q)
        {
            NetworkSpecifier networkSpecifier  = new WifiNetworkSpecifier.Builder()
                        .setSsid(ssid)
                        .build();
            NetworkRequest networkRequest  = new NetworkRequest.Builder()
                        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
                        .setNetworkSpecifier(networkSpecifier)
                        .build();
            connectivityManager.requestNetwork(networkRequest, wifiConnectionCallback);
        }
    }
});
wifiConnectionThread.start();

无Root实现方案 #

1. 利用系统已保存的WiFi配置 #

如果目标WiFi已被用户手动连接并保存到系统中，可直接调用WifiManager的enableNetwork方法实现自动连接，无需再次弹出确认框：

WifiManager wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
List<WifiConfiguration> configuredNetworks = wifiManager.getConfiguredNetworks();

for (WifiConfiguration config : configuredNetworks) {
    // 注意系统保存的SSID带双引号，需匹配格式
    if (config.SSID.equals("\"" + ssid + "\"")) {
        wifiManager.enableNetwork(config.networkId, true);
        wifiManager.reconnect();
        break;
    }
}

2. Android 10以下：直接添加并保存WiFi配置 #

在Android 10（API 29）及更早版本，应用可通过WifiManager.addNetwork直接添加WiFi配置并保存到系统，全程无需用户确认（需申请对应权限）：

WifiConfiguration config = new WifiConfiguration();
config.SSID = "\"" + ssid + "\"";
config.preSharedKey = "\"" + password + "\""; // 适配WPA/WPA2加密

WifiManager wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
int networkId = wifiManager.addNetwork(config);
if (networkId != -1) {
    wifiManager.enableNetwork(networkId, true);
    wifiManager.saveConfiguration(); // 将配置持久化到系统
}

3. Android 10+：使用WifiNetworkSuggestion实现首次确认后自动连接 #

Android 10及以上版本，Google限制了应用直接添加WiFi配置的权限，但可通过WifiNetworkSuggestion向系统推荐网络，首次需要用户确认，确认后系统会保存配置，后续即可自动连接：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    List<WifiNetworkSuggestion> suggestions = new ArrayList<>();
    WifiNetworkSuggestion suggestion = new WifiNetworkSuggestion.Builder()
            .setSsid(ssid)
            .setWpa2Passphrase(password)
            .build();
    suggestions.add(suggestion);

    WifiManager wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
    int status = wifiManager.addNetworkSuggestions(suggestions);
    
    if (status == WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
        // 首次触发系统提示让用户确认，确认后配置被系统保存
        // 后续调用requestNetwork或enableNetwork时无需再次提示
    }
}

必备权限 #

所有方案都需要在AndroidManifest.xml中添加以下权限：

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- Android 10+扫描WiFi需位置权限 -->

总结 #

• Android 10及以下：可实现完全无交互自动连接，无需用户确认。
• Android 10+：无Root情况下无法跳过首次用户确认，但确认后系统会保存配置，后续可自动连接目标WiFi。

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