在Android系统中,当我们点击一个Menu时,在弹出的菜单中往往会有一个设置按钮,点击“设置”后,会弹出的设置界面。而系统中的设置界面就是由我们这里说的PreferenceActivity来实现的,PreferenceActivity通过SharedPreference键值对的形式来自动保存数据,不需要我们手动来写,省去一大波操作。
费话不多说,先来开撸一个
实现一个PreferenceActivity示例
1.布局文件
setting_preference.xml
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android">
<PreferenceCategory android:title="分组显示">
<CheckBoxPreference android:title="开启声音" android:key="open_sound" android:summary="当有新消息通知时播放声音提示" android:defaultValue="true" />
<SwitchPreference android:title="控制开关" />
<PreferenceScreen android:title="点击操作" android:key="xxx">
</PreferenceScreen>
<PreferenceScreen android:title="跳转页面">
<intent android:targetPackage="com.yy.testpreferences" android:targetClass="com.yy.testpreferences.SkinActivity" />
</PreferenceScreen>
</PreferenceCategory>
<PreferenceCategory android:title="辅助功能">
<EditTextPreference android:key="number_edit" android:title="输入电话号码"/>
<!--单选-->
<ListPreference
android:key="depart_value"
android:title="类别设置"
android:dialogTitle="选择类别"
android:entries="@array/cates"
android:entryValues="@array/cates_value">
</ListPreference>
<!--多选-->
<MultiSelectListPreference
android:key="abc"
android:entries="@array/days"
android:entryValues="@array/day_value"
android:title="重复"
android:summary="无"
/>
<RingtonePreference
android:key="ring_key"
android:title="铃声选择"
android:ringtoneType="all"
android:showDefault="true"
android:showSilent="true">
</RingtonePreference>
</PreferenceCategory>
</PreferenceScreen>
2.新建一个PreferenceActivity
package com.yy.testpreferences;
import android.content.Intent;
import android.media.Ringtone;
import android.media.RingtoneManager;
import android.net.Uri;
import android.os.Bundle;
import android.preference.CheckBoxPreference;
import android.preference.ListPreference;
import android.preference.Preference;
import android.preference.PreferenceActivity;
import android.preference.PreferenceManager;
import android.preference.RingtonePreference;
import android.text.TextUtils;
@SuppressWarnings("deprecation")
public class MainActivity extends PreferenceActivity implements Preference.OnPreferenceClickListener{
private Preference pref_share;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.setting_preference);
//通过key得到界面上的Preference
pref_share=(Preference) findPreference("xxx");
pref_share.setOnPreferenceClickListener(this);
// 输入选择的值显示出来
bindPreferenceSummaryToValue(findPreference("number_edit"));
bindPreferenceSummaryToValue(findPreference("depart_value"));
//把输入的值显示出来
/* Preference pref = findPreference("number_edit");
pref.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener(){
@Override
public boolean onPreferenceChange(Preference pref, Object arg1) {
pref.setSummary(arg1.toString());
return true;
}
});*/
}
/**
* 点击后触发分享
*/
@Override
public boolean onPreferenceClick(Preference preference) {
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_SUBJECT, "分享");
intent.putExtra(Intent.EXTRA_TEXT, "share content");
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(Intent.createChooser(intent, getTitle()));
return true;
}
/**
* bindPreferenceSummaryToValue 拷贝至as自动生成的preferences的代码,用于绑定显示实时值
*/
private static Preference.OnPreferenceChangeListener sBindPreferenceSummaryToValueListener = new Preference.OnPreferenceChangeListener() {
@Override
public boolean onPreferenceChange(Preference preference, Object value) {
String stringValue = value.toString();
if (preference instanceof ListPreference) {
// For list preferences, look up the correct display value in
// the preference's 'entries' list.
ListPreference listPreference = (ListPreference) preference;
int index = listPreference.findIndexOfValue(stringValue);
// Set the summary to reflect the new value.
preference.setSummary(
index >= 0
? listPreference.getEntries()[index]
: null);
} else if (preference instanceof RingtonePreference) {
// For ringtone preferences, look up the correct display value
// using RingtoneManager.
if (TextUtils.isEmpty(stringValue)) {
// Empty values correspond to 'silent' (no ringtone).
preference.setSummary(R.string.pref_ringtone_silent);
} else {
Ringtone ringtone = RingtoneManager.getRingtone(
preference.getContext(), Uri.parse(stringValue));
if (ringtone == null) {
// Clear the summary if there was a lookup error.
preference.setSummary(null);
} else {
// Set the summary to reflect the new ringtone display
// name.
String name = ringtone.getTitle(preference.getContext());
preference.setSummary(name);
}
}
} else {
// For all other preferences, set the summary to the value's
// simple string representation.
preference.setSummary(stringValue);
}
return true;
}
};
private static void bindPreferenceSummaryToValue(Preference preference) {
// Set the listener to watch for value changes.
preference.setOnPreferenceChangeListener(sBindPreferenceSummaryToValueListener);
// Trigger the listener immediately with the preference's
// current value.
sBindPreferenceSummaryToValueListener.onPreferenceChange(preference,
PreferenceManager
.getDefaultSharedPreferences(preference.getContext())
.getString(preference.getKey(), ""));
}
}
3.列表中用到的数组定义
array.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="cates">
<item>酒店</item>
<item>商超</item>
<item>酒水专卖</item>
</string-array>
<string-array name="cates_value">
<item>001</item>
<item>002</item>
<item>003</item>
</string-array>
<string-array name="days">
<item>周一</item>
<item>周二</item>
<item>周三</item>
<item>周四</item>
<item>周五</item>
<item>周六</item>
<item>周日</item>
</string-array>
<string-array name="day_value">
<item>1</item>
<item>2</item>
<item>4</item>
<item>8</item>
<item>16</item>
<item>32</item>
<item>64</item>
</string-array>
</resources>
Preference 布局属性
通用的xml 布局属性
在preference布局文件中,我们可以会经常用到下面的属性,这些属性都是preference控件相互通用的。
android:key
这个属性相当于android:id的作用。用此key来唯一表示此Preference
android:title
Preference的标题,
android:summary
表示Preference提示语,相对于android:title来说显示要小点,而且显示位置在android:title下面
android:defaultValue
这个表示的是默认值,比如CheclPreference这种preference就可以指定默认是"true"还是“false”
android:enabled
表示该Preference是否可用状态
CheckBoxPreference
android:summaryOn
在选择显示的summary
android:summaryOff
在不选择显示的summary
ListPreference属性
android:dialogTitle
弹出对话框的标题
android:entries
列表中显示的值。为一个数组,通读通过资源文件进行设置。
android:entryValues
列表中实际保存的值,也entries对应。为一个数组,通读通过资源文件进行设置
RingtonePreference 属性分析
android:showDefault
是否在列表中显示“默认”选项
android:showSilent
是否显示“静音”选项
android:ringtoneType
铃音类型,可能值包括 ringtone、notification、alarm和all
数据的保存与读取
Android系统会将Preference元素的值存储在sharedPreference文件中。该文件存放路径data/data/[packgename]/shared_prefs/文件下,命名约定为:packagename_preference.xml
那么我们要如何去获取这些已经保存的数据呢?首先我们要通过xml中的key获取数值,就是Preference控件中android:key
所对应的属性(已一个键值对的形式保存,name为Preference的key值,value为Preference的value值),读取方法如下:
SharedPreferences prefs =PreferenceManager.getDefaultSharedPreferences(this) ;
//open_sound是给Preference元素设置的key
Log.i(TAG, "open_sound="+prefs.getBoolean("open_sound",false));
使用的方法都很简单,代码注释都很清楚了。
关于Preference需要说明的是:
- 如果app是针对11以上的,推荐使用AppCompatActivity和PreferenceFragment来实现。
- 如果兼容更早的版本,需要借助AppCompatDelegate来实现,Google的示例代码:AppCompatPreferenceActivity.java