android的PreferenceActivity

前言

　　这段时间在研究android平台上的开源项目——StandupTimer，这是由jwood所设计的一个较为简单android应用，用于控制会议时间，类似秒表倒计时。

PreferenceActivity

　　PreferenceActivity是android提供的对系统信息和配置进行自动保存的Activity,它通过 SharedPreference方式将信息保存在XML 文件当中。使用PreferenceActivity不需要我们对SharedPreference进行操作，系统会自动对Activity 的各种View上的改变进行保存（这个真是太赞了！）。

　　在android项目中添加一个 android xml 文件需要注意的是这次选择的是 Preference。而不是以往的Layout

这个文件是保存在 res /xml 路径下的。

PreferenceScreen xml

　　preference下的View是有限的，只有下面几个：

• CheckBoxPreference:CheckBox选择项，对应的值的ture或flase
• EditTextPreference:输入编辑框，值为String类型，会弹出对话框供输入。
• ListPreference: 列表选择，弹出对话框供选择。
• Preference：只进行文本显示，需要与其他进行组合使用。
• PreferenceCategory：用于分组。
• RingtonePreference：系统玲声选择

更多关于 PreferenceScreen的介绍可以查看博客园上的一篇文章： Android之PreferenceActivity

 

<? xml version="1.0" encoding="utf-8" ?>
< PreferenceScreen xmlns:android ="http://schemas.android.com/apk/res/android" >
< CheckBoxPreference android:key ="sounds"
android:title ="@string/play_sounds" android:summary ="@string/play_sounds_summary"
android:defaultValue ="true" ></ CheckBoxPreference >
< EditTextPreference android:key ="warning_time"
android:title ="@string/warning_time" android:summary ="@string/warning_time_summary"
android:defaultValue ="15" android:inputType ="phone" android:digits ="0123456789" ></ EditTextPreference >
< CheckBoxPreference android:key ="unlimited_participants"
android:title ="@string/unlimited_participants" android:summary ="@string/unlimited_participants_summary"
android:defaultValue ="false" ></ CheckBoxPreference >
< CheckBoxPreference android:key ="variable_meeting_length"
android:title ="@string/variable_meeting_length" android:summary ="@string/variable_meeting_length_summary"
android:defaultValue ="false" ></ CheckBoxPreference >
</ PreferenceScreen >

 

android:key 唯一标识符。它对应保存的XML保存的配置文件中的节点的 name属性

android:defaultValue 默认值，对应XML中的Value属性的值。

/**
* PreferenceActivity 会自动保存更改
*/
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
this.addPreferencesFromResource(R.xml.setting);
}

 

当PreferenceActivity上的View有所更改时，系统会自动将对应的值更新到XML配置文件中，该文件可以在android 的 file explorer 中的 data/data/"yourPageName"/shared_prefs/"yourpageName"_prefenrences.xml中找到。“yourpageName”表示你项目所在的包。

获取配置信息

　　为了方便的获取配置信息，我们可以在PreferenceActivity里添加一些pulbic 方法来公开配置信息的访问。

/**
* 获取是否播放声音
*/
public static boolean playSounds(Context context) {
return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(SOUNDS, SOUNDS_DEFAULT);
}

/**
* 设置播放的声音
* @param context 上下文
* @param value 是否播放
*/
public static void setPlaySounds(Context context, boolean value) {
PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(SOUNDS, value).commit();
}

/**
* 获取警告时间
* @param context 上下文
* @return 警告时间秒
*/
public static int getWarningTime(Context context) {
String value = PreferenceManager.getDefaultSharedPreferences(context).getString(WARNING_TIME,Integer.toString(WARNING_TIME_DEFAULT));
try
{
return Integer.parseInt(value);
}
catch (NumberFormatException e)
{
setWarningTime(context, WARNING_TIME_DEFAULT);
return WARNING_TIME_DEFAULT;
}

}

/**
* 设置警告时间
* @param context 上下文
* @param warningTime 警告时间
*/
public static void setWarningTime(Context context, int warningTime) {
PreferenceManager.getDefaultSharedPreferences(context).edit().putString(WARNING_TIME, Integer.toString(warningTime)).commit();

}



/**
* 参加人数无限制
* @param context
* @return
*/
public static boolean allowUnlimitedParticipants(Context context) {
return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(UNLIMITED_PARTICIPANTS, UNLIMITED_PARTICIPANTS_DEFAULT);
}

public static void setAllowUnlimitedParticipants(Context context, boolean value) {
PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(UNLIMITED_PARTICIPANTS, value).commit();
}

/**
* 允许编辑会议时间
* @param context
* @return
*/
public static boolean allowVariableMeetingLength(Context context) {
return PreferenceManager.getDefaultSharedPreferences(context).getBoolean(VARIABLE_MEETING_LENGTH, VARIABLE_MEETING_LENGTH_DEFAULT);
}

public static void setAllowVariableMeetingLength(Context context, boolean value) {
PreferenceManager.getDefaultSharedPreferences(context).edit().putBoolean(VARIABLE_MEETING_LENGTH, value).commit();
}

 

　　getDefaultSharedPreferences(Context )用来获取preferences.以后的操作就和普通的Sharedpreferences一样了，如果需要修改某项配置的信息，记得最后需要 commit()。

当其他地方需要使用配置时，可以直接调用 setting.getXXX() 方法来获取配置信息。

系列索引

　　

Android 开源项目-StandupTimer学习笔记索引