详解Android应用中preference首选项的编写方法
程序员文章站
2024-02-29 19:58:52
最近学习android时发现，很多书上都介绍了preference首选项这个东西，但是大部分的书都是直接上来讲怎么用，对其的用途和来历都是只字不提，笔者本人对于这种做法是非...
最近学习android时发现，很多书上都介绍了preference首选项这个东西，但是大部分的书都是直接上来讲怎么用，对其的用途和来历都是只字不提，笔者本人对于这种做法是非常鄙视的。
这里，我将对其进行一点简单的描述，可能说法并不严谨，但是至少能帮助你理解到底什么事首选项：
首选项这个词是preference翻译过来的，至于它到底是什么，我用一句话概括下：preference是一种android为我们提供的方便的对数据进行存储的工具。
分析这句话：
首先，我们明确，preference是和数据存储相关的。
其次，它能帮助我们方便的进行数据存储！为什么这个地方一定要强调下方便的这个词呢？原因是，我们可以根本就不使用，我们有另外的n种办法可以实现同样的功能！它的出现，相当于为我们提供了一个方便的工具，当然了，这个工具并不是必须的。
preference都应用在什么场景呢？
这得从android对preference的实现说起，实际上，preference所存储的数据最后都会以xml文件格式的形式进行保存，而且其只能保存一些基本格式的数据。例如string/boolean……。该xml文件存放的位置在data/data/你应用的包名/shared_prefs文件夹下。
种种的限制与实现机制表明了，preference非常适合于参数设置功能。实际上，它也确实是干这个的，我们通过使用preference可以迅速的将某些值保存进xml文件中，然后我们可以读取这些设置信息进行相应的操作。
为了简化与preference相关的应用开发，android为我们提供了一系列的api来帮助我们。主要有preferenceactivity，listpreference,edittextpreference,checkboxpreference,ringtonepreference
下面我们简单的介绍下listpreference的用法：
最终效果图：
当我们点击该选项时，会弹出这样一个选择页面。
我们选择了山东，然后该页面就会自动关闭，并且和山东所对应的值也已经写入了后台的xml文件中。
activity代码：
package cn.com.chenzheng_java.pref;
import android.os.bundle;
import android.preference.listpreference;
import android.preference.preferenceactivity;
import android.preference.preferencemanager;
import android.util.log;
/**
* @description 有关首选项preferences的研究
* @author chenzheng_java
* @since 2011/03/29
* 继承了preferenceactivity我们可以方便的对preference进行操作。
* 例如可以通过getpreferencemanager获取首选项管理器
* 那，我们可不可以不继承preferenceactivity呢？当然可以，你还记得不记得，实际上activity类中
* 就有个sharedpreferences getsharedpreferences(string name, int mode)方法呢，我们通过它
* 也可以对preference进行操作。当然了，如果我们不继承preferenceactivity的话，那么我们就要手动的
* 对数据进行保存了。而不是跟现在一样，会自动的根据你的选择项进行数据保存。
* 那么，preference在这里是怎么样进行自动保存的呢，答案很简单，那就是在addpreferencesfromresource方法的具体实现中！
*/
public class mypreferencesactivity extends preferenceactivity {
@override
public void oncreate(bundle savedinstancestate) {
super.oncreate(savedinstancestate);
addpreferencesfromresource(r.xml.mylistpreference);
/**
* getpreferencemanager返回首选项管理器对象
*/
preferencemanager manager = getpreferencemanager();
// 根据android:key中指定的名称（相当于id）来获取首选项
listpreference listpreference = (listpreference) manager.findpreference("mylistpreference");
log.i("存储的值为", ""+listpreference.getvalue());
}
}
res/xml/mylistperference.xml布局文件
<?xml version="1.0" encoding="utf-8"?> <!-- 对于该文件需要注意以下几点 第一：位置。该文件的位置是在res/xml/下的。 第二：格式，preferencescreen为根标签，listpreference为子标签 第三：标签属性含义 android:key 唯一标识符，和android:id相类似，preferencemanager可以以其为参数通过findpreference获取指定的preference android:title 整个屏幕的标题 android:summary 选项的简单说明 android:entries 弹出的对话框中，列表显示的文本内容，注意哦，这里指定的是一个数组哦 android:entryvalues 与android:entries相对应的值 android:defaultvalue 当对应值不存在时的默认值 android:dialogtitle 弹出的对话框中的标题信息 --> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="screen_list" android:title="标题" android:summary="说明摘要" > <listpreference android:key="mylistpreference" android:title="标题" android:summary="说明摘要" android:entries="@array/list_entries" android:entryvalues="@array/list_entries_value" android:dialogtitle="dialogtitle" android:defaultvalue="@array/list_entries_value2" ></listpreference> </preferencescreen>
res/values/arrays.xml为我们的list提供了初始化数据哦
<?xml version="1.0" encoding="utf-8"?> <resources> <string-array name="list_entries"> <item>山东</item> <item>福建</item> <item>北京</item> <item>河北</item> </string-array> <string-array name="list_entries_value"> <item>shandong1</item> <item>fujian1</item> <item>beijing1</item> <item>hebei1</item> </string-array> <string-array name="list_entries_value2"> <item>shandong2</item> <item>fujian2</item> <item>beijing2</item> <item>hebei2</item> </string-array> </resources>
当我们运行，并选择了福建时，我们可以查看在shared_prefes下的xml文件如下：
<?xml version='1.0' encoding='utf-8' standalone='yes' ?> <map> <string name="mylistpreference">fujian1</string> </map>
我们可以看到，mylistpreference就是我们指定的那个android:key的值，而fujian1就是我们在arrays中定义的某个值！
edittextpreference：
效果图：
当我们点击主页面的输入名称时，就会弹出该对话框，让我们输入名称。
代码：
<?xml version="1.0" encoding="utf-8"?> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="屏幕标题" android:summary="屏幕简要说明" > <edittextpreference android:dialogtitle="输入您的名称：" android:key="edittitlepreference" android:summary="简要说明" android:title="输入名称" ></edittextpreference> </preferencescreen>
ringtonepreference:
效果图
代码：
<?xml version="1.0" encoding="utf-8"?> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="屏幕标题" android:summary="屏幕简要说明" > <!-- android:ringtonetype 设置响铃模式，主要包括ringtone、notification、alarm、all android:showsilent 是否显示静音 注意，如果模拟器中没有铃声的话，我们可以自己添加。将音乐复制到sd卡上，然后转到android media player应用程序，选择该音乐， 单击menu，然后选择 uses as ringtone --> <ringtonepreference android:key="ringtonepreference" android:summary="简要说明" android:title="选择系统铃声" android:ringtonetype="alarm" android:showsilent="true" ></ringtonepreference> </preferencescreen>
我们看看后台的xml中是如何存储的
<?xml version='1.0' encoding='utf-8' standalone='yes' ?> <map> <string name="ringtonepreference">content://settings/system/alarm_alert</string> </map>
这里我们可要注意了哦，ringtonepreference的值是一个uri字符串。
组织首选项
何谓组织首选项啊，实际上就是为首选项分组！
分组之后，我们首页只显示组名，当我们点击进去的时候，才会显示具体的首选项列表。如图：
代码：
<?xml version="1.0" encoding="utf-8"?> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="屏幕标题" android:summary="屏幕简要说明" > <!-- 第一组 --> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第一组" android:summary="点击进入第一组首选项" > <ringtonepreference android:key="ringtonepreference" android:summary="简要说明" android:title="选择系统铃声" android:ringtonetype="alarm" android:showsilent="true" > </ringtonepreference> </preferencescreen> <!-- 第二组 --> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第二组" android:summary="点击进入第二组首选项" > <edittextpreference android:dialogtitle="输入您的名称：" android:key="edittitlepreference" android:summary="简要说明" android:title="输入名称" ></edittextpreference> </preferencescreen> <!-- 第三组 --> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第三组" android:summary="点击进入第三组首选项" > <edittextpreference android:dialogtitle="输入您的名称：" android:key="edittitlepreference" android:summary="简要说明" android:title="输入名称" ></edittextpreference> </preferencescreen> </preferencescreen>
以上的这种方法适合首选项的数目较多时使用。
如果我们首选项的数目较少，但是我们依旧想为他们分组下，怎么办呢？
我们可以将上面代码中的嵌套preferencescreen改为preferencecategory，就这么简单！！！
<?xml version="1.0" encoding="utf-8"?> <preferencescreen xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="屏幕标题" android:summary="屏幕简要说明" > <!-- 第一组 --> <preferencecategory xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第一组" android:summary="点击进入第一组首选项" > <ringtonepreference android:key="ringtonepreference" android:summary="简要说明" android:title="选择系统铃声" android:ringtonetype="alarm" android:showsilent="true" > </ringtonepreference> </preferencecategory> <!-- 第二组 --> <preferencecategory xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第二组" android:summary="点击进入第二组首选项" > <edittextpreference android:dialogtitle="输入您的名称：" android:key="edittitlepreference" android:summary="简要说明" android:title="输入名称" ></edittextpreference> </preferencecategory> <!-- 第三组 --> <preferencecategory xmlns:android="http://schemas.android.com/apk/res/android" android:key="edittext_screen" android:title="第三组" android:summary="点击进入第三组首选项" > <edittextpreference android:dialogtitle="输入您的名称：" android:key="edittitlepreference" android:summary="简要说明" android:title="输入名称" ></edittextpreference> </preferencecategory> </preferencescreen>
效果图可就大变样了：