详解Android应用中preference首选项的编写方法

内容摘要
最近学习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> 

效果图可就大变样了:


代码注释

作者:喵哥笔记

IDC笔记

学的不仅是技术,更是梦想!