Xamarin.Android开发实践（十五）

原文:Xamarin.Android开发实践（十五）

Xamarin.Android学习之应用程序首选项

1、前言

任何App都会存在设置界面，若是开发者利用普通控件并绑定监听事件保存设置，这 一过程会很是的枯燥，并且耗时。咱们能够看到Android系统的设置界面里面的选项如此之多，是否是都是这样开发的呢？其实否则，Android已经给 咱们提供了专门设计这一功能的技术，叫应用程序首选项，今天咱们将学习如何使用他们来开发配置界面以及功能。

 

2、准备工做

首先须要理解的就是咱们设置界面仍是须要控件的，可是咱们所使用的控件不在是普通的控件，下面咱们来简单的介绍下咱们须要知道的控件。

CheckBoxPreference：用来实现勾选的项目，在SharedPreference中保存为bool类型。

EditTextPreference：用来实现字符输入的项目，在SharedPreference中保存为字符串类型。

ListPreference：用来实现提供一列数据供选择的项目，在SharedPreference中保存为字符串类型。

PreferenceActivity：首选项活动。

PreferenceCategory：用来实现将首选项进行分类。

PreferenceScreen：用于在另外一个新的屏幕上对首选项进行分组。

除了以上的还有其它的这里就不意义例举了。

 

3、正文

 

1.显示一个简单的首选项

首先咱们须要打开MainActivity并将继承的基类改为PreferenceActivity，而后将SetContentView改为AddPreferencesFromResource，具体的代码以下所示：

1         protected override void OnCreate(Bundle bundle) 2  { 3 base.OnCreate(bundle); 4  AddPreferencesFromResource(Resource.Layout.Main); 5 }

读者也能够尝试不修改而直接显示，固然必定会报错。

 

修改好了代码咱们打开Main.axml并将其中的全部xml删除，改写成以下所示：

 1 <?xml version="1.0" encoding="utf-8"?>  2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">  3 <PreferenceCategory  4 android:title="配置分类1">  5 <CheckBoxPreference  6 android:key="PREF_CHECK_BOX"  7  android:title="Check Box Preference"  8  android:defaultValue="true" />  9 </PreferenceCategory> 10 <PreferenceCategory 11 android:title="配置分类2"> 12 <EditTextPreference 13 android:key="PREF_EDIT_BOX" 14  android:title="Edit Text Preference" 15  android:dialogMessage="please input" 16  android:defaultValue="test" /> 17 </PreferenceCategory> 18 <PreferenceCategory 19 android:title="配置分类3"> 20 <ListPreference 21 android:title="List Preference" 22  android:key="listChoice" 23  android:entries="@array/ListText" 24  android:entryValues="@array/ListValue" 25  android:summary="choice one item" /> 26 </PreferenceCategory> 27 <PreferenceCategory 28 android:title="配置分类4"> 29 <PreferenceScreen 30 android:title="子配置"> 31 <CheckBoxPreference 32 android:key="PREF_CHECK_BOX_1" 33  android:title="Check box" 34  android:defaultValue="true" /> 35 </PreferenceScreen> 36 <PreferenceScreen 37 android:title="打开新的意图"> 38 <intent 39 android:action="android.settings.DISPLAY_SETTINGS" /> 40 </PreferenceScreen> 41 </PreferenceCategory> 42 </PreferenceScreen>

一部分简单的，笔者就很少作介绍了。主要是看这段xml代码：

1         <PreferenceScreen 2 android:title="打开新的意图"> 3 <intent 4 android:action="android.settings.DISPLAY_SETTINGS" /> 5 </PreferenceScreen>

 

 

其中ListPreference中的entries和entryValue资源以下所示（Strings.xml中）：

 1 <?xml version="1.0" encoding="utf-8"?>  2 <resources>  3 <string name="Hello">Hello World, Click Me!</string>  4 <string name="ApplicationName">PreferenceScreen</string>  5 <string-array name="ListText">  6 <item>First</item>  7 <item>Second</item>  8 <item>Third</item>  9 </string-array> 10 <string-array name="ListValue"> 11 <item>VFirst</item> 12 <item>VSecond</item> 13 <item>VThird</item> 14 </string-array> 15 </resources>

 

咱们知道了PreferenceScreen会 打开一个新的界面去显示在它内部的首选项，可是内部是一个intent则表示打开指定action的活动，就如同startActivity同样，这样的 有点就是有助于咱们将某些咱们须要的设置，可是在系统中已经存在这个设置，咱们就能够经过这种方式将其连接过去。下面咱们运行项目，将能够看到以下的图 像：

 

相信有些笔者会感受这有什么的，显示的效果跟普通的控件同样。由于它自己就是利用了普通的控件，固然也不会白利用，由于在内部它已经帮你作好了一大推事情，在这个界面上的每一个选项它都已经自动保存进了SharedPreference中，而不须要你去一个一个的绑定事件，而后保存。若是咱们须要读取这些配置只须要经过PreferenceManager的GetDefaultSharedPreferences获取ISharedPreference类型的对象后经过Get<类型>方法读取便可，他们的key天然就是控件的android:key属性的值。这样咱们就节省了很多时间了。

 

 

2.监听首选项更改

虽然咱们已经能够读取配置的值，可是实际的应用中并非全部的设置都是在下次才启 用。有可能有些设置修改完以后就要修改当前的功能。好比经过设置关闭某个功能，那么在这个设置选择下去的同时app也须要当即将对应的功能关闭。这时候我 们就要监听对应的事件，而咱们只须要实现ISharedPreferencesOnSharedPreferenceChangeListener接口便可，下面为该接口的代码：

1     public interface ISharedPreferencesOnSharedPreferenceChangeListener : IJavaObject, IDisposable 2  { 3 void OnSharedPreferenceChanged(ISharedPreferences sharedPreferences, string key); 4 }

其中咱们能够看到只要实现一个方法，而且该方法的第二个参数是进行修改的选项的android:key的值，经过key咱们就能够在第一个参数中获取修改后的值，这里还须要注意的是要根据状况选择对应类型的Get方法。

 

笔者为了节省时间，因此咱们依然是利用上节的项目，在MainActivity中实现该接口。

代码以下所示：

 1         public void OnSharedPreferenceChanged(ISharedPreferences sharedPreferences, string key)  2  {  3 string value = "";  4 switch (key)  5  {  6 case "PREF_CHECK_BOX":  7  {  8 if (sharedPreferences.GetBoolean(key, false))  9 value = "true"; 10 else 11 value = "false"; 12  } 13 break; 14 case "PREF_EDIT_BOX": 15  { 16 value = sharedPreferences.GetString(key, ""); 17  } 18 break; 19 case "listChoice": 20  { 21 value = sharedPreferences.GetString(key, ""); 22  } 23 break; 24  } 25 Toast.MakeText(this, key + "的值改变为" + value, ToastLength.Short).Show(); 26 }

笔者仅仅只是根据状况获取对应的值后经过Toast显示出来，完成了上面这些还不够，咱们还须要将其进行注册，因此咱们须要利用RegisterOnSharedPreferenceChangeListener和UnregisterOnSharedPreferenceChangeListener方法，下面为具体的代码：

 1         protected override void OnResume()  2  {  3 base.OnResume();  4 PreferenceManager.GetDefaultSharedPreferences(this).RegisterOnSharedPreferenceChangeListener(this);  5  }  6  7 protected override void OnPause()  8  {  9 base.OnPause(); 10 PreferenceManager.GetDefaultSharedPreferences(this).UnregisterOnSharedPreferenceChangeListener(this); 11 }

 

这里提醒下读者，笔者在查看《c#开发Android应用实战》一书中后，采用该书上面的方法，可是监听事件一直不会被执行，因此参考了Android方面的书籍，而采用了上面的方法。

 

咱们从新运行程序，修改一个项目后将会出现如下的结果：

 

 

3.新平台下的应用程序首选项

下面咱们将学习Android 3.0后的应用程序首选项如何实现，以开发可以兼容平板和手机的设置界面。这节笔者建议你们从新建立一个项目，而且Android SDK的版本要在3.0或以上才能够。

 

首先咱们须要设计新的应用程序首选项的xml代码，笔者的代码以下所示：

 1 <?xml version="1.0" encoding="utf-8"?>  2 <preference-headers xmlns:android="http://schemas.android.com/apk/res/android">  3 <header  4 android:fragment="preferencefragmentstudy.FirstPreferenceFragment"  5  android:title="FirstFragment"  6  android:summary="the first framgnet" />  7 <header  8 android:fragment="preferencefragmentstudy.SecondPreferenceFragment"  9  android:title="SecondFragment" 10  android:summary="the second fragment"></header> 11 </preference-headers>

 

能够看到这里的xml标签在上面是历来没有使用过的，而每一个header都是一个连接，会连接到由android:fragment指定的碎片，笔者要注意下fragment的路径是项目名称的小写加类名，若是前面是解决方案的大写会打不开。而且MainActivity仍是继承自PreferenceActivity，只是咱们这里再也不重写OnCreate而是须要重写OnBuildHeaders方法并调用LoadHeadersFromResource加载上面的xml资源，笔者的代码以下所示：

1     [Activity(Label = "PreferenceFragmentStudy", MainLauncher = true, Icon = "@drawable/icon")] 2 public class MainActivity : PreferenceActivity 3  { 4 public override void OnBuildHeaders(System.Collections.Generic.IList<PreferenceActivity.Header> target) 5  { 6  LoadHeadersFromResource(Resource.Xml.XMLFile2, target); 7  } 8 }

 

为了节约时间，另外两个PreferenceFragment都采用同一个设计，下面为xml的代码:

 1 <?xml version="1.0" encoding="utf-8"?>  2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">  3 <PreferenceCategory  4 android:title="配置分类1">  5 <CheckBoxPreference  6 android:key="PREF_CHECK_BOX"  7  android:title="Check Box Preference"  8  android:defaultValue="true" />  9 </PreferenceCategory> 10 </PreferenceScreen>

这里咱们能够看到熟悉的标签了，下面咱们开始设计PreferenceFragment，他们的代码分别以下所示：

1     public class FirstPreferenceFragment : PreferenceFragment 2  { 3 public override void OnCreate(Bundle bundle) 4  { 5 base.OnCreate(bundle); 6  AddPreferencesFromResource(Resource.Xml.XMLFile1); 7  } 8 }

 

 

    [Activity(Label = "SecondPreferenceFragment")] public class SecondPreferenceFragment : PreferenceFragment { public override void OnCreate(Bundle bundle) { base.OnCreate(bundle); AddPreferencesFromResource(Resource.Xml.XMLFile1); } }

 

每一个PreferenceFragment均可以单独使用第二节的技术，下面咱们查看最后运行的结果：

 

点中第一以后：

 

利用该技术能够在须要大量配置选项的时候可以有条不紊的设计并归类。