详解Android首选项框架的使用实例
更新时间：2016年11月16日 16:43:47 作者：liuhe688
首选项这个名词对于熟悉Android的朋友们一定不会感到陌生，它经常用来设置软件的运行参数。本篇文章主要介绍详解Android首选项框架的使用实例，有兴趣的可以了解一下。
首选项这个名词对于熟悉Android的朋友们一定不会感到陌生，它经常用来设置软件的运行参数。
Android提供了一种健壮并且灵活的框架来处理首选项。它提供了简单的API来隐藏首选项的读取和持久化，并且提供了一个优雅的首选项界面。
首先，我们来看下面这款软件的首选项界面：
这款软件使用了好几种类型的首选项，每一种首选项都有其独特的用法，下面我们来了解一下几种常见的首选项：
- CheckBoxPreference：用来打开或关闭某个功能
- ListPreference：用来从多个选项中选择一个值；
- EditTextPreference：用来配置一段文字信息；
- Preference：用来执行相关的自定义操作(上图中的清除缓存、历史记录、表单、cookie都属于此项)；
- RingtonePreference：专门用来为用户设置铃声。
当我们使用首选项框架时，用户每更改一项的值后，系统就会立即在/data/data/[PACKAGE_NAME]/shared_prefs下生成一个[PACKAGE_NAME]_preferences.xml的文件，文件会记录最新的配置信息。
那么如何使用首选想框架呢？我们需要以下几步操作：
1.建立一个首选项的xml配置文件，放在项目的/res/xml目录下面；
2.新建一个Activity，继承android.preference.PreferenceActivity，然后在onCreate方法中加载我们的首选项配置文件。
下面，我就为大家演示一下首选项框架的配置和使用：
我们新建一个prefs项目，项目结构如下：
我们要实现的功能跟上面那款软件的很相似，下面我来说明一下这个项目的整体流程：
1.主界面。显示用户昵称，有三个参数，昵称文字、字体大小和背景颜色。首次进入时，使用默认值。
2.按下menu键中的settings项，跳转到首选项页面，进行参数选择。
3.按下返回键，返回主界面，设定后的参数生效。
首先，让我们来看一下主界面的配置文件，非常简单，就一个TextView：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent">
<TextView
android:id="@+id/textView"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:gravity="center_horizontal"
android:textColor="#FF0000"/>
</LinearLayout>
然后，我们需要在主界面里根据配置参数设置TextView的外观以及背景，MainActivity.java代码如下：
package com.scott.prefs;
import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.content.SharedPreferences;
import android.graphics.Color;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.TextView;
public class MainActivity extends Activity {
private static final int SETTINGS_ID = 0;
private static final int EXIT_ID = 1;
private TextView textView;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
textView = (TextView) findViewById(R.id.textView);
showSettings();
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
super.onCreateOptionsMenu(menu);
menu.add(0, SETTINGS_ID, 0, "Settings");
menu.add(0, EXIT_ID, 0, "Quit");
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
if (item.getItemId() == SETTINGS_ID) {
Intent intent = new Intent(MainActivity.this, PrefsActivity.class);
//如果requestCode >= 0 则返回结果时会回调 onActivityResult()方法
startActivityForResult(intent, 1);
} else {
finish();
}
return true;
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
showSettings();
}
private void showSettings() {
String prefsName = getPackageName() + "_preferences"; //[PACKAGE_NAME]_preferences
SharedPreferences prefs = getSharedPreferences(prefsName, Context.MODE_PRIVATE);
String nickName = prefs.getString("nickName", "机器人");
textView.setText("欢迎您：" + nickName);
boolean nightMode = prefs.getBoolean("nightMode", false);
textView.setBackgroundColor(nightMode ? Color.BLACK : Color.WHITE);
String textSize = prefs.getString("textSize", "0");
if (textSize.equals("0")) {
textView.setTextSize(18f);
} else if (textSize.equals("1")) {
textView.setTextSize(22f);
} else if (textSize.equals("2")) {
textView.setTextSize(36f);
}
}
}
可以看到，进入主界面之后会根据[PACKAGE_NAME]_preferences获取首选项配置信息，如果是首次进入，则使用默认值，下面就是我们首次进入主界面时的画面：
可以看到，我们初次进入的界面时昵称为“机器人”，字的背景为白色，字的大小为18号。
然后按下Settings之后，我们就可以进行首选项的配置了，让我们先来看一下settings.xml的配置：
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
android:key="settings"
android:title="软件设置">
<PreferenceCategory
android:key="basic"
android:title="基本设置">
<EditTextPreference
android:key="nickName"
android:title="昵称"
android:defaultValue="机器人"/>
<CheckBoxPreference
android:key="nightMode"
android:title="夜间模式"
android:summaryOn="已启用"
android:summaryOff="未启用"/>
<ListPreference
android:key="textSize"
android:title="文字大小"
android:dialogTitle="文字大小"
android:entries="@array/textSize_entry"
android:entryValues="@array/textSize_entry_value"
android:defaultValue="0"/>
</PreferenceCategory>
<PreferenceCategory
android:key="clean"
android:title="清除记录">
<Preference
android:key="cleanHistory"
android:title="清除历史记录" />
</PreferenceCategory>
</PreferenceScreen>
其中，最外层是PreferenceScreen标签，代表一系列首选项的集合；然后，我们注意到PreferenceCategory这一项，此标签代表一个类别，可以包含多个首选项；最后就是我们用于配置参数的首选项了。需要了解的是，PreferenceScreen也可以嵌套使用，也就是说上面的PreferenceCategory可以替换成PreferenceScreen。
此外，我们还需要了解一下文件中出现的几个常用标签属性：
- android:key 选项的名称或键
- android:title 选项的标题
- android:summary 选项的简短摘要
- android:entries 列表项的文本
- android:entryValues 列表中每一项的值
- android:dialogTitle 对话框标题
- android:defalutValue 列表中选项的默认值
- 对于CheckBoxPreference还有两个特殊的属性
- android:summaryOn 选项被选中时显示的摘要
- android:summaryOff 选项未选中时显示的摘要
我们还可以看到，在ListPreference中，entries来自于textSize_entry，而entryValues来自于textSize_entry_value，这两项都在/res/values目录下的text_size.xml配置：
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="textSize_entry">
<item>小</item>
<item>中</item>
<item>大</item>
</string-array>
<string-array name="textSize_entry_value">
<item>0</item>
<item>1</item>
<item>2</item>
</string-array>
</resources>
配置完成之后，我们就剩下最后一步了，创建Activity，继承PreferenceActivity，加载首选项资源文件，处理相应的选项事件。
PrefsActivity.Java代码如下：
package com.scott.prefs;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.os.Bundle;
import android.preference.EditTextPreference;
import android.preference.ListPreference;
import android.preference.Preference;
import android.preference.PreferenceActivity;
import android.preference.PreferenceScreen;
import android.widget.Toast;
public class PrefsActivity extends PreferenceActivity implements Preference.OnPreferenceChangeListener {
private EditTextPreference nickName;
private ListPreference textSize;
private Preference cleanHistory;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.setttings);
nickName = (EditTextPreference) findPreference("nickName");
textSize = (ListPreference) findPreference("textSize");
cleanHistory = findPreference("cleanHistory");
//为nickName和textSize注册Preference.OnPreferenceChangeListener监听事件
//当值更改时我们可以立即更新summary
nickName.setOnPreferenceChangeListener(this);
textSize.setOnPreferenceChangeListener(this);
initSummary();
}
//初始化summary
private void initSummary() {
nickName.setSummary(nickName.getText());
setTextSizeSummary(textSize.getValue());
}
private void setTextSizeSummary(String textSizeValue) {
if (textSizeValue.equals("0")) {
textSize.setSummary("小");
} else if (textSizeValue.equals("1")) {
textSize.setSummary("中");
} else if (textSizeValue.equals("2")) {
textSize.setSummary("大");
}
}
/**
* 重写PreferenceActivity的onPreferenceTreeClick方法
* 在首选项被点击时 做出相应处理操作
*/
@Override
public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) {
if (preference == cleanHistory) {
new AlertDialog.Builder(this)
.setTitle("清除历史记录")
.setMessage("是否真的要清除历史记录？")
.setPositiveButton("是", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
//cleaning history...
Toast.makeText(PrefsActivity.this, "清除成功", Toast.LENGTH_SHORT).show();
}
}).setNegativeButton("否", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
}).create().show();
}
return true;
}
/**
* 重写Preference.OnPreferenceChangeListener的onPreferenceChange方法
* 当首选项的值更改时 做出相应处理操作
*/
@Override
public boolean onPreferenceChange(Preference preference, Object newValue) {
if (preference == nickName) {
nickName.setSummary(newValue.toString());
} else if (preference == textSize) {
setTextSizeSummary(newValue.toString());
}
return true;
}
}
最后，别忘了在AndroidManifest.xml中加入此Activity配置信息：
<activity android:name=".PrefsActivity"/>
当然我们也可以配置一下<intent-filter></intent-filter>属性。
经过以上几步，我们的首选项配置就完成了，首次进入的界面如下：
然后我们分别更改昵称、夜间模式、文字大小，如下：
可以看到，当我们更改了选项的值之后，摘要部分已经设置为最新值了，此时在我们应用下的shared_prefs目录中生成一个com.scott.prefs_preferences.xml文件，如图：
内容如下：
<?xml version='1.0' encoding='utf-8' standalone='yes' ?> <map> <boolean name="nightMode" value="true" /> <string name="nickName">scott</string> <string name="textSize">2</string> </map>
此时，我们按回退键，回到主界面，发现刚才的设置已经生效了：
可以看到，昵称已经更改成“scott”，字的背景已更改为黑色，字的大小已更改为36号。
如果我们在首选项界面按下清除历史记录一项，将会出现一下界面：
原文链接：http://blog.csdn.net/liuhe688/article/details/6448423
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。
您可能感兴趣的文章:
- android底部弹出iOS7风格对话选项框(QQ对话框)--第三方开源之IOS_Dialog_Library
- android PopupWindow 和 Activity弹出窗口实现方式
- android 弹出提示框的使用(图文实例)
- android实现百度地图自定义弹出窗口功能
- android弹出activity设置大小的方法
- Android实现弹出键盘的方法
- android 对话框弹出位置和透明度的设置具体实现方法
- Android实现可输入数据的弹出框
- Android弹出窗口实现方法
- Android百度地图实现搜索和定位及自定义图标绘制并点击时弹出泡泡
- Android实现弹出登陆框的方案
- Android编程单选项框RadioGroup综合应用示例
- Android编程实现长按弹出选项框View进行操作的方法
相关文章
Android系统有五种数据存储形式，分别是文件存储、SP存储、数据库存储、contentprovider 内容提供者、网络存储。本篇文章详解的介绍了每种数据存储的用法，有兴趣的可以了解一下。2016-12-12
这篇文章主要为大家详细介绍了android开机自动启动app的解决方法，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-05-05
本篇文章是对在Android中dp和px之间进行转换的实现方法进行了分析介绍，需要的朋友参考下2013-05-05
为了追求更好的用户体验，有时候我们需要一个类似心跳一样跳动着的控件来吸引用户的注意力。本文将利用Flutter实现这一动画特效，需要的可以参考一下2022-04-04
Android使用MediaCodec将摄像头采集的视频编码为h264
这篇文章主要为大家详细介绍了Android使用MediaCodec将摄像头采集的视频编码为h264，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-10-10
Android之IphoneTreeView带组指示器的ExpandableListView效果
在正在显示的最上面的组的标签位置添加一个和组视图完全一样的视图，作为组标签。这个标签的位置要随着列表的滑动不断变化，以保持总是显示在最上方，并且该消失的时候就消失2013-06-06
native.js获取手机硬件基本信息实例代码android版
本文为大家分享了native.js获取手机硬件基本信息实例代码android版包括手机MAC地址,手机内存大小,手机存储空间大小,手机CPU信息等手机硬件基本信息2018-09-09
Android编程实现横竖屏切换时不销毁当前activity和锁定屏幕的方法
这篇文章主要介绍了Android编程实现横竖屏切换时不销毁当前activity和锁定屏幕的方法,涉及Android属性设置及activity操作的相关技巧,需要的朋友可以参考下2015-11-11
在 Android 开发中,网络请求是一个极为关键的部分,Retrofit 作为一个强大的网络请求库,能够简化开发流程,提供高效的网络请求能力,本文将深入介绍 Retrofit 的高级使用与原理,帮助读者更全面地理解和应用这一库,需要的朋友可以参考下2023-08-08
本文将详细讲解如何使用AsyncTask来实现多线程的断点续传下载功能，感兴趣的朋友跟随脚本之家小编一起学习吧2018-05-05
最新评论