详解Android应用中preference首选项的编写方法
作者:chenzheng_java
最近学习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>
效果图可就大变样了: