深度分析Settings开发要点

你过来啊你
255 阅读8分钟

核心概念：

  1. AOSP (Android Open Source Project): Android操作系统的开源基础。系统设置应用 (packages/apps/Settings/) 是AOSP的核心应用之一。
  2. 系统设置应用 (Settings.apk): 用户配置设备的核心界面（Wi-Fi、蓝牙、显示、声音、存储、应用、位置、安全、账户、系统更新等）。
  3. 定制目标:
    • 添加/移除设置项（如特定硬件功能、OEM服务、运营商需求）。
    • 修改现有设置项的逻辑和UI。
    • 集成自有服务或SDK。
    • 深度UI主题定制（超越普通主题引擎）。
    • 满足特定法规或市场要求。

深度分析维度：

  1. 架构剖析：

    • Settings Activity: 主入口 (Settings.java)。负责导航框架 (Fragment 管理)、顶部搜索栏、生命周期管理。
    • DashboardFragment: 核心容器。大部分设置页面（如“网络和互联网”、“应用”）继承自它。它：
      • 从 DashboardCategory 和 Tile (通过 DashboardFeatureProvider) 加载动态仪表板项。
      • 处理首选项摘要的自动更新（通过 PreferenceController）。
      • 管理首选项组和布局。
    • PreferenceFragmentCompat (Support Library): DashboardFragment 的基类。提供管理 PreferenceScreen 和 Preference 对象（如 SwitchPreference, ListPreference, PreferenceCategory）的基础设施。
    • PreferenceController (MVC中的C): 关键扩展点！ 每个设置项（Preference）通常由一个 PreferenceController 管理。它负责：
      • 控制Preference的可用性 (isAvailable()).
      • 初始化Preference状态 (displayPreference(), updateState()).
      • 处理Preference的点击事件 (handlePreferenceTreeClick()).
      • 监听底层系统状态变化 (广播、ContentObserver) 并更新UI。
      • 实现实际的业务逻辑（如打开Wi-Fi、修改系统设置）。
    • DashboardFeatureProvider: 定义如何获取仪表板分类 (DashboardCategory) 和磁贴 (Tile)。OEM可通过实现此接口注入自定义磁贴/分类。
    • SearchIndexProvider (Indexable): 使设置项可被全局搜索 (Settings Search)。需要实现 getXmlResourcesToIndex() 提供索引的XML资源。
    • SettingsProvider (com.android.providers.settings): 底层存储！ 系统级ContentProvider，管理核心的 Global, System, Secure 设置数据库。Settings应用通过 Settings.Global, Settings.System, Settings.Secure API读写这些数据库。
    • SystemProperties: 用于读取/写入 ro.*, persist.*, sys.* 等系统属性。Settings中常用（如检查特性开关 ro.feature.x.enabled）。
    • DevicePolicyManager / UserManager / WifiManager 等系统服务: Settings应用通过Binder与这些系统服务交互以执行操作和获取状态。

  2. 关键扩展点与定制方式：

    • 添加新设置页面:
      1. 创建新的Fragment（通常继承 DashboardFragment）。
      2. 在 res/xml/dashboard_categories.xml 或通过 DashboardFeatureProvider 实现类中添加该Fragment对应的 DashboardCategory 和 Tile，定义标题、图标、目标Fragment等。
      3. 为新页面创建 res/xml/some_settings.xml 首选项布局。
      4. 为每个首选项项创建对应的 PreferenceController 及其子类。
      5. 在Fragment的 createPreferenceControllers() 方法中实例化并返回这些控制器。
      6. 实现 SearchIndexProvider 以便新页面可搜索。
    • 修改现有设置项:
      • 修改UI/文本/图标: 覆盖对应的资源文件 (strings.xml, arrays.xml, drawables, layouts)。注意： 优先使用资源叠加 (Resource Overlay)。
      • 修改逻辑/行为: 找到控制该设置项的 PreferenceController (通常在 com.android.settings.[category] 包下)。
        • 可以继承现有Controller并重写方法 (updateState, onPreferenceChange, isAvailable, handlePreferenceTreeClick 等)。
        • 在目标Fragment的 createPreferenceControllers() 中用你的自定义Controller替换原Controller。
      • 添加/移除设置项: 修改对应的 res/xml/*_settings.xml 文件（添加/删除 Preference 标签）。通常需要同步修改其 PreferenceController 的 isAvailable() 逻辑。
    • 资源叠加 (Resource Overlay):
      • 核心机制: 在不修改AOSP原始APK资源的情况下，通过编译时或运行时覆盖 (Overlay APK) 来替换资源。
      • 应用: 修改字符串、颜色、尺寸、布局、图标等UI资源极其常用。避免直接修改AOSP的 Settings/res 目录，提高可维护性。
      • RRO (Runtime Resource Overlay) / Static Overlays: 在编译OEM ROM时配置。
    • 依赖注入 (可选但推荐):
      • 使用 dagger2 (AOSP Settings中已使用) 来管理 PreferenceController 的依赖（如 Context, FeatureFactory, 系统服务接口）。
      • 便于测试和解耦。
    • 与系统服务/守护进程交互:
      • 通过 *Manager 类 (WifiManager, BluetoothAdapter, LocationManager, StorageManager, PowerManager 等) 使用系统API。
      • 监听广播 (BroadcastReceiver) 获取状态变化（如Wi-Fi状态、蓝牙连接状态、电池状态）。
      • 使用 ContentObserver 监听 SettingsProvider 数据库变化。
      • 特权权限: Settings应用通常需要大量系统签名权限 (android.permission.* 特别是 android.permission.WRITE_SECURE_SETTINGS, android.permission.PACKAGE_USAGE_STATS 等) 才能修改关键设置。这些权限需要在 AndroidManifest.xml 中声明，并且APK必须使用平台签名密钥签名。

  3. 开发流程与工具：

    • 环境搭建:
      1. 下载完整AOSP源码 (巨大)。
      2. 配置构建环境 (Linux/macOS, JDK, repo, 编译工具链)。
      3. 选择目标设备或模拟器 (lunch 命令)。
    • 修改代码: 在 packages/apps/Settings/ 目录下进行修改。
    • 编译:
      • mmm packages/apps/Settings/ (仅编译Settings模块及其依赖)
      • make snod (快速重建system.img，不重新编译所有，依赖上次完整编译)
      • 或完整 make -jN (N=核心数)。
    • 刷机/部署:
      • 将生成的 Settings.apk (在 out/target/product/[device]/system/priv-app/Settings/) 推送到设备的 /system/priv-app/Settings/ 目录，覆盖原文件 (需要root/adb remount)。
      • 更推荐： 编译完整的system.img或OTA包，刷入设备或模拟器。修改系统应用后重启通常生效，有时需要清除Settings应用数据或重启两次。
    • 调试:
      • adb logcat | grep Settings 查看Settings日志。
      • Android Studio: Attach debugger to com.android.settings 进程。
      • 添加详细日志 (使用 Log.d)。

  4. 核心挑战与注意事项：

    • 系统签名 (Platform Signing): 最大门槛！ 修改后的 Settings.apk 必须使用与目标设备ROM相同的平台签名密钥签名，否则无法获取特权权限，导致功能失效或崩溃。密钥通常由OEM严格保密。
    • 碎片化 (Fragmentation): AOSP版本 (Android 10/11/12/13/14)、OEM定制层、芯片平台差异巨大。代码和资源位置、API可能在不同版本间变化。需要针对特定基础版本开发。
    • 兼容性: 修改逻辑时需考虑不同Android版本的API差异和行为变化。
    • 权限管理: 仔细管理所需权限，确保只声明和使用必要的权限。
    • 性能: 避免在UI线程做耗时操作（如网络请求、大量数据库查询），正确使用 Loader 或后台线程。监听器 (ContentObserver, BroadcastReceiver) 要及时注册和注销。
    • 线程安全: UI更新必须在主线程，系统回调可能在后台线程。
    • 测试: 极其重要且困难。需要测试各种设备和Android版本。单元测试 (测试 PreferenceController 逻辑)、Instrumentation测试 (测试UI流程)、CTS/GTS兼容性测试。
    • 深度耦合: Settings应用与Android框架深度耦合，修改可能产生意想不到的副作用。
    • 升级维护: AOSP版本升级时，合并定制代码到新版本是主要工作量和风险点。

  5. 最佳实践与建议：

    • 最小化修改: 优先使用资源叠加修改UI。尽量通过继承和重写 PreferenceController 来修改逻辑，而不是直接修改AOSP原始类。
    • 模块化设计: 将定制功能封装在独立的包或模块中，使用清晰的接口与AOSP Settings交互。利用 DashboardFeatureProvider 注入。
    • 善用版本控制: 使用Git管理你的定制分支，清晰地标记针对不同AOSP版本的修改。
    • 详细注释: 清晰说明为何修改、做了什么、兼容性考虑。
    • 全面测试: 建立自动化测试体系 (单元、UI)，覆盖关键路径和边界条件。手动测试在不同场景下的表现。
    • 关注AOSP变更: 定期关注 packages/apps/Settings 的AOSP Gerrit代码审查，了解上游变化，评估对定制的影响。
    • 理解框架: 深入理解Android框架机制（Binder、权限、广播、ContentProvider、Fragment生命周期）是成功定制的基础。
    • 利用AOSP资源: 尽量复用AOSP已有的资源、样式、图标，保持风格一致。

示例：添加一个简单的“开发者选项”风格的开关

假设你想在 系统 -> 关于手机 下添加一个开关，控制某个内核调试特性（通过sysfs节点）。

  1. 修改 res/xml/device_info_settings.xml: 在合适位置添加一个 SwitchPreference。 
    <SwitchPreference
    android:key="my_custom_debug_feature"
    android:title="@string/my_custom_debug_title"
    android:summary="@string/my_custom_debug_summary" />
  2. 添加字符串资源 (res/values/strings.xml): 
    <string name="my_custom_debug_title">My Debug Feature</string>
<string name="my_custom_debug_summary">Enable/Disable super debug mode</string>
  3. 创建 PreferenceController (src/com/android/settings/deviceinfo/MyCustomDebugPreferenceController.java): 
    public class MyCustomDebugPreferenceController extends SwitchPreferenceController {
    private static final String KEY_MY_CUSTOM_DEBUG = "my_custom_debug_feature";
    private static final String SYSFS_DEBUG_NODE = "/sys/kernel/debug/my_feature/enable";
    public MyCustomDebugPreferenceController(Context context, String preferenceKey) {
        super(context, preferenceKey);
    }
    @Override
    public int getAvailabilityStatus() {
        // 检查设备是否支持该特性，例如检查sysfs节点是否存在
        return new File(SYSFS_DEBUG_NODE).exists() ? AVAILABLE : UNSUPPORTED_ON_DEVICE;
    }
    @Override
    public boolean isChecked() {
        // 读取sysfs节点值，返回当前状态 (e.g., "1" -> true, "0" -> false)
        try {
            return Files.readString(Paths.get(SYSFS_DEBUG_NODE)).trim().equals("1");
        } catch (IOException e) {
            return false;
        }
    }
    @Override
    public boolean setChecked(boolean isChecked) {
        // 写入sysfs节点 (需要root权限或内核节点权限设置正确)
        try (FileWriter writer = new FileWriter(SYSFS_DEBUG_NODE)) {
            writer.write(isChecked ? "1" : "0");
            return true;
        } catch (IOException e) {
            Log.e(TAG, "Failed to write to " + SYSFS_DEBUG_NODE, e);
            return false;
        }
    }
}
  4. 修改 DeviceInfoSettings.java (Fragment): 在 createPreferenceControllers() 方法中添加你的Controller实例。 
    @Override
protected List<AbstractPreferenceController> createPreferenceControllers(Context context) {
    final List<AbstractPreferenceController> controllers = new ArrayList<>();
    ... // 原有的controllers.add(...)
    controllers.add(new MyCustomDebugPreferenceController(context, KEY_MY_CUSTOM_DEBUG));
    return controllers;
}
  5. 权限与签名: 确保修改后的Settings APK使用平台密钥签名。写入sysfs节点通常需要root或内核配置好该节点的权限 (chmod/chown)。

总结：

基于AOSP开发系统设置应用是一项涉及Android框架深度、系统权限、UI架构、跨版本兼容性和复杂构建/部署流程的高阶任务。它要求开发者：

  1. 精通Android框架: 深刻理解Activity/Fragment、Preference、ContentProvider、Broadcast、Binder、权限系统。
  2. 熟悉AOSP结构: 了解Settings应用内部模块划分、关键类 (DashboardFragment, PreferenceController, DashboardFeatureProvider)。
  3. 掌握定制技术: 熟练运用资源覆盖、依赖注入、Fragment/Controller扩展。
  4. 解决核心挑战: 搞定系统签名、处理碎片化、保证兼容性、进行充分测试。
  5. 遵循最佳实践: 模块化、最小修改、详细注释、版本控制。
avatar
文章
阅读
粉丝