展锐平台(Android15)WLAN热点名称修改不生效问题分析
2025-06-28 / 龙之叶   

前言

在展锐Android V项目开发中，需要修改softAp/P2P热点名称时，发现集成GMS后直接修改framework层代码无效。具体表现为：

  • 修改packages/modules/Wifi/WifiApConfigStore中的getDefaultApConfiguration方法
  • 编译烧录后修改不生效

Wi-Fi配置界面

问题根源在于：Wi-Fi模块在Android S(12)及以上版本已纳入Mainline模块

Mainline模块机制解析

什么是Mainline？

Google将部分核心模块独立开发维护，这些模块会随系统更新单独升级，不再依赖AOSP版本迭代。这导致：

  • 修改本地代码会被系统预置模块覆盖
  • 整编时无法打包修改后的模块

受影响模块列表

参考Google官方文档：模块化系统架构

Mainline模块时间轴
Wi-Fi模块自Android 11开始Mainline化

问题分析

修改失效原因

  1. 代码覆盖：Mainline模块优先级高于本地修改
  2. 编译机制：GMS版本会强制使用预置模块
  3. 认证限制：关闭Mainline会影响GTS测试

解决方案矩阵

方案 适用场景 限制条件
Overlay机制 修改配置参数 需展锐平台支持
运行时设置 动态修改热点名 需处理冲突逻辑
关闭Mainline 仅限国内版本 影响GMS认证

具体解决方案

方案1：使用Overlay机制（推荐）

展锐平台已提供Overlay配置入口：
vendor/sprd/platform/frameworks/opt/net/wifi/service/ServiceUniWifiResources/res/values/config.xml

1
2
<string name="config_wifi_softap_ssid">custom</string>
<string name="config_wifi_p2p_device_name">MyP2PName</string>

方案2：运行时动态设置

通过系统广播监听实现首次启动配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// 监听BOOT_COMPLETED广播
public class HotspotInitializer extends BroadcastReceiver {

    private static final String PREF_HOTSPOT_SET = "hotspot_initialized";
    
    @Override
    public void onReceive(Context context, Intent intent) {
        if (isAlreadyConfigured(context)) return;
        
        WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
        SoftApConfiguration config = wifiManager.getSoftApConfiguration();
        String newSsid = SystemProperties.get("ro.product.model") + "_HOTSPOT";
        
        wifiManager.setSoftApConfiguration(
            new SoftApConfiguration.Builder(config)
                .setSsid(newSsid)
                .build()
        );
        
        markAsConfigured(context);
    }
    
    private boolean isAlreadyConfigured(Context ctx) {
        return PreferenceManager.getDefaultSharedPreferences(ctx)
            .getBoolean(PREF_HOTSPOT_SET, false);
    }
}

关键点：

  1. 使用SharedPreferences记录配置状态
  2. 通过系统属性获取设备型号作为SSID基础
  3. 需在AndroidManifest.xml中注册广播接收器

方案3：关闭Mainline模块（仅限国内版本）

在BoardConfig.mk中添加：

1
2
# 关闭Wi-Fi Mainline模块（影响GTS测试）
MAINLINE_INCLUDE_WIFI_MODULE := false

风险提示：

  • 可能导致GMS认证失败
  • 无法接收Wi-Fi模块安全更新
  • 仅建议在非GMS版本或测试环境使用

总结与建议

  1. 优先方案：使用Overlay机制（方案1），这是最安全合规的方式
  2. 备选方案：运行时设置（方案2），需处理好配置冲突
  3. 最后手段：关闭Mainline（方案3），仅限特定场景使用

对于GMS认证设备，建议采用方案1+方案2组合：

  • 使用Overlay设置默认值
  • 通过运行时机制允许用户自定义
  • 保留系统设置入口作为最终配置渠道

最后

附上Android15上测试可用的修改方法:
vendor/sprd/platform/packages/app/UniWifi/app/res/values/config.xml

1
2
3
4
5
6
7
8
     <!-- Carrier default softap ssid via IMEI, like as 1234, name1, name2 -->
     <string-array translatable="false" name="config_uniwifi_softap_default_ssid_via_imei"></string-array>
     <!-- Customer default softap ssid -->
-    <string translatable="false" name="config_uniwifi_softap_default_ssid"></string>
+    <string translatable="false" name="config_uniwifi_softap_default_ssid">custom</string>
 
     <!-- Preset Carrier Network as Suggestion according to software version -->
     <!-- ro.carrier, ssid, eap type(WifiConfiguration.SECURITY_TYPE#3-5-9),
本文链接：
http://longzhiye.top/2025/06/28/2025-06-28/