Android 30中SoftApConfigurations.Builder隐藏，无法创建预定义SSID热点？

很多开发者都碰到过你这个问题——在Android 30（API 30）里，SoftApConfigurations.Builder确实是被标记为隐藏API的，官方并没有开放给第三方应用直接调用。

问题背景 #

从Android 10（API 29）开始，Google就把SoftApConfigurations.Builder标记为@hide，核心目的是限制第三方应用自定义LocalOnlyHotspot的SSID和密码。官方设计的LocalOnlyHotspot本来就是生成随机网络标识，避免开发者随意创建可识别热点带来的隐私或安全风险。

其他开发者的遭遇 #

这个问题在开发者社区里非常普遍：

• 大量想自定义热点SSID的第三方应用开发者都卡在这一步，因为公开API里根本没有提供自定义LocalOnlyHotspot配置的合法路径；
• 直接引用SoftApConfigurations.Builder的代码会编译失败，就算通过反射调用，也可能在部分定制ROM设备上出现兼容性问题，甚至会因使用非公开API被Google Play商店拒审。

常见替代方案 #

如果你一定要实现自定义SSID的热点，可以参考这些开发者常用的方法，但都有各自的限制：

• 反射调用隐藏API：通过反射获取SoftApConfigurations.Builder实例，构建配置后传入startLocalOnlyHotspot。示例代码大致如下：

  try {
      Class<?> builderClass = Class.forName("android.net.wifi.SoftApConfiguration$Builder");
      Object builder = builderClass.getDeclaredConstructor().newInstance();
      // 设置自定义SSID
      builderClass.getMethod("setSsid", String.class).invoke(builder, "你的自定义SSID");
      // 按需设置密码等其他配置
      Object config = builderClass.getMethod("build").invoke(builder);
      
      // 获取WifiManager并调用启动方法
      WifiManager wifiManager = (WifiManager) getSystemService(Context.WIFI_SERVICE);
      Method startMethod = wifiManager.getClass().getMethod("startLocalOnlyHotspot", config.getClass(), WifiManager.LocalOnlyHotspotCallback.class, Handler.class);
      startMethod.invoke(wifiManager, config, yourCallbackInstance, null);
  } catch (Exception e) {
      e.printStackTrace();
  }
  

  注意：这种方法依赖系统内部API，不同厂商的定制ROM可能修改这些类/方法导致代码失效，同时不符合Google Play的上架政策。
• 使用旧版热点API（Android 10+已废弃）：通过WifiManager.setWifiApEnabled方法创建传统热点，但这个API在Android 10及以上已被标记为废弃，需要申请ACCESS_WIFI_STATE、CHANGE_WIFI_STATE权限，且Android 10+还需要ACCESS_FINE_LOCATION权限才能正常使用。
• 接受系统默认配置：如果不是必须自定义SSID，直接使用不带参数的startLocalOnlyHotspot方法，让系统生成随机SSID和密码，这种方式最稳定且符合官方规范。

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