Android之PreferenceActivity 分享

PerferenceActivity是什么，看下面的截图：

Android系统截图

               MusicPlayer Setting截图

         好了，我们看到Android系统本身就大量用到了PreferenceActivity来对系统进行信息配置和管理，那么它是怎么保存数据的呢，如何创建PrefenceActivity的呢，更关键是怎样触发相应事件的呢。

         先看第一个问题，PreferenceActivity是如何保存的数据。对Android系统了解的都知道，Android系统有四种基本的数据保存方 法，一是SharedPreference，二是文件，三是SQLite,四是ContentProvider。看出来了吧，Preference，对就 是使用SharedPreferneces以键值对的形式进行保存的，当然，我们也可以通过SharedPreferences来获取 PreferenceActivity设置的值。

 

         第二个问题：如何创建一个PreferenceActivity。 其实Eclipse提供了相应的创建工具，和创建Layout是基本相同的。步骤如下：

        创建Android项目，并添加一个Android xml文件。注意，这次选择的不是Layout，而是Preference,而且注意Folder路径是 res/xml.

            

添加完成之后，在res/xml/下打开添加的preference.xml文件。可以看到Android也为我们提供两种编辑模式，可视化的结构设计及xml源码设计。推荐使用structure进行创建。如图所示：

      

下面我们看看PrefeneceActivity都提供了哪几种元素可供使用。点击Add按钮，在打开的新窗口中可以看到以下几项：

             

CheckBoxPreference:CheckBox选择项，对应的值的ture或flase。如图：

           

EditTextPreference:输入编辑框，值为String类型，会弹出对话框供输入。

 

ListPreference: 列表选择，弹出对话框供选择。

 

Preference：只进行文本显示，需要与其他进行组合使用。

          

PreferenceCategory：用于分组。效果如下:

         

PreferenceScreen:PreferenceActivity的根元素，必须为它。

 

RingtonePreference：系统玲声选择。

        

OK，Preferenc的基本元素介绍完毕，下一节将使用它们创建一个完整的Preference并进行显示。

-------------------------------------------------------------------------------

分析MusicPlayer Setting，第一部分为“我的位置”，包括“使用无线网线”和“使用GPS”两个部分，而且都是CheckBox，根据上节学习，应该包括一个PreferenceCategory和两个CheckBoxPreference。

Xml代码：

<PreferenceCategory android:title=" 我的位置" android:key=" set_local">
<CheckBoxPreference android:key=" apply_wifi"
android:summary=" 使用无线网络在应用程序（例如Google地图）中查看位置" android:title=" 使用无线网络" android:defaultValue="true">
</CheckBoxPreference>
<CheckBoxPreference android:key=" apply_gps"
android:summary=" 定位到街道级别（需要消耗更多的电量以及天气允许）" android:title=" 使用GPS">
</CheckBoxPreference>
</PreferenceCategory>

以上代码当然也可以用Android提供的IDE工具直接生成。视频结构如下：

     
PreferenceCategory属性分析：

         title:显示的标题

         key：唯一标识（至少在同一程序中是唯一），SharedPreferences也将通过此Key值进行数据保存,也可以通过key值获取保存的信息 (以下相同）。

CheckBoxPreference属性分析：

        Key：唯一标识.

        title：显示标题（大字体显示）

       summary:副标题（小字体显示）

       defaultValue:默认值（当然，此处只能是true或false了)

 

Preference.xml的第二部分为“无线和网络设置”，此部分包括的内容比较多，也稍微复杂，一步一步来分析。

xml代码：

< PreferenceCategory  android: title= "无线和网络设置" >
< CheckBoxPreference  android: key= "apply_fly"
android: summary= "禁用所有无线连接"  android: title= "飞行模式" >
</ CheckBoxPreference >
< CheckBoxPreference  android: key= "apply_internet"
android: summary= "禁用通过USB共享Internet连接"  android: title= "Internet共享" >
</ CheckBoxPreference >
< CheckBoxPreference  android: key= "apply_wifi"
android: summary= "打开Wi-Fi"  android: title= "Wi-Fi" >
</ CheckBoxPreference >
< Preference  android: summary= "设置和管理无线接入点"  android: title= "Wi-Fi设置"
android: dependency= "apply_wifi"  android: key= "wifi_setting" >
</ Preference >
< CheckBoxPreference  android: key= "apply_bluetooth"
android: summary= "启用蓝牙"  android: title= "蓝牙" >
</ CheckBoxPreference >
< Preference  android: summary= "管理连接、设备设备名称和可检测性"
android: title= "蓝牙设置"  android: dependency= "apply_bluetooth"
android: key= "bluetooth_setting" >
</ Preference >
< EditTextPreference  android: key= "number_edit"
android: title= "输入电话号码" >
</ EditTextPreference >
< ListPreference  android: title= "部门设置"  android: entries= "@array/department"
android: entryValues= "@array/department_value"  android: dialogTitle= "选择部门"
android: key= "depart_value" >
</ ListPreference >
< RingtonePreference  android: ringtoneType= "all"  android: title= "玲聲"  android: showDefault= "true"  android: key= "ring_key"  android: showSilent= "true" >
</ RingtonePreference >
</ PreferenceCategory >

对应的Structure图：

        

第二部分中前三个都为CheckBoxPreference，不心多说，从<Preference android:key="bluetooth_setting"/>开始。

Preference属性分析：

       Key：唯一标识.

        title：显示标题（大字体显示）

       summary:副标题（小字体显示）

     dependency：附属（嘛意思），即标识此元素附属于某一个元素（通常为CheckBoxPreference)，dependency值为所附属 元素的key。上面代码中的Preference元素附属于key等于“apply_bluetooth”的CheckPreference元素，当 CheckPreference值为true时，Preference则为可用，否则为不可用。

 

EditTextPreperence属性分析：

    Key：唯一标识.

     title：显示标题（大字体显示）

ListPreference属性分析：

   Key：唯一标识.

   title：显示标题（大字体显示）

  dialogTitle：弹出对话框的标题

 entries：列表中显示的值。为一个数组，通读通过资源文件进行设置。

entryValues：列表中实际保存的值，也entries对应。为一个数组，通读通过资源文件进行设置。以下代码显示的是arrays.xml文件中内容：

< resources >
< string- array  name= "department" >
< item >综合部 </ item >
< item >行政部 </ item >
< item >外贸部 </ item >
</ string-array >
< string- array  name= "department_value" >
< item >001 </ item >
< item >002 </ item >
< item >003 </ item >
</ string-array >
</ resources >

RingtonePreference ：玲声（暂时没有用到过），暂时略过。

OK,Preference.xml内容已经分析完毕，属性都大致相同，相信亲自动力一试也就那么回事。那么如何把Preference.xml中内容展现出来呢？

Layout是通过继续自Activity的类来进行显示的，前面提到过，PreferenceActivity是专门用于显示preference的，所以只要创建一个继承自PreferenceActivity类即可。代码如下： 

public class Setting extends PreferenceActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 所的的值将会自动保存到SharePreferences
addPreferencesFromResource(R.xml.preference);
}
}

 

接下来就是运行程序，显示劳动成果。至此，工作已经完成大半，所有的值都会保存到SharedPreferences中，我们也可以读取到保存的结果。

还有一个重要的问题，就是如何响应PreferenceActivity的操作。其实只要重写PreferenceActivity的 onPreferenceTreeClick的方法就可以了，通过参数preference来判断是对那一个元素进行的，并根据需要进行操作。

@Override  public  boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,
Preference preference) {
return  false;
}

 

获取配置信息 　　为了方便的获取配置信息，我们可以在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() 方法来获取配置信息。

今天主要研究了一下设置中的Preferencescreen应用，它不仅可以作为设置界面显示，而且还能够启动activity，下面主要是对启动activity的介绍

1. Preferencescreen中启动activity

例如wireless_setting.xml中有如下片段



<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:settings="http://schemas.android.com/apk/res/com.seedshope.android">

    <PreferenceScreen

        android:key="wifi_settings"

        android:title="@string/wifi_settings"

        android:summary="@string/wifi_settings_summary" >

        <intent

            android:action="android.intent.action.MAIN"

            android:targetPackage="com.android.settings"

            android:targetClass="com.android.settings.wifi.WifiSettings" />

    </PreferenceScreen>

</PreferenceScreen>



其中com.android.settings是工程的包名，com.android.settings.wifi.WifiSettings是要启动的类。

一般情况下，这样就ok了，点击对应的Preference就能够启动对应的activity，然而仅仅这样有时这样，并不一定能够启动对应的activity，因为它与回调函数onPreferenceTreeClick有关，有时候我们会重写这个方法如：

    public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) {

       if ( (preference == mAirplaneModePreference) &&

                (Boolean.parseBoolean(

                    SystemProperties.get(TelephonyProperties.PROPERTY_INECM_MODE))) ) {

            // In ECM mode launch ECM app dialog

           startActivityForResult(

                new Intent(TelephonyIntents.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS, null),

                REQUEST_CODE_EXIT_ECM);

            return true;

        }

        else {

            // Let the intents be launched by the Preference manager

            return false;

       }

    }

其中WirelessSetting.java中有如上函数,当返回值为true时,你怎么点击Preference都不会跳转到activity的，只
有等到它的返回值为false的时候，才可以正常跳转，因为点击某一个Preference的真正实现在Preference.java的
performClick函数中如下：

void performClick(PreferenceScreen preferenceScreen) {

        

        if (!isEnabled()) {

            return;

        }

        

        onClick();

        

        if (mOnClickListener != null && mOnClickListener.onPreferenceClick(this)) {

            return;

        }

        

        PreferenceManager preferenceManager = getPreferenceManager();

        if (preferenceManager != null) {

            PreferenceManager.OnPreferenceTreeClickListener listener = preferenceManager

                    .getOnPreferenceTreeClickListener();

            if (preferenceScreen != null && listener != null

                    && listener.onPreferenceTreeClick(preferenceScreen, this)) {

                return;

            }

        }

        

        if (mIntent != null) {

            Context context = getContext();

            context.startActivity(mIntent);

        }

    }

当点击某个Preference时的调用流程是AdapterView.performItemClick－－》
PreferenceScreen.onItemClick－－》Preference.performClick－－》
PreferenceActivity.onPreferenceTreeClick，当onPreferenceTreeClick返回true的时候
就直接return了，没有走下面启动activity的地方了，因此要使一个Preference能够正常跳转到另外一个activity有两个条件，


将你自己的Preference Screen共享出来

   <activity android:name=".UserPreferences" android:label="Earthquake Preferences">

      <intent-filter>

         <action android:name="com.paad.myapp.ACTION_USER_PREFERENCE" />

      </intent-filter>

   </activity>

一是xml里面是否设置正确，第二是调用该xml的java类是否在onPreferenceTreeClick这个函数需要返回false