如何用ADB命令连接需密码的Wi-Fi？

Question

如何通过ADB命令连接需要密码的Wi-Fi网络？在设备未root的情况下，使用`adb shell cmd wifi connect-network`命令是否支持直接传入SSID和密码？若系统提示“Error: WiFi is turned off”或“Permission denied”，应如何处理？此外，Android 10及以上版本对WiFi配置权限进行了限制，是否影响ADB命令的实际可行性？请结合具体命令格式、权限要求及系统版本兼容性进行分析。

Answer 1

一、ADB连接Wi-Fi的基础命令与语法结构

在Android设备调试过程中，ADB（Android Debug Bridge）是开发者与设备交互的核心工具。通过adb shell cmd wifi子命令，可以实现对Wi-Fi模块的控制。其中，连接指定SSID的Wi-Fi网络的基本命令格式如下：

adb shell cmd wifi connect-network "SSID" pass "PASSWORD"

该命令尝试直接连接一个需要密码的Wi-Fi网络。参数说明：

• SSID：目标Wi-Fi的名称，需用双引号包裹以支持包含空格的名称。
• pass：表示后续参数为WPA/WPA2预共享密钥。
• PASSWORD：实际的Wi-Fi密码。

例如：

adb shell cmd wifi connect-network "MyHomeWiFi" pass "securePass123"

此命令在部分Android系统中可成功触发连接流程，但其执行结果高度依赖于系统版本和权限模型。

二、常见错误分析：“WiFi is turned off” 与 “Permission denied”

在执行上述命令时，常遇到两类典型错误：

错误信息	可能原因	解决方案
Error: WiFi is turned off	Wi-Fi模块未启用	先执行：adb shell svc wifi enable
Permission denied	缺少必要权限或用户非shell组成员	确认ADB调试权限；使用系统签名应用替代

针对“WiFi is turned off”，应确保Wi-Fi已开启：

adb shell svc wifi enable

若仍无效，可通过以下命令检查状态：

adb shell dumpsys wifi | grep "Wi-Fi is enabled"

输出为true表示已启用。对于“Permission denied”，问题根源在于Android运行时权限机制限制了shell用户对Wi-Fi配置API的访问。

三、权限模型演进：从Android 9到Android 13的Wi-Fi配置限制

自Android 9（Pie）起，Google逐步收紧非系统应用对Wi-Fi配置的控制能力。关键变化包括：

1. 移除android.permission.CHANGE_WIFI_STATE对第三方应用的授权效果。
2. 引入Device Owner模式作为唯一合法途径来远程配置Wi-Fi。
3. Android 10+ 禁止通过ADB直接调用connect-network修改已保存网络。

这意味着即使拥有ADB shell权限，普通用户也无法绕过权限沙盒进行Wi-Fi连接操作。具体表现为：

Error: Connect network not allowed for uid 2000

UID 2000对应shell用户，表明其不在允许列表中。只有具备android.uid.system或被设为设备管理者的应用才能调用该接口。

四、系统版本兼容性分析与可行性评估

不同Android版本对ADB Wi-Fi命令的支持情况存在显著差异：

Android版本	支持connect-network?	是否需Device Owner	备注
7.0 - 8.1	✅ 有限支持	❌ 否	需root或系统签名
9.0	⚠️ 部分支持	✅ 推荐	权限策略开始收紧
10.0 - 11.0	❌ 不支持	✅ 必须	仅Device Owner可用
12.0+	❌ 完全禁用	✅ 强制	API标记为隐藏

由此可见，Android 10及以上版本已实质性封锁了ADB直接连接Wi-Fi的能力，除非设备处于企业级管理模式。

五、替代方案与高级调试技巧

当标准命令失效时，可考虑以下替代路径：

1. 使用Device Owner配置：通过DPC（Device Policy Controller）应用注册为设备所有者，并调用WifiManager.addNetwork()。
2. 自动化模拟用户操作：结合adb shell input系列命令模拟点击设置界面完成连接。
3. 利用AccessibilityService辅助：开发测试APK监听Wi-Fi弹窗并自动填入凭证。

示例自动化流程（需预先打开Wi-Fi设置）：

adb shell input text "MyHomeWiFi"
adb shell input keyevent 66
adb shell input text "securePass123"
adb shell input tap 500 1000

此外，Mermaid流程图展示了完整的决策逻辑：

graph TD
    A[开始] --> B{Wi-Fi是否开启?}
    B -- 否 --> C[执行: svc wifi enable]
    B -- 是 --> D{Android版本 < 10?}
    D -- 是 --> E[尝试connect-network命令]
    D -- 否 --> F[检查是否Device Owner]
    F -- 是 --> G[调用系统API添加网络]
    F -- 否 --> H[使用GUI自动化或放弃]
    E --> I{成功?}
    I -- 是 --> J[连接完成]
    I -- 否 --> H

该流程体现了现代Android环境下多层权限校验的复杂性。