前言

想刀一家公司的心事藏不住的，原本只了解一下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

res/values/arrays.xml

                   Reply         Reply to all                    reply_value         reply_all_value       

res/values/strings.xml

     SettingsDemoApplication     SettingsActivity           Messages     Sync           Your signature     Default reply action           Sync email periodically     Download incoming attachments     Automatically download attachments for incoming emails          Only download attachments when manually requested  

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()                 .replace(R.id.settings_container, new SettingsFragment())                 .commit();     } } 

res/layout/settings_activity.xml

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的全名。这对于构建多层次的设置界面很有用。