Android 12系统源码_Settings（一）认识Preference
admin前言
想刀一家公司的心事藏不住的，原本只了解一下Android系统应用Settings的配置开关列表中某个开关开启或关闭的时候，系统做了哪些响应操作，结果搞了半天发现完全看不懂。写界面就写界面吧，但是Settings模块完全没有使用Android常规UI那种方案，而是结合Preference重新搞了一套UI布局方案，这样我们要想研究或定制Settings模块的某些功能，就必须先对Preference这套UI布局方案有个简单的认识。
一、Preference
1.1、简介
在 Android 开发中，Preference 是用来构建用户界面的组件，它提供了一种简单而有效的方式来管理应用的设置和用户偏好。Preference 类及其相关类主要用于创建和管理用户界面中的设置选项，例如复选框、单选按钮、列表项等，允许用户调整应用的行为和外观。
1.2、主要的 Preference 类型
- Preference：
Preference 是所有偏好设置类的基类，通常不直接使用，而是通过其子类进行扩展和使用。
- CheckBoxPreference：
CheckBoxPreference 是一个复选框偏好设置，允许用户通过勾选或取消勾选来控制一个布尔值设置项。
- ListPreference：
ListPreference 允许用户从一个固定的列表中选择一个选项，例如选择语言、主题等。
- EditTextPreference：
EditTextPreference 允许用户输入文本，通常用于需要用户输入自定义内容的设置项。
- SwitchPreference：
SwitchPreference 是一个开关偏好设置，与 CheckBoxPreference 类似，但使用了开关样式而不是复选框。
- PreferenceCategory：
PreferenceCategory 可以用来将多个相关联的偏好设置项组织到一个类别中，以改善界面的结构和可读性。
二、Preference简单实例
Android系统Settings模块通常大量使用了Preference来构建UI视图，如果直接去看基本都会一脸蒙蔽，这里我们使用Preference编写一个最简单的案例，只要看懂了这个案例，再去分析Settings模块使用Preference所构建的UI视图，基本就柳暗花明了。
2.1、创建 Preference XML 文件
在 res/xml 目录下创建一个 XML 文件，定义应用的偏好设置结构和各个设置项的属性。
res/xml/root_preferences.xml
<PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto"> <PreferenceCategory app:title="@string/messages_header"> <EditTextPreference app:key="signature" app:title="@string/signature_title" app:useSimpleSummaryProvider="true" /> <ListPreference app:defaultValue="reply" app:entries="@array/reply_entries" app:entryValues="@array/reply_values" app:key="reply" app:title="@string/reply_title" app:useSimpleSummaryProvider="true" /> </PreferenceCategory> <PreferenceCategory app:title="@string/sync_header"> <SwitchPreferenceCompat app:key="sync" app:title="@string/sync_title" /> <SwitchPreferenceCompat app:dependency="sync" app:key="attachment" app:summaryOff="@string/attachment_summary_off" app:summaryOn="@string/attachment_summary_on" app:title="@string/attachment_title" /> </PreferenceCategory> </PreferenceScreen> res/values/arrays.xml
<resources> <!-- Reply Preference --> <string-array name="reply_entries"> <item>Reply</item> <item>Reply to all</item> </string-array> <string-array name="reply_values"> <item>reply_value</item> <item>reply_all_value</item> </string-array> </resources> res/values/strings.xml
<resources> <string name="app_name">SettingsDemoApplication</string> <string name="title_activity_settings">SettingsActivity</string> <!-- Preference Titles --> <string name="messages_header">Messages</string> <string name="sync_header">Sync</string> <!-- Messages Preferences --> <string name="signature_title">Your signature</string> <string name="reply_title">Default reply action</string> <!-- Sync Preferences --> <string name="sync_title">Sync email periodically</string> <string name="attachment_title">Download incoming attachments</string> <string name="attachment_summary_on">Automatically download attachments for incoming emails </string> <string name="attachment_summary_off">Only download attachments when manually requested</string> </resources> 2.2、创建PreferenceFragmentCompat类
创建一个 Java 类继承自 PreferenceFragmentCompat，并在其中加载上述 XML 文件。
public class SettingsFragment extends PreferenceFragmentCompat { @Override public void onCreatePreferences(Bundle savedInstanceState, String rootKey) { setPreferencesFromResource(R.xml.root_preferences, rootKey); } } 2.3、在 Activity 中显示PreferenceFragmentCompat
新建一个Activity，并在该Activity中将 SettingsFragment 添加到布局中。
com/example/settings/SettingsActivity.java
public class SettingsActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_settings); //加载SettingsFragment getSupportFragmentManager() .beginTransaction() .ｒｅｐｌａｃｅ(R.id.settings_container, new SettingsFragment()) .commit(); } } res/layout/settings_activity.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent"> <FrameLayout android:id="@+id/settings_container" android:layout_width="match_parent" android:layout_height="match_parent" /> </LinearLayout> 2.4、UI效果图视图
使用Preference只要经过上面的简单配置就能实现下面的效果图了。
2.5、**Preference控件的状态变化
public class SettingsFragment extends PreferenceFragmentCompat { public static final String TAG = "SettingsFragment"; @Override public void onCreatePreferences(Bundle savedInstanceState, String rootKey) { setPreferencesFromResource(R.xml.root_preferences, rootKey); //**Preference的状态 EditTextPreference editTextPreference = findPreference("signature"); editTextPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() { @Override public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) { //回调日志打印 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue); return false; } }); ListPreference listPreference = findPreference("reply"); listPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() { @Override public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) { //回调日志打印 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue); return false; } }); SwitchPreferenceCompat switchPreferenceSync = findPreference("sync"); switchPreferenceSync.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() { @Override public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) { //回调日志打印 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue); return false; } }); SwitchPreferenceCompat switchPreferenceAttachment = findPreference("attachment"); switchPreferenceAttachment.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() { @Override public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) { //回调日志打印 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue); return false; } }); } } 这样在我们对各个控件进行操作的时候，就能收到对应控件的状态变化了。
2024-08-03 01:08:39.808 3249-3249 SettingsFragment com.example.settings I onPreferenceChange preference = Your signature 未设置, newValue = 123456 2024-08-03 01:08:42.778 3249-3249 SettingsFragment com.example.settings I onPreferenceChange preference = Default reply action 未设置, newValue = reply_value 2024-08-03 01:08:49.891 3249-3249 SettingsFragment com.example.settings I onPreferenceChange preference = Sync email periodically, newValue = true 三、Preference小结
简单列举下常见的Preference组件和标签。
4.1 常见组件
(1) PreferenceScreen：根节点，代表一个偏好设置的屏幕。它是其他Preference组件的容器。 (2) EditTextPreference：允许用户输入文本值的偏好设置。 (3) CheckBoxPreference（在新版中被`SwitchPreferenceCompat`替代）：提供一个开关按钮供用户开启或关闭某个设置。 (4) SwitchPreferenceCompat：与CheckBoxPreference功能类似，提供一个滑动开关供用户切换设置。 (5) ListPreference：显示一个选择列表，用户可以从中选择一个选项作为设置。 (6) MultiSelectListPreference：允许用户从列表中选择多个选项。 (7) PreferenceCategory：用于将偏好设置分组的类别标题。 (8) PreferenceFragmentCompat：一个Fragment，用于在其内部显示一个偏好设置的屏幕。 4.2 常见标签
(1) key: 这个属性定义了偏好设置的较早标识符。通过这个键，你可以在代码中检索或更新偏好设置的值。 (2) title: 设置项的标题，这是用户在设置界面看到的文本。 (3) summary: 设置项的摘要或描述，显示在标题下方，用于提供更多关于设置项的信息。 (4) defaultValue: 定义设置项的默认值。当应用靠前次运行，且用户尚未更改过该设置时，将使用此默认值。 (5) widgetLayout: 允许开发者为偏好设置项指定一个自定义的布局。 (6) dependency: 这个属性使当前偏好设置依赖于另一个偏好设置的值。例如，如果一个偏好设置项被禁用，直到另一个特定的偏好设置被激活/选中。 (7) enabled: 控制偏好设置是否可用。默认为 true，即默认情况下是启用状态。 (8) selectable: 控制偏好设置项是否可以被选中。默认为 true。 (9) icon: 给设置项指定一个图标，以增加可识别性。 (10) fragment: 指定当偏好设置被选中时，应该启动的Fragment的全名。这对于构建多层次的设置界面很有用。 TAG：ANDROIDPREFERENCE
