Android 13 Settings 设置界面选项裁剪（RK3568平台）

本文记录工作中，在rk3568安卓13的SDK中如何裁剪设置界面，只保留界面中的需求选项。

前言

[一、Settings 应用基本架构与原理](#一、Settings 应用基本架构与原理)

[1.1 三层结构设计](#1.1 三层结构设计)

[1.2 界面动态加载机制](#1.2 界面动态加载机制)

[1.3 配置文件的层级关系](#1.3 配置文件的层级关系)

二、环境与源码路径说明

三、修改实操：裁剪主界面选项

[3.1 定位主界面配置文件](#3.1 定位主界面配置文件)

[3.2 裁剪方法](#3.2 裁剪方法)

四、修改实操：裁剪子菜单（以"系统"菜单为例）

[4.1 定位子菜单配置文件](#4.1 定位子菜单配置文件)

[4.2 文件内容分析（已加中文注释）](#4.2 文件内容分析（已加中文注释）)

[4.3 裁剪示例](#4.3 裁剪示例)

总结

前言

在基于AOSP进行Android系统定制开发时，裁剪系统设置（Settings）应用中的冗余选项是一项非常常见的需求。无论是为了简化用户界面、隐藏不适用于当前硬件的功能，还是为了满足特定产品的定制化要求，开发者往往需要对Settings应用进行"减法"操作。

本文将基于RK3568平台 + Android 13 SDK ，以实际项目为背景，详细介绍如何通过修改XML配置文件，安全、高效地裁剪Settings主界面及子菜单（如"系统"菜单）中的选项。本文不涉及复杂的代码逻辑修改，而是采用最轻量、风险最低的配置裁剪方案，适合初学者快速上手，也为有经验的开发者提供一套可复用的方法论。

一、Settings 应用基本架构与原理

在深入裁剪操作之前，我们有必要先了解Android Settings应用的设计哲学，这有助于我们精准定位修改位置，避免"改错地方"或"改完不生效"。

1.1 三层结构设计

Android Settings应用采用 "页面 --- 片段 --- 控制器" 的三层架构：

层级	作用	典型组件
页面层（Activity）	承载Fragment容器，管理页面跳转和Intent解析	`SettingsActivity`
片段层（Fragment）	显示具体设置页面，管理生命周期和UI布局	`DashboardFragment` 及其子类
控制层（Controller）	控制单个选项的显示/隐藏、状态更新和点击响应	`PreferenceController` 子类

1.2 界面动态加载机制

Settings主界面和各个子菜单的UI结构，并不是硬编码在Java/Kotlin代码中的，而是通过 XML配置文件 动态加载生成。每个Preference或PreferenceScreen条目，都对应一个XML节点，包含标题、图标、目标Fragment或Intent等属性。

因此，我们只需要修改对应的XML文件，即可实现对界面元素的增删改，无需改动Java代码，也不需要重新编写业务逻辑。

1.3 配置文件的层级关系

以"系统"菜单为例，其层级关系如下：

主界面 ：top_level_settings.xml 定义了首页显示的所有一级入口（如网络、设备、系统等）。
子菜单界面 ：当点击"系统"入口时，会跳转到 SystemDashboardFragment，其布局由 system_dashboard_fragment.xml 定义。

这种通过android:fragment属性关联的方式，使得我们能够轻松定位到任意子菜单的配置文件。

二、环境与源码路径说明

平台：RK3568
Android版本：13 (API 33)
Settings模块源码路径：
html 复制代码
```
packages/apps/Settings/
```
主要配置文件目录：
html 复制代码
```
packages/apps/Settings/res/xml/
```

三、修改实操：裁剪主界面选项

3.1 定位主界面配置文件

主界面的配置文件为：

html 复制代码

packages/apps/Settings/res/xml/top_level_settings.xml

该文件中定义了所有一级分类选项，例如"网络和互联网"、"已连接的设备"、"应用"、"系统"等。

3.2 裁剪方法

直接编辑该文件，注释或删除 对应的<Preference>或<com.android.settings.widget.HomepagePreference>节点即可。

示例：隐藏"系统"一级入口

原配置：

XML 复制代码

<com.android.settings.widget.HomepagePreference
    android:fragment="com.android.settings.system.SystemDashboardFragment"
    android:icon="@drawable/ic_settings_system_dashboard_white"
    android:key="top_level_system"
    android:order="10"
    android:title="@string/header_category_system"
    android:summary="@string/system_dashboard_summary"
    settings:highlightableMenuKey="@string/menu_key_system"/>

修改为（注释掉）：

XML 复制代码

<!-- 
<com.android.settings.widget.HomepagePreference
    android:fragment="com.android.settings.system.SystemDashboardFragment"
    android:icon="@drawable/ic_settings_system_dashboard_white"
    android:key="top_level_system"
    android:order="10"
    android:title="@string/header_category_system"
    android:summary="@string/system_dashboard_summary"
    settings:highlightableMenuKey="@string/menu_key_system"/>
-->

保存后，重新编译Settings模块或全编译系统，该选项将从主界面消失。

四、修改实操：裁剪子菜单（以"系统"菜单为例）

4.1 定位子菜单配置文件

根据主界面中"系统"条目所指向的Fragment：

XML 复制代码

android:fragment="com.android.settings.system.SystemDashboardFragment"

我们可以在packages/apps/Settings/res/xml/目录下查找与system_dashboard相关的文件，最终定位到：

XML 复制代码

packages/apps/Settings/res/xml/system_dashboard_fragment.xml

4.2 文件内容分析（已加中文注释）

该文件即为"系统"子菜单的完整配置，我们已在项目中为每个条目添加了中文注释，方便识别功能：

XML 复制代码

<PreferenceScreen
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:settings="http://schemas.android.com/apk/res-auto"
    android:key="system_dashboard_screen"
    android:title="@string/header_category_system">

    <!-- 语言和输入法 -->
    <Preference
        android:key="language_input_settings"
        android:title="@string/language_settings"
        android:icon="@drawable/ic_settings_language"
        android:order="-260"
        android:fragment="com.android.settings.language.LanguageAndInputSettings"/>

    <!-- 日期和时间 -->
    <Preference
        android:key="date_time_settings"
        android:title="@string/date_and_time"
        android:icon="@drawable/ic_settings_date_time"
        android:order="-240"
        android:fragment="com.android.settings.datetime.DateTimeSettings"
        settings:controller="com.android.settings.datetime.DateTimePreferenceController"/>

    <!-- 系统更新 -->
    <Preference
        android:key="system_update_settings"
        android:title="@string/system_update_settings_list_item_title"
        android:summary="@string/summary_placeholder"
        android:icon="@drawable/ic_system_update"
        android:order="-58"
        settings:keywords="@string/keywords_system_update_settings"
        settings:controller="com.android.settings.system.SystemUpdatePreferenceController">
        <intent android:action="android.settings.SYSTEM_UPDATE_SETTINGS"/>
    </Preference>

    <!-- 重置选项 -->
    <Preference
        android:key="reset_dashboard"
        android:title="@string/reset_dashboard_title"
        android:icon="@drawable/ic_restore"
        android:order="-30"
        android:fragment="com.android.settings.system.ResetDashboardFragment"
        settings:controller="com.android.settings.system.ResetPreferenceController"/>
</PreferenceScreen>

注意：原文件中还包含一个被注释掉的"手势"选项，说明Google自身也通过注释方式进行功能裁剪，这印证了本方案的合理性。

4.3 裁剪示例

若需隐藏"重置选项"：

XML 复制代码

<!-- 
<Preference
    android:key="reset_dashboard"
    android:title="@string/reset_dashboard_title"
    android:icon="@drawable/ic_restore"
    android:order="-30"
    android:fragment="com.android.settings.system.ResetDashboardFragment"
    settings:controller="com.android.settings.system.ResetPreferenceController"/>
-->

同理，隐藏其他条目只需注释对应节点即可。

总结

通过本文的介绍，我们可以清晰地看到，Android Settings应用的选项裁剪并不需要复杂的代码入侵，而是巧妙地利用了其基于XML的动态加载机制。这种配置化修改方式具有以下显著优势：

优势	说明
低风险	不修改Java/Kotlin逻辑，不影响核心功能
易回退	只需取消注释即可恢复，方便版本迭代
可维护性高	修改集中、可追溯，适合团队协作
快速验证	支持单模块编译，调试效率高

当然，配置文件裁剪也有其局限性，例如无法动态根据条件（如硬件是否存在）控制选项显示，这时仍需借助PreferenceController进行运行时控制。但对于绝大多数"硬编码"式裁剪需求，XML修改方案无疑是最优解。希望本文能为从事Android系统定制的开发者提供一份清晰、可落地的实战参考。