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

ListPreference
显然,必须为用户提供UI 来查看排序选项列表。该列表将包含每个选项的单选按钮,而且默认(或当前)选项应该被预先选中。要使用Android首选项框架解决此问题,所做的工作非常之少。首先,创建首选项XML文件来描述首选项,然后使用预先构建的活动类,该类知道如何显示和持久化首选项,下面是我们的首选项 XML 文件flightoptions.xml 。
Xml代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <PreferenceScreen
  3. xmlns:android="http://schemas.android.com/apk/res/android"
  4. android:key="flight_option_preference"
  5. android:title="@string/prefTitle"
  6. android:summary="@string/prefSummary">
  7. <ListPreference
  8. android:key="@string/selected_flight_sort_option"
  9. android:title="@string/listTitle"
  10. android:summary="@string/listSummary"
  11. android:entries="@array/flight_sort_options"
  12. android:entryValues="@array/flight_sort_options_values"
  13. android:dialogTitle="@string/dialogTitle"
  14. android:defaultValue="@string/flight_sort_option_default_value"/>
  15. </PreferenceScreen>


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

Java代码 收藏代码
  1. packagexiaohang.zhimeng;
  2. importandroid.os.Bundle;
  3. importandroid.preference.PreferenceActivity;
  4. publicclassFlightPreferenceActivityextendsPreferenceActivity{
  5. @Override
  6. protectedvoidonCreate(BundlesavedInstanceState){
  7. super.onCreate(savedInstanceState);
  8. addPreferencesFromResource(R.xml.flightoptions);
  9. }
  10. }


上面的代码清单 包含了一个表示航班选项示例的首选项设置的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.

android 探索首选项框架 ListPreference_第1张图片

android 探索首选项框架 ListPreference_第2张图片

上边有两个视图。左边的视图称为首选项屏幕,右边的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代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <resources>
  3. <string-arrayname="flight_sort_options">
  4. <item>TotalCost</item>
  5. <item>#ofStops</item>
  6. <item>Airline</item>
  7. </string-array>
  8. <string-arrayname="flight_sort_options_values">
  9. <item>0</item>
  10. <item>1</item>
  11. <item>2</item>
  12. </string-array>
  13. </resources>

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

当然不能少了 我们的strings.xml
Xml代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <resources>
  3. <stringname="hello">HelloWorld,FlightPreferenceActivity!</string>
  4. <stringname="app_name">Preference_Demo</string>
  5. <stringname="prefTitle">MyPreferences</string>
  6. <stringname="prefSummary">SetFlightOptionPreferences</string>
  7. <stringname="flight_sort_option_default_value">1</string>
  8. <stringname="dialogTitle">ChooseFlightOptions</string>
  9. <stringname="listSummary">SetSearchOptions</string>
  10. <stringname="listTitle">FlightOptions</string>
  11. <stringname="selected_flight_sort_option">selected_flight_sort_option</string>
  12. <stringname="menu_prefs_title">Settings</string>
  13. <stringname="menu_quit_title">Quit</string>
  14. </resources>


刚才上边说到我们有一个首选项视图,就是那个FlightPreferenceActivity ,在这
这个例子中我们是通过 一个菜单跳转到 我们的首选项视图的。就是 我们有一个 MainActivity 这个 MainActivity有一个菜单 叫 Settings 当我们点击这个菜单的时候就会跳转到我们的首选项视图了,然后我们修改 首选项的内容 当我们再一次回到 MainActivity 的时候就会看到我们修改后的 文本和值,我们通过一个TextView来显示
我们还是来看一下效果吧。

android 探索首选项框架 ListPreference_第3张图片

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

Xml代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <menuxmlns:android="http://schemas.android.com/apk/res/android">
  3. <itemandroid:id="@+id/menu_prefs"android:title="@string/menu_prefs_title"/>
  4. <itemandroid:id="@+id/menu_quit"android:title="@string/menu_quit_title"/>
  5. </menu>

也比较 简单了。

在接下来就是我们的 布局文件 main.xml了
Xml代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
  3. android:orientation="vertical"android:layout_width="fill_parent"
  4. android:layout_height="fill_parent">
  5. <TextViewandroid:id="@+id/text1"android:layout_width="fill_parent"
  6. android:layout_height="wrap_content"/>
  7. </LinearLayout>

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

有了main.xml自然少不了 MainActivity了, 下面使我们的 MainActivity类
Java代码 收藏代码
  1. packagexiaohang.zhimeng;
  2. importandroid.app.Activity;
  3. importandroid.content.Intent;
  4. importandroid.content.SharedPreferences;
  5. importandroid.os.Bundle;
  6. importandroid.view.Menu;
  7. importandroid.view.MenuInflater;
  8. importandroid.view.MenuItem;
  9. importandroid.widget.TextView;
  10. publicclassMainActivityextendsActivity{
  11. privateTextViewtv=null;
  12. @Override
  13. protectedvoidonCreate(BundlesavedInstanceState){
  14. super.onCreate(savedInstanceState);
  15. setContentView(R.layout.main);
  16. tv=(TextView)findViewById(R.id.text1);
  17. setOptionText();
  18. }
  19. //创建菜单,这个菜单我们在XML文件中定义这里加载进来就OK
  20. @Override
  21. publicbooleanonCreateOptionsMenu(Menumenu){
  22. MenuInflaterinflater=getMenuInflater();
  23. //加载我们的菜单文件
  24. inflater.inflate(R.menu.mainmenu,menu);
  25. returntrue;
  26. }
  27. //菜单选项事件
  28. @Override
  29. publicbooleanonOptionsItemSelected(MenuItemitem){
  30. if(item.getItemId()==R.id.menu_prefs){
  31. //当我们点击Settings菜单的时候就会跳转到我们的首选项视图,也就是我们的FlightPreferenceActivity
  32. Intentintent=newIntent().setClass(this,xiaohang.zhimeng.FlightPreferenceActivity.class);
  33. //因为我们要接收上一个Activity就是我们的首选项视图返回的数据,所以这里用startActivityForResult()方法启动我们的首选项视图
  34. //参数一:我们要跳转到哪里
  35. //参数二:回传码
  36. this.startActivityForResult(intent,0);
  37. }elseif(item.getItemId()==R.id.menu_quit){
  38. //当我们点击Quit菜单退出应用程序
  39. finish();
  40. }
  41. returntrue;
  42. }
  43. //此方法用来接收我们上一个Activity也就是我们的首选项视图返回的数据,因为我们可能会修改数据
  44. @Override
  45. protectedvoidonActivityResult(intrequestCode,intresultCode,Intentdata){
  46. super.onActivityResult(requestCode,resultCode,data);
  47. setOptionText();
  48. }
  49. //这个方法就是用来设置我们MainActivity上的TextView的值(就是我们首选项的值)
  50. privatevoidsetOptionText(){
  51. /*这个方法比较有意思了
  52. *第一个参数:用来指定我们存储我们首选项值的文件的名称
  53. *格式就是包名_preferences,大家可以看到我的包名就是xiaohang.zhimeng
  54. *这里如果你不按照这个格式写比如你不写你当前包名写成别的,也会生成当前包名_preferences这个文件写或不写它就在那里
  55. *第二个参数:打开模式
  56. **/
  57. SharedPreferencesprefs=getSharedPreferences("xiaohang.zhimeng_preferences",0);
  58. //这个方法大家去看文档,否则我会越写越乱
  59. Stringoption=prefs.getString(this.getResources().getString(R.string.selected_flight_sort_option),this.getResources().getString(R.string.flight_sort_option_default_value));
  60. //得到我们首选项所有选项的文本
  61. String[]optionText=this.getResources().getStringArray(R.array.flight_sort_options);
  62. //设置我们TextView要显示的值
  63. tv.setText("optionvalueis"+option+"("+optionText[Integer.parseInt(option)]+")");
  64. }
  65. }


如果大家对这里比较陌生,比如 SharedPreferences 是神马东西,可以参考这 两篇文章。
http://byandby.iteye.com/blog/837601 http://byandby.iteye.com/blog/833292

在下边就是我们的AndroidManifest.xml文件了,倒也没啥特别的。
Xml代码 收藏代码
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <manifestxmlns:android="http://schemas.android.com/apk/res/android"
  3. package="xiaohang.zhimeng"android:versionCode="1"android:versionName="1.0">
  4. <uses-sdkandroid:minSdkVersion="10"/>
  5. <applicationandroid:icon="@drawable/icon"android:label="@string/app_name">
  6. <activityandroid:name=".MainActivity"android:label="@string/app_name">
  7. <intent-filter>
  8. <actionandroid:name="android.intent.action.MAIN"/>
  9. <categoryandroid:name="android.intent.category.LAUNCHER"/>
  10. </intent-filter>
  11. </activity>
  12. <activityandroid:name=".FlightPreferenceActivity"
  13. android:label="@string/prefTitle">
  14. <intent-filter>
  15. <actionandroid:name="xiaohang.zhimeng.intent.action.FlightPreferences"/>
  16. <categoryandroid:name="android.intent.category.PREFERENCE"/>
  17. </intent-filter>
  18. </activity>
  19. </application>
  20. </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_第4张图片

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

更多相关文章

  1. 【Android软件】ES文件浏览器:Android资源管理器
  2. [置顶] Android本地文件管理器思路解析一一增删改查具体实现
  3. AS下如何生成自定义的.jks签名文件, 以及如何生成数字签名
  4. 详解Android首选项框架的使用
  5. 【Android自学笔记】对应资源文件夹中的图标尺寸
  6. Android 查看/data/data文件夹并取回文件
  7. Android中解析与创建XML文件
  8. Android中读取properties文件2

随机推荐

  1. js简单判断移动端系统的方法
  2. Android(安卓)Accessibility使用及事件流
  3. Android从相册选择一个图片、剪切、上传
  4. 使用onNewIntent实现startActivityForRes
  5. Android(安卓)消息传递机制 - Looper/Han
  6. 垂直的SeekBar
  7. 38. Android(安卓)反射资源工具Reflectio
  8. registerContentObserver回调两次,Content
  9. Android混淆代码proguard,内存溢出
  10. android实现PC到手机的SOCKET通信