Android 12系统源码_Settings（一）认识Preference

媒介

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

1. <PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
3.     <PreferenceCategory app:title="@string/messages_header">
5.         <EditTextPreference
6.             app:key="signature"
7.             app:title="@string/signature_title"
8.             app:useSimpleSummaryProvider="true" />
10.         <ListPreference
11.             app:defaultValue="reply"
12.             app:entries="@array/reply_entries"
13.             app:entryValues="@array/reply_values"
14.             app:key="reply"
15.             app:title="@string/reply_title"
16.             app:useSimpleSummaryProvider="true" />
18.     </PreferenceCategory>
20.     <PreferenceCategory app:title="@string/sync_header">
22.         <SwitchPreferenceCompat
23.             app:key="sync"
24.             app:title="@string/sync_title" />
26.         <SwitchPreferenceCompat
27.             app:dependency="sync"
28.             app:key="attachment"
29.             app:summaryOff="@string/attachment_summary_off"
30.             app:summaryOn="@string/attachment_summary_on"
31.             app:title="@string/attachment_title" />
33.     </PreferenceCategory>
34.    
35. </PreferenceScreen>

复制代码

  res/values/arrays.xml

1. <resources>
2.     <!-- Reply Preference -->
3.     <string-array name="reply_entries">
4.         <item>Reply</item>
5.         <item>Reply to all</item>
6.     </string-array>
8.     <string-array name="reply_values">
9.         <item>reply_value</item>
10.         <item>reply_all_value</item>
11.     </string-array>
12. </resources>

复制代码

  res/values/strings.xml

1. <resources>
2.     <string name="app_name">SettingsDemoApplication</string>
3.     <string name="title_activity_settings">SettingsActivity</string>
5.     <!-- Preference Titles -->
6.     <string name="messages_header">Messages</string>
7.     <string name="sync_header">Sync</string>
9.     <!-- Messages Preferences -->
10.     <string name="signature_title">Your signature</string>
11.     <string name="reply_title">Default reply action</string>
13.     <!-- Sync Preferences -->
14.     <string name="sync_title">Sync email periodically</string>
15.     <string name="attachment_title">Download incoming attachments</string>
16.     <string name="attachment_summary_on">Automatically download attachments for incoming emails
17.     </string>
18.     <string name="attachment_summary_off">Only download attachments when manually requested</string>
19. </resources>

复制代码

2.2、创建PreferenceFragmentCompat类

创建一个 Java 类继承自 PreferenceFragmentCompat，并在其中加载上述 XML 文件。

1. public class SettingsFragment extends PreferenceFragmentCompat {
3.     @Override
4.     public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
5.         setPreferencesFromResource(R.xml.root_preferences, rootKey);
6.     }
7.    
8. }

复制代码

2.3、在 Activity 中显示PreferenceFragmentCompat

新建一个Activity，并在该Activity中将 SettingsFragment 添加到结构中。
   com/example/settings/SettingsActivity.java

1. public class SettingsActivity extends AppCompatActivity {
3.     @Override
4.     protected void onCreate(Bundle savedInstanceState) {
5.         super.onCreate(savedInstanceState);
6.         setContentView(R.layout.activity_settings);
7.         //加载SettingsFragment
8.         getSupportFragmentManager()
9.                 .beginTransaction()
10.                 .replace(R.id.settings_container, new SettingsFragment())
11.                 .commit();
12.     }
13. }

复制代码

  res/layout/settings_activity.xml

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.     android:layout_width="match_parent"
3.     android:layout_height="match_parent">
5.     <FrameLayout
6.         android:id="@+id/settings_container"
7.         android:layout_width="match_parent"
8.         android:layout_height="match_parent" />
9.         
10. </LinearLayout>

复制代码

2.4、UI效果图视图

利用Preference只要经过上面的简朴配置就能实现下面的效果图了。

2.5、监听Preference控件的状态厘革

1. public class SettingsFragment extends PreferenceFragmentCompat {
3.     public static final String TAG = "SettingsFragment";
5.     @Override
6.     public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
7.         setPreferencesFromResource(R.xml.root_preferences, rootKey);
8.         //监听Preference的状态
9.         EditTextPreference editTextPreference = findPreference("signature");
10.         editTextPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
11.             @Override
12.             public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) {
13.                 //回调日志打印
14.                 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue);
15.                 return false;
16.             }
17.         });
18.         ListPreference listPreference = findPreference("reply");
19.         listPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
20.             @Override
21.             public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) {
22.                 //回调日志打印
23.                 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue);
24.                 return false;
25.             }
26.         });
27.         SwitchPreferenceCompat switchPreferenceSync = findPreference("sync");
28.         switchPreferenceSync.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
29.             @Override
30.             public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) {
31.                 //回调日志打印
32.                 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue);
33.                 return false;
34.             }
35.         });
36.         SwitchPreferenceCompat switchPreferenceAttachment = findPreference("attachment");
37.         switchPreferenceAttachment.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
38.             @Override
39.             public boolean onPreferenceChange(@NonNull Preference preference, Object newValue) {
40.                 //回调日志打印
41.                 Log.i(TAG, "onPreferenceChange preference = " + preference + ", newValue = " + newValue);
42.                 return false;
43.             }
44.         });
45.     }
46. }

复制代码

这样在我们对各个控件进行操纵的时间，就能收到对应控件的状态厘革了。

1. 2024-08-03 01:08:39.808  3249-3249  SettingsFragment        com.example.settings                 I  onPreferenceChange preference = Your signature 未设置, newValue = 123456
2. 2024-08-03 01:08:42.778  3249-3249  SettingsFragment        com.example.settings                 I  onPreferenceChange preference = Default reply action 未设置, newValue = reply_value
3. 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. (1) PreferenceScreen：根节点，代表一个偏好设置的屏幕。它是其他Preference组件的容器。
2. (2) EditTextPreference：允许用户输入文本值的偏好设置。
3. (3) CheckBoxPreference（在新版中被`SwitchPreferenceCompat`替代）：提供一个开关按钮供用户开启或关闭某个设置。
4. (4) SwitchPreferenceCompat：与CheckBoxPreference功能类似，提供一个滑动开关供用户切换设置。
5. (5) ListPreference：显示一个选择列表，用户可以从中选择一个选项作为设置。
6. (6) MultiSelectListPreference：允许用户从列表中选择多个选项。
7. (7) PreferenceCategory：用于将偏好设置分组的类别标题。
8. (8) PreferenceFragmentCompat：一个Fragment，用于在其内部显示一个偏好设置的屏幕。

复制代码

4.2 常见标签

1. (1) key: 这个属性定义了偏好设置的唯一标识符。通过这个键，你可以在代码中检索或更新偏好设置的值。
2. (2) title: 设置项的标题，这是用户在设置界面看到的文本。
3. (3) summary: 设置项的摘要或描述，显示在标题下方，用于提供更多关于设置项的信息。
4. (4) defaultValue: 定义设置项的默认值。当应用第一次运行，且用户尚未更改过该设置时，将使用此默认值。
5. (5) widgetLayout: 允许开发者为偏好设置项指定一个自定义的布局。
6. (6) dependency: 这个属性使当前偏好设置依赖于另一个偏好设置的值。例如，如果一个偏好设置项被禁用，直到另一个特定的偏好设置被激活/选中。
7. (7) enabled: 控制偏好设置是否可用。默认为 true，即默认情况下是启用状态。
8. (8) selectable: 控制偏好设置项是否可以被选中。默认为 true。
9. (9) icon: 给设置项指定一个图标，以增加可识别性。
10. (10) fragment: 指定当偏好设置被选中时，应该启动的Fragment的全名。这对于构建多层次的设置界面很有用。

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。