详解Android首选项框架ListPreference

探索首选项框架

在深入探讨Android的首选项框架之前，首先构想一个需要使用首选项的场景，然后分析如何实现这一场景。假设你正在编写一个应用程序，它提供了一个搜索飞机航班的工具。而且，假设该应用程序的默认设置是根据机票价格由低到高的顺序显示航班，但用户可以将首选项设置为始终根据最少停站数或特定航线来航班。如何实现这一场景?

ListPreference

显然，必须为用户提供UI 来查看排序选项列表。该列表将包含每个选项的单选按钮，而且默认(或当前)选项应该被预先选中。要使用Android首选项框架解决此问题，所做的工作非常之少。首先，创建首选项XML文件来描述首选项，然后使用预先构建的活动类，该类知道如何显示和持久化首选项，下面是我们的首选项XML文件flightoptions.xml 。

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:key="flight_option_preference"
android:title="@string/prefTitle"
android:summary="@string/prefSummary">
<ListPreference
android:key="@string/selected_flight_sort_option"
android:title="@string/listTitle"
android:summary="@string/listSummary"
android:entries="@array/flight_sort_options"
android:entryValues="@array/flight_sort_options_values"
android:dialogTitle="@string/dialogTitle"
android:defaultValue="@string/flight_sort_option_default_value"/>
</PreferenceScreen>

上边说了我们还需要一个Activity类FlightPreferenceActivity，下面使我们的Activity类。这个Activity类继承了PreferenceActivity 代码如下：

Java代码

package xiaohang.zhimeng;
import android.os.Bundle;
import android.preference.PreferenceActivity;
public class FlightPreferenceActivity extends PreferenceActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.flightoptions);
}
}

上面的代码清单，包含了一个表示航班选项示例的首选项设置的XML片段。该包含了一个活动类，也就是我们的FlightPreferenceActivity 这个类主要用于加载我们的XML 文件。首先看一下XML。Android提供了一种端到端得首选项框架。这意味着，该框架支持定义首选项，想用户显示设置，以及将用户选择持久化到数据库存储中。在/res/xml/目录下的XML文件中定义首选项。要向用户显示首选项，编写一个活动类来扩展预定义的 Android类 android.preference.PreferenceActivity，然后使用 addPreferencesFromResource()方法将资源添加到活动的资源集合中。该框架会负责剩余操作(现实和持久化)。

在本航班场景中，在/res/xml/目录下创建文件 flightoptions.xml。然后创建活动类FlightPreferenceActivity, 它扩展了 android.preference.PreferenceActivity类。接下来调用addPreferencesFromResource() 传入R.xml.flightoptions。请注意，首选项资源XML指向多个字符串资源。为了确保正确编译，需要向项目中添加多个字符串资源 (我们稍后介绍)。现在先看一下上面得代码清单会生成什么样子的UI.

上边有两个视图。左边的视图称为首选项屏幕，右边的UI是一个列表首选项。当用户选择 Flight Options时， Choose Flight Options视图将以模态对话框的形式出现，其中包含每个选项的单选按钮。用户选择一个选项之后，将立即该选项并关闭视图。当用户返回选项屏幕时，视图将反映前面保存的选择。

前面已提到，首选项XML 文件和相关的活动类，从上边我们可以看到我们在XML文件中定义了一个PreferenceScreen ,然后创建ListPreference作为子屏幕。对于 PreferenceScreen,设置了3个属性： key、title和 summary。 key 是一个字符串，可用于以编程的方式表示项 (类似于使用 android:id的方式);title 是屏幕的标题 (My Preferences) ; summary是对屏幕用途的描述。对于列表首选项，设置 key、title和 summary，以及 entries、entryValues、dialogTitle和defaultValue特性。下表总结了这些特性。

特性	说明
android:key	选项的名称或键(比如selected_flight_sort_option)
android:title	选项的标题
android:summary	选项的简短摘要
android:entries	可将选项设置成列表项的文本
android:entryValues	定义每个列表项的值。注意：每个列表项有一些文本和一个值。文本由entries定义，值由entryValues定义。
android:dialogTitle	对话框的标题，在视图显示为模态对话框时使用
android:defaultValue	项列表中选项的默认值

为了使我们的例子能够正常运行，我们还需要添加如下文件。

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="flight_sort_options">
<item>Total Cost</item>
<item># of Stops</item>
<item>Airline</item>
</string-array>
<string-array name="flight_sort_options_values">
<item>0</item>
<item>1</item>
<item>2</item>
</string-array>
</resources>

此文件大家一看就知道是定义我们选项的显示的文本，和对应的值。这个XML 文件的名字是 arrays.xml 此文件应该放在 /res/values/arrays.xml

当然不能少了我们的strings.xml

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="hello">Hello World, FlightPreferenceActivity!</string>
<string name="app_name">Preference_Demo</string>
<string name="prefTitle">My Preferences</string>
<string name="prefSummary">Set Flight Option Preferences</string>
<string name="flight_sort_option_default_value">1</string>
<string name="dialogTitle">Choose Flight Options</string>
<string name="listSummary">Set Search Options</string>
<string name="listTitle">Flight Options</string>
<string name="selected_flight_sort_option">selected_flight_sort_option</string>
<string name="menu_prefs_title">Settings</string>
<string name="menu_quit_title">Quit</string>
</resources>

刚才上边说到我们有一个首选项视图，就是那个FlightPreferenceActivity ，在这

这个例子中我们是通过一个菜单跳转到我们的首选项视图的。就是我们有一个MainActivity 这个MainActivity有一个菜单叫Settings当我们点击这个菜单的时候就会跳转到我们的首选项视图了，然后我们修改首选项的内容当我们再一次回到 MainActivity 的时候就会看到我们修改后的文本和值，我们通过一个TextView来显示

我们还是来看一下效果吧。

下面这个XML文件就是用来定义我们这个菜单的，此文件的目录在 /res/menu/mainmenu.xml

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/menu_prefs" android:title="@string/menu_prefs_title" />
<item android:id="@+id/menu_quit" android:title="@string/menu_quit_title" />
</menu>

也比较简单了。

在接下来就是我们的布局文件main.xml了

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="fill_parent"
android:layout_height="fill_parent">
<TextView android:id="@+id/text1" android:layout_width="fill_parent"
android:layout_height="wrap_content" />
</LinearLayout>

只有一个TextView 主要用来显示我们修改首选项之后的文本和值。

有了main.xml自然少不了MainActivity了，下面使我们的MainActivity类

Java代码

package xiaohang.zhimeng;
import android.app.Activity;
import android.content.Intent;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.widget.TextView;
public class MainActivity extends Activity{
private TextView tv = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
tv = (TextView)findViewById(R.id.text1);
setOptionText();
}
//创建菜单，这个菜单我们在XML文件中定义这里加载进来就OK
@Override
public boolean onCreateOptionsMenu(Menu menu) {
MenuInflater inflater = getMenuInflater();
//加载我们的菜单文件
inflater.inflate(R.menu.mainmenu, menu);
return true;
}
//菜单选项事件
@Override
public boolean onOptionsItemSelected(MenuItem item) {
if (item.getItemId() == R.id.menu_prefs) {
//当我们点击 Settings 菜单的时候就会跳转到我们的首选项视图，也就是我们的 FlightPreferenceActivity
Intent intent = new Intent().setClass(this, xiaohang.zhimeng.FlightPreferenceActivity.class);
//因为我们要接收上一个Activity 就是我们的首选项视图返回的数据，所以这里用 startActivityForResult()方法启动我们的首选项视图
//参数一：我们要跳转到哪里
//参数二：回传码
this.startActivityForResult(intent, 0);
}else if (item.getItemId() == R.id.menu_quit) {
//当我们点击Quit菜单退出应用程序
finish();
}
return true;
}
//此方法用来接收我们上一个Activity 也就是我们的首选项视图返回的数据，因为我们可能会修改数据
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
setOptionText();
}
//这个方法就是用来设置我们 MainActivity 上的TextView的值（就是我们首选项的值）
private void setOptionText(){
/*这个方法比较有意思了
* 第一个参数：用来指定我们存储我们首选项值的文件的名称
* 格式就是包名_preferences,大家可以看到我的包名就是xiaohang.zhimeng
* 这里如果你不按照这个格式写比如你不写你当前包名写成别的，也会生成当前包名_preferences 这个文件写或不写它就在那里
* 第二个参数：打开模式
* */
SharedPreferences prefs = getSharedPreferences("xiaohang.zhimeng_preferences", 0);
//这个方法大家去看文档，否则我会越写越乱
String option = prefs.getString(this.getResources().getString(R.string.selected_flight_sort_option), this.getResources().getString(R.string.flight_sort_option_default_value));
//得到我们首选项所有选项的文本
String[] optionText = this.getResources().getStringArray(R.array.flight_sort_options);
//设置我们 TextView要显示的值
tv.setText("option value is " + option + "(" + optionText[Integer.parseInt(option)] + ")");
}
}

如果大家对这里比较陌生，比如 SharedPreferences 是什么东西，可以参考这两篇文章。

http://byandby.iteye.com/blog/837601

http://byandby.iteye.com/blog/833292

在下边就是我们的AndroidManifest.xml文件了，倒也没啥特别的。

Xml代码

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="xiaohang.zhimeng" android:versionCode="1" android:versionName="1.0">
<uses-sdk android:minSdkVersion="10" />
<application android:icon="@drawable/icon" android:label="@string/app_name">
<activity android:name=".MainActivity" android:label="@string/app_name">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity android:name=".FlightPreferenceActivity"
android:label="@string/prefTitle">
<intent-filter>
<action android:name="xiaohang.zhimeng.intent.action.FlightPreferences" />
<category android:name="android.intent.category.PREFERENCE" />
</intent-filter>
</activity>
</application>
</manifest>

OK，当我们完成了上边的所有运行应用程序，首先会看到一个简单的文本消息，显示“option value is 1(# of Stops)”。单击Menu按钮，然后在点击Settings,就会打开我们的首选项视图FlightPreferenceActivity，然后我们更改首选项的值，然后再点击back按钮就会看到我们修改后的值了。

大家可能会问，那Android把我们修改后的数据存储在哪里了呢?前面已经提到Android framework还会负责持久化首选项。例如，当用户选择一个排序选项时，Android会选择存储在应用程序 /data 目录下的一个XML 文件中，见下图。

实际的文件路径为 /data/data/[PACKAGE_NAME]/shared_prefs/[PACKAGE_NAME]_preferences.xml。我们需要看看这个文件里边到底存了些什么? 导出这个文件就可以看到了。哦不对，不用这样太麻烦了，我们去 shell 里边用 cat 读一下就行了，见下图。

一看便知，是以键值对的方式存取

详解Android首选项框架ListPreference相关推荐

Android 首选项框架及PreferenceScreen，PreferenceActivity,PreferenceFragment的用法与分析
前言 <Android 4 高级编程(第3版)>第7章第5节讲到了首选项框架和PreferenceActivity概述等内容,因为第一次见到PreferenceScreen,还没用过,所以 ...
android 首选项框架,Android：创建自定义首选项
婷婷同学_ 这就是我使用支持库的方法preference-v7.扩展 Preference和覆盖onBindViewHolder().此方法使您可以通过ViewHolder对象获取对首选项视图的引用. ...
android mvvm 官方例子,详解Android的MVVM框架 - 数据绑定
本教程是跟着 Data Binding Guide学习过程中得出的一些实践经验,同时修改了官方教程的一些错误,每一个知识点都有对应的源码,争取做到实践与理论相结合. Data Binding 解决了 ...
android ui框架详解,多图详解 “Android UI”设计官方教程(二)
编者注:本文为Android的官方开发者博客发了一份幻灯片的翻译文档的第二部分,专门介绍了一些Android UI设计的小贴士,我们在介绍这个幻灯片的第一部分<多图详解 "Androi ...
详解Android主流框架不可或缺的基石
探索Android软键盘的疑难杂症深入探讨Android异步精髓Handler 详解Android主流框架不可或缺的基石站在源码的肩膀上全解Scroller工作机制 Android多分辨率适配框架 ...
详解 Android 的 Activity 组件
本文详细介绍了 Android 应用编程中 Activity 的生命周期.通信方式和 Intent Filter 等内容,并提供了一些日常开发中经常用到的关于 Activity 的技巧和方法.通过本文 ...
java 自动装载_java_详解Java的Spring框架下bean的自动装载方式，Spring容器可以自动装配相互协 - phpStudy...
详解Java的Spring框架下bean的自动装载方式 Spring容器可以自动装配相互协作bean之间的关系,这有助于减少对XML配置,而无需编写一个大的基于Spring应用程序的较多的和元素. 自 ...
linux沙盒机制6,详解Android应用沙盒机制
前言 Android使用沙盒来保护用户不受恶意应用的侵害,同时也将应用隔离开来,防止他们互相访问其数据,本文主要对Android应用沙盒中的几种技术做简要的总结. 一.Android应用DAC沙盒稍 ...

详解Android首选项框架ListPreference

详解Android首选项框架ListPreference相关推荐

最新文章

热门文章