zoukankan      html  css  js  c++  java
  • 【转】 Pro Android学习笔记(五七):Preferences(1):ListPreference

    目录(?)[-]

    1. 例子1ListPreference小例子
      1. 定义一个preferences XML文件
      2. 继承PreferenceActivity
      3. 用户定制偏好的读取
        1.      第一次运行时设置缺省值
      4. 设置Category

    Adnroid提供Preferences framework,用户可定制化应用,可用来保存信息和状态。在Android学习笔记(四十):Preference的使用中我已经对preferences有所了解。在Android 3.0,随着对平板的支出,preferences有不少的变化。

    例子1:ListPreference小例子

    我们先同一个简单的例子来复习。机票的显示缺省是按最低价格,但是用户可以选择自己希望的排序方式,并设为默认排序。在这个例子中,使用API level 11之前的方法,在实现方面会更为简单,主要是为了更好了解什么是preference。Android提供的完整的prefrences framework,包括通过xml定义、显示设置,可保留用户选择项。

    例子执行如图,左图称为preference screen为定制设定的选项,点击,展开右图,是一个list preference,以带有radio button的对话框方式呈现,当用户选择某个配置,将马上被保存,并关闭对话框,用户重新打开,即时是activity关闭后重新打开,也可得到之前定制配置。例子的实现分为两个步骤:

    1、定义一个preferences XML文件

    res/xml下,我们定义名为fightoptions.xml的文件,如下。合理的属性值应该采用@string/xxxx的方式,但是为了很好的例子对应,我们直接赋值。

    <?xml version="1.0" encoding="utf-8"?> 
    <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
        android:key="flight_option_preference"   按:可以通过key来获取preference,类似于view的android:id 
        android:title="My Preferences"                 按:对于最top的PreferenceScreen,此为Activity的title 
        android:summary="设置航线排序选项"> 
        <ListPreference android:key="selected_flight_sort_option"   按:可以通过key来获取preference 
            android:title="Flight Options"               
            android:summary="Set Search Options" 
            android:entries="@array/flight_sort_options"                    按:list的内容
            android:entryValues="@array/flight_sort_options_values" 按:list各内容对应的value
            android:dialogTitle="Choose Flight Options" 
            android:defaultValue="1"/>  <!-- 对应为entryValues的值,缺省1,即缺省为Number of Stops。 --> 
    </PreferenceScreen>

    其中有两个数据,我们在res/values/array.xml文件中定义,具体如下:

    <?xml version="1.0" encoding="utf-8"?> 
    <resources> 
        <string-array name="flight_sort_options"> 
            <item>Total Cost</item> 
            <item>Number of Stops</item> 
            <item>AirLine</item> 
        </string-array> 
        <string-array name="flight_sort_options_values"> 
            <item>0</item> 
            <item>1</item> 
            <item>2</item> 
        </string-array> 
    </resources>

    这两个数组,分别是list preference的entries和entry value,前者是用于显示给用户,后者是用于在设备中保存。本例选取了数组的需要做为entry value。通过android:defatulvalue设置缺省的entry value,如果我们不设置,则取值为null,这显然是不合适。

    Preferences保存在设备的/data/data/<package-name>/shared_prefs/<package-name>_preferences.xml文件中,可通过DDMS的文件浏览器查看(对于真实设备,该文件不能读,模拟器上的可以)。

    我们通过DDMS的文件浏览器将其导出,如下:

    <?xml version='1.0' encoding='utf-8' standalone='yes' ?> 
    <map> 
        <string name="selected_flight_sort_option">1</string> 
    </map>

    保存了list preferences的key和用户选择的entry value。分开entry和entry value是有意义的,开发者可以重新定义entry的描述,或者增加数组的长度,只要维持原有entry value不变,升级后preference仍然有效。一般,我们会在res/vaule/中设置string的值,方便适应不同语言版本,但是要注意key的值不应该有多个。

    2、继承PreferenceActivity

    public class FightListPreferenceActivity extends PreferenceActivity{ 
        @SuppressWarnings("deprecation") 
        @Override 
        protected void onCreate(Bundle savedInstanceState) { 
            super.onCreate(savedInstanceState);  
            // 将xml定义加载为preferences 
            addPreferencesFromResource(R.xml.fightoptions);
              
            // 以下仅用于了解xml各属性的含义,并读取属性 
            Preference p = findPreference("flight_option_preference"); //通过key来获取preference
            showInfo("p = " + p); 
            showInfo("summary: " + p.getSummary()); 
            showInfo("title: " + p.getTitle());  
             
            ListPreference lp = (ListPreference)findPreference("selected_flight_sort_option");
            showInfo("lp = " + lp); 
            showInfo("entry = " + lp.getEntry()); 
            showInfo("value = " + lp.getValue());          
        } 
        
        private void showInfo(String s){ 
            Log.d(getLocalClassName(),s); 
        } 
    }

    3、用户定制偏好的读取

    用户设置了preferences,应用的其他activity可以读取,应用关闭后,重新启动也能读取相应的配置。在MainActivity中通过OptionsMenu触发FightListPreferenceActivity,我们在MainActivity中提供读取preferences的方法,如下:

    private void getPreferenceCfg(){  
         //通过preferences管理器获取本应用的preferences。参数this将使用本package的名字来寻找保存文件。  
        SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(this); 
        //根据preferences 的key获取entity value,并给出缺省值。由于应用第一次运行时,没有保存的preference文件,如果不使用缺省值,则返回null。在这里,我们直接指定缺省值为“1”,这只是为了例子简单的便捷方式。实际上,我们应该在res/values/下设置我们的缺省值,除了可在preference的xml中引用,还可以直接在此设定缺省值。同一个值不要在多处进行赋值是编程的基本原则之一。  
        String option = prefs.getString("
    selected_flight_sort_option", "1"); 
        //通过entity value获取entity的内容 
        String[] optionText = getResources().getStringArray(R.array.flight_sort_options); 
        showInfo("option = " + option + ",select : " + optionText[Integer.parseInt(option)]);
    }

    另一个获取share prefs的方式如下,第一个参数是帮助查找存储文件,一般可以用应用的报名,第二个参数是mode。可以通过这种方式获取其他应用的preferences。本例,缺省模式为MODE_PRIVATE,对于模拟器,存储文件的读写权限比较高,即使在MODE_PRIVATE模式下,跨应用可以读取。一般我们不使用这种方式,但是如果在同一设备上,有多个用户,可以采用第二种方式,区分开不同用户的定制的偏好,但就目前很少有这种情况。

    SharedPreferences prefs = getSharedPreferences("cn.wei.flowingflying.propreferences", 0);

         第一次运行时设置缺省值

    如果设置项很多,每项在代码中都设置缺省值,推荐的方式如下。在应用第一次运行时,从preference的xml中获取缺省值,并生成保存文件,如果已经有一个SharedPrefferences对象,也会进行更新之,即下面代码中头L3和L4可以互换。即时getString中将缺省值设置为null,也会根据配置读到缺省值。非第一运行,不会改动现有保存值。

    protected void onCreate(Bundle savedInstanceState) { 
        … … 
        PreferenceManager.setDefaultValues(this, R.xml.fightoptions, false); 
        SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(this); 
        String option = prefs.getString("selected_flight_sort_option",null); 
        showInfo("option = " + option ); 

    执行setDefaultValues()后,即时没有运行PreferenceActivity,系统会根据缺省配置,生成保存文件,如下图。此外还有_has_set_default_values.xml用于表明是通过缺省值创建的。setDefaultValues()的第三个参数,我的试验是在Android 4.4的版本中,无论true或者false,并不会有什么影响,设置true,并不会在已有保存文件的情况下,将其重置为缺省值。

    另一个获取share prefs的方式如下,第一个参数是帮助查找存储文件,一般可以用应用的报名,第二个参数是mode。可以通过这种方式获取其他应用的preferences。本例,缺省模式为MODE_PRIVATE,对于模拟器,存储文件的读写权限比较高,即使在MODE_PRIVATE模式下,跨应用可以读取。一般我们不使用这种方式,但是如果在同一设备上,有多个用户,可以采用第二种方式,区分开不同用户的定制的偏好,但就目前很少有这种情况。

    SharedPreferences prefs = getSharedPreferences("cn.wei.flowingflying.propreferences", 0);

    4、设置Category

    Preference可被其他应用获取,PreferenceActivity也可被intent唤起,我们可以设置activity的类型,例如:

    <activity android:name=".FightListPreferenceActivity" android:label="@string/test_list_preferences" >
        <intent-filter> 
            <action android:name="cn.wei.flowingflying.propreferences.intent.action.FightPreferences" />
            <category android:name="android.intent.category.PREFERENCE"/>
        </intent-filter> 
    </activity> 

    本博文涉及的例子代码,可以在Pro Android学习:Preference(首选项)小例子中下载。

    相关链接: 我的Android开发相关文章

  • 相关阅读:
    python-操作excel之openpyxl
    python之redis
    geetest滑动验证
    vue-cookies
    谷歌浏览器安装vue插件
    axios和vuex
    概率论基础:补充(1)概率的公理化定义与随机变量的概念
    卸载 Anaconda 转用 Miniconda
    傅立叶变换
    SL-主成分分析(PCA)
  • 原文地址:https://www.cnblogs.com/blongfree/p/5048019.html
Copyright © 2011-2022 走看看