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

一、前言

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

二、准备工作

首先需要理解的就是我们设置界面还是需要控件的,但是我们所使用的控件不在是普通的控件,下面我们来简单的介绍下我们需要知道的控件。

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

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

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

PreferenceActivity:首选项活动。

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

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

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

三、正文

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中的entriesentryValue资源如下所示(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中,而不需要你去一个一个的绑定事件,然后保存。如果我们需要读取这些配置只需要通过PreferenceManagerGetDefaultSharedPreferences获取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显示出来,完成了上面这些还不够,我们还需要将其进行注册,所以我们需要利用RegisterOnSharedPreferenceChangeListenerUnregisterOnSharedPreferenceChangeListener方法,下面为具体的代码:

 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都可以单独使用第二节的技术,下面我们查看最后运行的结果:

点中第一之后:

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

时间: 2024-11-05 15:46:58

Xamarin.Android学习之应用程序首选项的相关文章

IOS – 添加Settings Bundle应用程序首选项到Settings应用程序

iPhone允许应用程序将自定义首选项添加到Settings应用程序中,开发者也可以以编程的方式指定这些设置,但添加到Settings应用程序的方式会提供一个友好的GUI.自定义首选项支持多种多样的数据交互风格,包括文本.密码.开关.滑块.以及二级选择页面.但这里应注意避免敏感信息. IOS应用程序存储信息的方式主要有三种: 1. 单例类NSUserDefaults:NSUserDefaults类的工作原理类似于NSDictionary,所有首选项都以键/值对的方式存储在NSUserDefaul

张高兴的 Xamarin.Android 学习笔记:(一)环境配置

最近在自学 Xamarin 和 Android ,同时发现国内在做 Xamarin 的不多.我在自学中间遇到了很多问题,而且百度到的很多教程也有些过时,现在打算写点东西稍微总结下,顺便帮后人指指路了.由于手头没啥中文资料,我也是自己摸索出来的,而且我对 Android 也只是处于最开始的了解阶段(学习笔记嘛,别学边写嘛╮(╯▽╰)╭),难免会出现错误,有问题大家共同讨论(毕竟 .Net 就要靠我们腾达了). 以 Visual Studio 2015 Community 为例. 1. 安装 Xam

Android学习——移植tr069程序到Android平台

原创作品,转载请注明出处,严禁非法转载.如有错误,请留言! email:[email protected] 声明:本系列涉及的开源程序代码学习和研究,严禁用于商业目的. 如有任何问题,欢迎和我交流.(企鹅号:408797506) 本篇用到的代码下载路径:http://download.csdn.net/detail/eryunyong/9798889 Github维护: 代码结构说明: core目录是tr069程序的协议栈部分代码编译出来的可执行档案(不开源). etc_config目录是cwm

Android学习06Android应用程序的基本组件

一个Android应用程序可以由几个不同的组件构成,Android应用程序的基本组件包括:Activity,Service,BroadcastReceiver,ContentProvider和Intent. 不同的组件有不同的特性以及各自的生命周期,下面分别介绍: 1.Activity组件 Activity是最常见的一种Android组件,每个Activity都相当于一个屏幕,其为用户提供了进行交互的可视界面.应用程序可以根据需要包含一个或多个Activity,这些Activity一般都继承自a

Android自定义控件之应用程序首页轮播图

现在基本上大多数的Android应用程序的首页都有轮播图,就是像下图这样的(此图为转载的一篇博文中的图,拿来直接用了): 像这样的组件我相信大多数的应用程序都会使用到,本文就是自定义一个这样的组件,可以动态设置图片的张数.下面就开始本次的自定义之旅吧,首先看一下自定义控件的的布局文件: <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://

Xamarin.Android开发实践(十五)

Xamarin.Android学习之应用程序首选项 一.前言 任何App都会存在设置界面,如果开发者利用普通控件并绑定监听事件保存设置,这 一过程会非常的枯燥,而且耗时.我们可以看到Android系统的设置界面里面的选项如此之多,是不是都是这样开发的呢?其实不然,Android已经给 我们提供了专门设计这一功能的技术,叫应用程序首选项,今天我们将学习如何使用他们来开发配置界面以及功能. 二.准备工作 首先需要理解的就是我们设置界面还是需要控件的,但是我们所使用的控件不在是普通的控件,下面我们来简

【转】 Pro Android学习笔记(六三):Preferences(7):代码控制首选项

[-] 代码实现preference 利用preference保存状态 DialogPreference 代码实现preference View可以不通过xml进行设置,有代码直接进行设置,首选项preference也一样.下面是代码设置list preference的例子,是在通过header来指向PreferenceFragment的类,在PreferenceActivity中的实现也是类似的. public class ListPreferenceFragment extends Pref

【转】 Pro Android学习笔记(六十):Preferences(4):MultiSelect List Preference

目录(?)[-] XML文件 在设备中保存 读出信息 ListPreference提供单选列表,我们可以通过CheckBoxPreference提供多选列表.此外,Android在3.0后提供MultiSelectListPreference,它的实现和ListPreference相似,不同的是还可以不选择或者多个选择.如图所示. XML文件 在复合例子中加入相关的内容,如下.同样地可以采用@array来对entry和entryvalue进行定义,使用比CheckBox Preference要方

【转】 Pro Android学习笔记(五八):Preferences(2):CheckBoxPreference

目录(?)[-] CheckBox Preference xml文件 设备的存贮文件 复合preference 在ListPreference的例子中显示的是单选,如果是多选,可采用CheckBoxPreferece.我们继续航班信息的例子,用户选择航班信息中显示哪些信息(航班,出发时间.到达时间.航程时间.价格). CheckBox Preference xml文件 在res/xml/中增加checkbox.xml文件,如下: <?xml version="1.0" encod