[MT8766][Android12] 无屏设备网络调试：定制热点配置与开机自启策略

1. 无屏设备网络调试的核心痛点最近在开发一款基于MT8766芯片的Android12智能盒子时遇到了一个典型问题设备没有屏幕但需要频繁进行调试和维护。传统的有线ADB连接方式在量产环境中并不实用特别是当设备被部署在难以接触的位置时。这时候无线ADB调试就成了刚需。无线调试的关键在于建立稳定的网络连接。对于无屏设备来说最可靠的方式就是让设备自身成为热点。但默认的Android热点配置有几个问题每次开启热点名称都带随机后缀、密码不固定、IP地址动态分配。这会导致每次调试时都需要重新确认连接信息效率极低。我在实际项目中遇到过这样的情况现场有20台设备需要升级固件结果因为热点名称不固定工程师花了半天时间才把所有设备找出来。这就是为什么我们需要定制热点配置——让每台设备开机后自动开启固定名称、固定密码、固定IP的热点形成一个可预测的调试环境。2. MT8766平台的热点定制方案2.1 修改默认热点名称和密码Android系统的默认热点配置位于WifiApConfigStore.java文件中。原始实现会为热点名称添加随机后缀并生成随机密码。我们需要修改这部分代码// packages/modules/Wifi/service/java/com/android/server/wifi/WifiApConfigStore.java private SoftApConfiguration getDefaultApConfiguration() { SoftApConfiguration.Builder configBuilder new SoftApConfiguration.Builder(); configBuilder.setBand(generateDefaultBand(mContext)); // 修改前带随机后缀的SSID // configBuilder.setSsid(mContext.getResources().getString( // R.string.wifi_tether_configure_ssid_default) _ getRandomIntForDefaultSsid()); // 修改后固定SSID configBuilder.setSsid(DEVICE_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(); }这里有几个注意事项SSID不要使用特殊字符某些设备可能无法识别密码长度至少8位符合WPA2标准建议为不同批次设备设置不同的前缀方便区分2.2 固定热点IP地址默认情况下Android热点的IP地址是动态分配的。我们需要修改IpServer.java文件为WiFi热点指定固定IP// packages/modules/Connectivity/Tethering/src/android/net/ip/IpServer.java private static final String WIFI_IFACE_ADDR 192.168.68.1/24; Override protected LinkAddress getDownstreamAddress() { if (mInterfaceType TetheringManager.TETHERING_BLUETOOTH) { return new LinkAddress(BLUETOOTH_IFACE_ADDR); } else if (mInterfaceType TetheringManager.TETHERING_WIFI) { return new LinkAddress(WIFI_IFACE_ADDR); } return mPrivateAddressCoordinator.requestDownstreamAddress(this, useLastAddress); }选择IP段时要注意避免使用常见家用路由器网段如192.168.1.x子网掩码建议用/24足够支持大多数调试场景确保IP地址不会与设备连接的其他网络冲突3. 实现开机自动开启热点3.1 监听开机广播要让设备开机后自动开启热点我们需要注册一个广播接收器。这里有个坑要注意Android 8.0之后对后台服务限制很严直接启动热点可能会失败。正确的做法是在SecurityService中实现// frameworks/base/custom/java/com/common/sdk/security/SecurityService.java private final class SecurityReceiver extends BroadcastReceiver { Override public void onReceive(Context context, Intent intent) { if (intent.getAction().equals(Intent.ACTION_BOOT_COMPLETED)) { ConnectivityManager cm (ConnectivityManager) context.getSystemService( Context.CONNECTIVITY_SERVICE); cm.startTethering(TETHERING_WIFI, false, new ConnectivityManager.OnStartTetheringCallback() { Override public void onTetheringStarted() { Log.d(TAG, WiFi热点已启动); } Override public void onTetheringFailed() { Log.e(TAG, 热点启动失败); // 这里可以加入重试逻辑 } }, new Handler(Looper.getMainLooper())); } } }3.2 处理权限问题在实际测试中我发现即使代码正确热点也可能启动失败。这通常是因为权限问题。需要在AndroidManifest.xml中添加以下权限uses-permission android:nameandroid.permission.TETHER_PRIVILEGED / uses-permission android:nameandroid.permission.ACCESS_NETWORK_STATE / uses-permission android:nameandroid.permission.CHANGE_NETWORK_STATE / uses-permission android:nameandroid.permission.CHANGE_WIFI_STATE /此外还需要在device.mk中确保你的应用有系统签名PRODUCT_PACKAGES \ YourSystemApp \ ...4. 调试技巧与问题排查4.1 ADB连接稳定性优化配置好热点后通过以下命令连接ADBadb connect 192.168.68.1但实际使用中可能会遇到连接不稳定的情况。我总结了几点经验在设备端修改ADB端口监听时间setprop persist.adb.tcp.timeout 600电脑端可以创建自动重连脚本while true; do adb connect 192.168.68.1; sleep 10; done4.2 常见问题排查热点无法启动检查logcat输出过滤WifiAp相关日志确认设备支持AP模式有些低端芯片可能不支持连接后无法上网adb shell iptables -L -t nat检查NAT规则是否正确设置IP地址冲突 如果设备同时连接了其他WiFi可能会出现路由混乱。建议adb shell svc wifi disable系统升级后配置丢失 将修改过的文件加入编译白名单防止OTA时被覆盖PRODUCT_COPY_FILES \ device/your/device/wifi/WifiApConfigStore.java:$(TARGET_COPY_OUT_SYSTEM)/... \5. 生产环境部署建议在量产设备上部署这套方案时还需要考虑以下因素安全性平衡使用固定密码确实方便调试但也存在安全风险建议在正式版本中增加密码轮换机制或者通过扫码等方式动态获取密码多设备共存当多台设备同时开启热点时需要确保它们不在同一信道可以在代码中加入信道选择逻辑configBuilder.setChannel(6, SoftApConfiguration.BAND_2GHZ);功耗管理持续开启热点会增加功耗可以设置超时关闭功能configBuilder.setAutoShutdownEnabled(true); configBuilder.setShutdownTimeoutMillis(30 * 60 * 1000); // 30分钟固件升级策略保留有线ADB作为备用方案实现网络恢复模式当连续N次无法连接时自动重置网络配置这套方案已经在我们的MT8766设备上稳定运行了6个月支持了超过5000台设备的远程维护。最大的收获是现场维护效率提升了70%工程师不再需要带着显示器到处跑。当然也遇到过一些坑比如某次系统升级后热点无法启动最后发现是新版本增加了权限检查。所以建议在每次系统升级后都要完整测试网络调试功能。