[MT8766][Android12] 无屏设备调试新思路：定制化WIFI热点实现开机即连ADB

1. 无屏设备调试的痛点与解决方案

开发无屏Android设备时，调试一直是个让人头疼的问题。想象一下，你正在开发一款智能盒子或者物联网终端，设备没有屏幕，也没有物理按键，这时候如果遇到系统崩溃或者需要调试，该怎么办？传统的有线ADB连接虽然稳定，但在很多场景下并不实用。比如设备安装在难以触及的位置，或者需要批量调试多台设备时，有线连接就显得非常笨拙。

我最近在MT8766平台上开发一款智能盒子时就遇到了这个问题。设备出厂后默认关闭了有线ADB，客户拿到设备后根本无法进行初始设置。经过多次尝试，我发现通过定制WIFI热点的方式可以完美解决这个难题。具体思路是让设备开机后自动开启一个预配置好的WIFI热点，调试设备连接这个热点后，就能通过固定的IP地址进行ADB连接和投屏操作。

这个方案有几个关键优势：首先，它完全无线化，不受物理连接限制；其次，开机即用，无需人工干预；最重要的是，IP地址固定，方便脚本化操作。在实际项目中，这套方案帮我节省了大量调试时间，特别是在批量设备测试时，效率提升非常明显。

2. MT8766平台环境准备

2.1 硬件与系统要求

在开始修改前，我们需要准备好开发环境。MT8766是联发科推出的一款中端芯片，广泛应用于智能盒子、物联网设备等领域。我使用的开发板运行的是Android 12系统，内核版本为msm-4.19。如果你使用的是其他版本，可能需要做一些适配调整。

首先确认你的设备已经解锁了开发者选项，并且具备系统级修改权限。因为我们要修改的是系统底层的WIFI热点配置，所以需要有完整的系统源码编译环境。建议使用Ubuntu 20.04 LTS作为开发机系统，内存至少16GB，硬盘空间建议预留200GB以上，因为Android源码体积相当庞大。

2.2 源码获取与编译

从联发科获取MT8766的BSP包后，按照官方文档搭建编译环境。这里有个小技巧：编译前先执行lunch命令选择正确的设备配置。我通常使用以下命令序列：

source build/envsetup.sh lunch full_<device>-userdebug make -j$(nproc)

第一次编译可能会花费几个小时，建议在晚上开始编译。编译完成后，你会得到可以刷入设备的系统镜像。在正式修改代码前，建议先刷一次原始系统，确保基础环境正常工作。

3. 定制WIFI热点配置

3.1 修改热点名称和密码

默认情况下，Android的热点名称是随机生成的，密码也是动态变化的，这显然不适合我们的需求。我们需要修改WifiApConfigStore.java文件，固定热点的SSID和密码。这个文件位于packages/modules/Wifi/service/java/com/android/server/wifi/目录下。

找到getDefaultApConfiguration方法，这里定义了热点的默认配置。原始代码会生成随机名称和密码，我们需要将其替换为固定值。这是我的修改方案：

private SoftApConfiguration getDefaultApConfiguration() { SoftApConfiguration.Builder configBuilder = new SoftApConfiguration.Builder(); configBuilder.setBand(generateDefaultBand(mContext)); // 设置固定热点名称 configBuilder.setSsid("DEBUG_AP"); // 设置固定密码 if (ApConfigUtil.isWpa3SaeSupported(mContext)) { configBuilder.setPassphrase("debug1234", SoftApConfiguration.SECURITY_TYPE_WPA3_SAE_TRANSITION); } else { configBuilder.setPassphrase("debug1234", SoftApConfiguration.SECURITY_TYPE_WPA2_PSK); } return configBuilder.build(); }

这里有几个注意事项：热点名称最好不要包含特殊字符，某些设备可能不支持；密码长度至少8位，否则系统会拒绝设置；安全类型要根据设备实际支持情况选择。我在多个MT8766设备上测试过，WPA2_PSK的兼容性最好。

3.2 固定热点IP地址

为了让调试设备能够稳定连接，我们需要为热点分配固定的IP地址。这个配置在IpServer.java文件中，路径是packages/modules/Connectivity/Tethering/src/android/net/ip/。

找到定义下游地址的部分，我们添加一个专门用于WIFI热点的IP地址：

private static final String WIFI_IFACE_ADDR = "192.168.68.1/24"; // 在getDownstreamAddress方法中添加 if (mInterfaceType == TetheringManager.TETHERING_WIFI) { return new LinkAddress(WIFI_IFACE_ADDR); }

IP地址的选择很有讲究。我推荐使用192.168.68.1/24这个网段，原因有三：首先，它属于私有地址范围，不会与公网冲突；其次，这个网段比较冷门，不太容易与用户的其他网络设备冲突；最后，子网掩码24位可以提供足够多的IP地址供调试使用。

4. 实现开机自动开启热点

4.1 监听开机广播

现在我们已经配置好了热点参数，接下来需要让设备开机时自动开启热点。这需要通过监听系统广播来实现。我选择在SecurityService.java中添加这个功能，这个文件通常位于frameworks/base/custom/java/com/common/sdk/security/目录。

首先创建一个BroadcastReceiver来接收开机完成广播：

private final class SecurityReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { if (intent.getAction().equals(Intent.ACTION_BOOT_COMPLETED)) { Log.d(TAG, "System boot completed, starting WiFi hotspot"); startWifiHotspot(); } } }

然后在服务的onStart方法中注册这个接收器：

@Override public void onStart() { IntentFilter filter = new IntentFilter(); filter.addAction(Intent.ACTION_BOOT_COMPLETED); registerReceiver(new SecurityReceiver(), filter); }

4.2 启动热点服务

实现startWifiHotspot方法，通过ConnectivityManager来启动热点：

private void startWifiHotspot() { ConnectivityManager mConnectivityManager = (ConnectivityManager) mContext.getSystemService(Context.CONNECTIVITY_SERVICE); ConnectivityManager.OnStartTetheringCallback callback = new ConnectivityManager.OnStartTetheringCallback() { @Override public void onTetheringFailed() { Log.e(TAG, "Failed to start WiFi hotspot"); } }; Handler handler = new Handler(Looper.getMainLooper()); mConnectivityManager.startTethering( ConnectivityManager.TETHERING_WIFI, false, // 不显示配置界面 callback, handler); }

这里有几个关键点：首先，我们设置了不显示配置界面（第二个参数为false），因为我们的设备是无屏的，显示配置界面没有意义；其次，使用了主线程的Looper来创建Handler，确保回调在主线程执行；最后，添加了失败回调，方便排查问题。

5. 调试与问题排查

5.1 ADB连接测试

完成上述修改并刷入设备后，就可以测试我们的方案了。设备开机后，用手机或电脑搜索名为"DEBUG_AP"的热点，连接密码是"debug1234"。连接成功后，在终端执行：

adb connect 192.168.68.1

如果一切正常，你会看到连接成功的提示。这时候就可以像使用USB连接一样进行ADB调试了。我建议首次使用时先测试基本功能：

adb devices # 查看设备列表 adb shell # 进入设备shell

5.2 常见问题解决

在实际项目中，我遇到过几个典型问题。首先是热点无法启动，这通常是因为权限不足。解决方法是在AndroidManifest.xml中添加必要的权限：

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

其次是ADB连接不稳定，这可能是由于防火墙设置。可以在设备上执行以下命令开放ADB端口：

iptables -A INPUT -p tcp --dport 5555 -j ACCEPT

最后是热点自动关闭的问题，这通常与系统省电策略有关。修改PowerManagerService的配置，确保热点服务不会被系统休眠。

6. 方案优化与扩展

6.1 动态配置管理

固定配置虽然简单，但在实际部署中可能不够灵活。我们可以进一步改进，让配置可以通过ADB命令动态修改。创建一个简单的配置文件：

public class HotspotConfig { public String ssid = "DEBUG_AP"; public String password = "debug1234"; public String ipAddress = "192.168.68.1"; // 添加其他配置项... }

然后通过ContentProvider或者Socket接口暴露配置修改方法。这样现场工程师就可以根据实际环境调整热点参数，而不需要重新刷机。

6.2 多设备协同调试

在批量生产测试场景下，我们可以扩展这个方案支持多设备同时调试。思路是让每个设备使用不同的SSID和IP地址：

// 根据设备序列号生成唯一配置 String serial = Build.getSerial(); String ssid = "DEBUG_" + serial.substring(0, 4); String ipSuffix = serial.hashCode() % 254 + 1; String ipAddress = "192.168.68." + ipSuffix;

这样每台设备都有独立的网络标识，测试人员可以同时连接多台设备进行批量操作。我在一个包含50台设备的测试项目中采用这个方案，测试效率提升了近10倍。

6.3 安全性增强

开放ADB端口存在一定安全风险，我们可以添加简单的认证机制。例如，只有特定MAC地址的设备才能连接热点：

WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE); WifiInfo connectionInfo = wifiManager.getConnectionInfo(); String mac = connectionInfo.getMacAddress(); if (!allowedMacs.contains(mac)) { wifiManager.setWifiApEnabled(null, false); // 关闭热点 }

更安全的做法是使用证书认证，但这会增加实现复杂度。根据项目实际安全要求选择合适的方案很重要。