欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

详解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的用法:

最终效果图:

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

当我们点击该选项时,会弹出这样一个选择页面。

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

我们选择了山东,然后该页面就会自动关闭,并且和山东所对应的值也已经写入了后台的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:

效果图:

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

当我们点击主页面的输入名称时,就会弹出该对话框,让我们输入名称。

代码:

<?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:

效果图

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

代码:

<?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> 

效果图可就大变样了:

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