探索首選項(xiàng)框架
在深入探討Android的首選項(xiàng)框架之前,首先構(gòu)想一個(gè)需要使用首選項(xiàng)的場(chǎng)景,,然后分析如何實(shí)現(xiàn)這一場(chǎng)景,。假設(shè)你正在編寫一個(gè)應(yīng)用程序,,它提供了一個(gè)搜索飛機(jī)航班的工具。而且,,假設(shè)該應(yīng)用程序的默認(rèn)設(shè)置是根據(jù)機(jī)票價(jià)格由低到高的順序顯示航班,,但用戶可以將首選項(xiàng)設(shè)置為始終根據(jù)最少停站數(shù)或特定航線來(lái)航班。如果實(shí)現(xiàn)這一場(chǎng)景,?
ListPreference
顯然,,必須為用戶提供UI 來(lái)查看排序選項(xiàng)列表。該列表將包含每個(gè)選項(xiàng)的單選按鈕,,而且默認(rèn)(或當(dāng)前)選項(xiàng)應(yīng)該被預(yù)先選中,。要使用Android首選項(xiàng)框架解決此問(wèn)題,所做的工作非常之少,。首先,,創(chuàng)建首選項(xiàng)XML文件來(lái)描述首選項(xiàng),,然后使用預(yù)先構(gòu)建的活動(dòng)類,該類知道如何顯示和持久化首選項(xiàng),,下面是我們的首選項(xiàng) XML 文件flightoptions.xml ,。
- <?xml version="1.0" encoding="utf-8"?>
- <PreferenceScreen
- xmlns:android="http://schemas./apk/res/android"
- android:key="flight_option_preference"
- android:title="@string/prefTitle"
- android:summary="@string/prefSummary">
-
- <ListPreference
- android:key="@string/selected_flight_sort_option"
- android:title="@string/listTitle"
- android:summary="@string/listSummary"
- android:entries="@array/flight_sort_options"
- android:entryValues="@array/flight_sort_options_values"
- android:dialogTitle="@string/dialogTitle"
- android:defaultValue="@string/flight_sort_option_default_value"/>
- </PreferenceScreen>
上邊說(shuō)了我們還需要一個(gè)Activity類FlightPreferenceActivity,下面使我們的Activity類 這個(gè)Activity類繼承了PreferenceActivity 代碼如下:
- package xiaohang.zhimeng;
-
- import android.os.Bundle;
- import android.preference.PreferenceActivity;
-
- public class FlightPreferenceActivity extends PreferenceActivity {
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- addPreferencesFromResource(R.xml.flightoptions);
- }
- }
上面的代碼清單 包含了一個(gè)表示航班選項(xiàng)示例的首選項(xiàng)設(shè)置的XML片段,。該包含了一個(gè)活動(dòng)類 也就是我們的 FlightPreferenceActivity 這個(gè)類主要用于加載我們的XML 文件,。首先看一下XML。Android提供了一種端到端得首選項(xiàng)框架,。這意味著,,該框架支持定義首選項(xiàng),想用戶顯示設(shè)置,,以及將用戶選擇持久化到數(shù)據(jù)庫(kù)存儲(chǔ)中,。 在/res/xml/目錄下的XML文件中定義首選項(xiàng)。要向用戶顯示首選項(xiàng),,編寫一個(gè)活動(dòng)類來(lái)擴(kuò)展預(yù)定義的 Android類 android.preference.PreferenceActivity,,然后使用 addPreferencesFromResource()方法將資源添加到活動(dòng)的資源集合中。該框架會(huì)負(fù)責(zé)剩余操作(現(xiàn)實(shí)和持久化),。
在本航班場(chǎng)景中,,在/res/xml/目錄下創(chuàng)建文件 flightoptions.xml。然后創(chuàng)建活動(dòng)類 FlightPreferenceActivity, 它擴(kuò)展了 android.preference.PreferenceActivity類,。接下來(lái)調(diào)用addPreferencesFromResource() 傳入R.xml.flightoptions,。請(qǐng)注意,首選項(xiàng)資源XML指向多個(gè)字符串資源,。為了確保正確編譯,,需要向項(xiàng)目中添加多個(gè)字符串資源 (我們稍后介紹)。現(xiàn)在先看一下 上面得代碼清單會(huì)生成什么樣子的UI.
上邊有兩個(gè)視圖,。左邊的視圖稱為首選項(xiàng)屏幕,,右邊的UI是一個(gè)列表首選項(xiàng)。當(dāng)用戶選擇 Flight Options時(shí),, Choose Flight Options視圖將以模態(tài)對(duì)話框的形式出現(xiàn),,其中包含每個(gè)選項(xiàng)的單選按鈕。用戶選擇一個(gè)選項(xiàng)之后,,將立即該選項(xiàng)并關(guān)閉視圖,。當(dāng)用戶返回選項(xiàng)屏幕時(shí),視圖將反映前面保存的選擇,。
前面已提到,,首選項(xiàng)XML 文件和相關(guān)的活動(dòng)類,從上邊我們可以看到 我們?cè)赬ML文件中定義了一個(gè)PreferenceScreen ,然后創(chuàng)建ListPreference作為子屏幕,。對(duì)于 PreferenceScreen,設(shè)置了3個(gè)屬性: key,、title和 summary,。 key 是一個(gè)字符串,可用于以編程的方式表示項(xiàng) (類似于使用 android:id的方式),;title 是屏幕的標(biāo)題 (My Preferences) ; summary是對(duì)屏幕用途的描述,。對(duì)于列表首選項(xiàng),設(shè)置 key,、title和 summary,,以及 entries、entryValues,、dialogTitle和defaultValue特性,。下表總結(jié)了這些特性。
特性 說(shuō)明
android:key 選項(xiàng)的名稱或鍵(比如selected_flight_sort_option)
android:title 選項(xiàng)的標(biāo)題
android:summary 選項(xiàng)的簡(jiǎn)短摘要
android:entries 可將選項(xiàng)設(shè)置成列表項(xiàng)的文本
android:entryValues 定義每個(gè)列表項(xiàng)的值,。注意:每個(gè)列表項(xiàng)有一些文本和 一 個(gè) 值,。 文本由entries定義,值由entryValues定義,。
android:dialogTitle 對(duì)話框的標(biāo)題,,在視圖顯示為模態(tài)對(duì)話框時(shí)使用
android:defaultValue 項(xiàng)列表中選項(xiàng)的默認(rèn)值
為了使我們的例子能夠正常運(yùn)行,我們還需要添加如下文件,。
- <?xml version="1.0" encoding="utf-8"?>
- <resources>
- <string-array name="flight_sort_options">
- <item>Total Cost</item>
- <item># 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>
此文件大家一看就知道是 定義我們選項(xiàng)的顯示的文本,,和 對(duì)應(yīng)的值 這個(gè)XML 文件的名字是 arrays.xml 此文件應(yīng)該放在 /res/values/arrays.xml
當(dāng)然不能少了 我們的strings.xml
- <?xml version="1.0" encoding="utf-8"?>
- <resources>
- <string name="hello">Hello World, FlightPreferenceActivity!</string>
- <string name="app_name">Preference_Demo</string>
- <string name="prefTitle">My Preferences</string>
- <string name="prefSummary">Set Flight Option Preferences</string>
- <string name="flight_sort_option_default_value">1</string>
- <string name="dialogTitle">Choose Flight Options</string>
- <string name="listSummary">Set Search Options</string>
- <string name="listTitle">Flight Options</string>
- <string name="selected_flight_sort_option">selected_flight_sort_option</string>
- <string name="menu_prefs_title">Settings</string>
- <string name="menu_quit_title">Quit</string>
- </resources>
剛才上邊說(shuō)到我們有一個(gè)首選項(xiàng)視圖,,就是那個(gè)FlightPreferenceActivity ,,在這
這個(gè)例子中我們是通過(guò) 一個(gè)菜單跳轉(zhuǎn)到 我們的首選項(xiàng)視圖的。就是 我們有一個(gè) MainActivity 這個(gè) MainActivity有一個(gè)菜單 叫 Settings 當(dāng)我們點(diǎn)擊這個(gè)菜單的時(shí)候就會(huì)跳轉(zhuǎn)到我們的首選項(xiàng)視圖了,,然后我們修改 首選項(xiàng)的內(nèi)容 當(dāng)我們?cè)僖淮位氐?MainActivity 的時(shí)候就會(huì)看到我們修改后的 文本和值,,我們通過(guò)一個(gè)TextView來(lái)顯示
我們還是來(lái)看一下效果吧。
下面這個(gè)XML文件就是用來(lái)定義我們 這個(gè)菜單的,,此文件的目錄在 /res/menu/mainmenu.xml
- <?xml version="1.0" encoding="utf-8"?>
- <menu xmlns:android="http://schemas./apk/res/android">
- <item android:id="@+id/menu_prefs" android:title="@string/menu_prefs_title" />
-
- <item android:id="@+id/menu_quit" android:title="@string/menu_quit_title" />
- </menu>
也比較 簡(jiǎn)單了,。
在接下來(lái)就是我們的 布局文件 main.xml了
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="http://schemas./apk/res/android"
- android:orientation="vertical" android:layout_width="fill_parent"
- android:layout_height="fill_parent">
- <TextView android:id="@+id/text1" android:layout_width="fill_parent"
- android:layout_height="wrap_content" />
- </LinearLayout>
只有一個(gè)TextView 主要用來(lái)顯示 我們修改首選項(xiàng)之后的 文本 和 值。
有了main.xml自然少不了 MainActivity了,, 下面使我們的 MainActivity類
- package xiaohang.zhimeng;
-
- import android.app.Activity;
- import android.content.Intent;
- import android.content.SharedPreferences;
- import android.os.Bundle;
- import android.view.Menu;
- import android.view.MenuInflater;
- import android.view.MenuItem;
- import android.widget.TextView;
-
- public class MainActivity extends Activity{
- private TextView tv = null;
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- tv = (TextView)findViewById(R.id.text1);
-
- setOptionText();
- }
-
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- MenuInflater inflater = getMenuInflater();
-
- inflater.inflate(R.menu.mainmenu, menu);
- return true;
- }
-
-
- @Override
- public boolean onOptionsItemSelected(MenuItem item) {
- if (item.getItemId() == R.id.menu_prefs) {
-
- Intent intent = new Intent().setClass(this, xiaohang.zhimeng.FlightPreferenceActivity.class);
-
-
-
- this.startActivityForResult(intent, 0);
- }else if (item.getItemId() == R.id.menu_quit) {
-
- finish();
- }
- return true;
- }
-
-
- @Override
- protected void onActivityResult(int requestCode, int resultCode, Intent data) {
- super.onActivityResult(requestCode, resultCode, data);
- setOptionText();
- }
-
- private void setOptionText(){
-
-
-
-
-
-
- SharedPreferences prefs = getSharedPreferences("xiaohang.zhimeng_preferences", 0);
-
- String option = prefs.getString(this.getResources().getString(R.string.selected_flight_sort_option), this.getResources().getString(R.string.flight_sort_option_default_value));
-
- String[] optionText = this.getResources().getStringArray(R.array.flight_sort_options);
-
- tv.setText("option value is " + option + "(" + optionText[Integer.parseInt(option)] + ")");
- }
- }
如果大家對(duì)這里比較陌生,,比如 SharedPreferences 是神馬東西,可以參考這 兩篇文章,。
http://byandby./blog/837601 http://byandby./blog/833292
在下邊就是我們的AndroidManifest.xml文件了,,倒也沒(méi)啥特別的,。
- <?xml version="1.0" encoding="utf-8"?>
- <manifest xmlns:android="http://schemas./apk/res/android"
- package="xiaohang.zhimeng" android:versionCode="1" android:versionName="1.0">
- <uses-sdk android:minSdkVersion="10" />
-
- <application android:icon="@drawable/icon" android:label="@string/app_name">
- <activity android:name=".MainActivity" android:label="@string/app_name">
- <intent-filter>
- <action android:name="android.intent.action.MAIN" />
- <category android:name="android.intent.category.LAUNCHER" />
- </intent-filter>
- </activity>
-
- <activity android:name=".FlightPreferenceActivity"
- android:label="@string/prefTitle">
- <intent-filter>
- <action android:name="xiaohang.zhimeng.intent.action.FlightPreferences" />
- <category android:name="android.intent.category.PREFERENCE" />
- </intent-filter>
- </activity>
- </application>
- </manifest>
OK,當(dāng)我們完成了上邊的所有 運(yùn)行應(yīng)用程序,,首先會(huì)看到一個(gè)簡(jiǎn)單的文本消息,,顯示 “option value is 1(# of Stops)”。單擊 Menu按鈕,,然后在點(diǎn)擊 Settings,就會(huì)打開(kāi)我們的首選項(xiàng)視圖 FlightPreferenceActivity ,,然后我們更改首選項(xiàng)的值,然后再點(diǎn)擊 back按鈕 就會(huì)看到我們修改后的值了,。
大家可能會(huì)問(wèn),,那Android把我們修改后的數(shù)據(jù)存儲(chǔ)在哪里了呢?前面已經(jīng)提到 Android framework還會(huì)負(fù)責(zé)持久化首選項(xiàng),。例如,,當(dāng)用戶選擇一個(gè)排序選項(xiàng)時(shí), Android會(huì)選擇存儲(chǔ)在應(yīng)用程序 /data 目錄下的一個(gè)XML 文件中,,見(jiàn)下圖,。
實(shí)際的文件路徑為 /data/data/[PACKAGE_NAME]/shared_prefs/[PACKAGE_NAME]_preferences.xml。我們需要 看看這個(gè)文件里邊到底存了些什么,? 導(dǎo)出這個(gè)文件就可以看到了,。哦 不對(duì),不用這樣 太麻煩了,, 我們 去 shell 里邊 用 cat 讀一下就行了,,見(jiàn)下圖。
一看便知,,是以鍵值對(duì)的方式存取,,就寫到這里了,明天寫 CheckBoxPreference,,最近IO大會(huì)很火熱啊,,聽(tīng)說(shuō) Google 還要讓Android控制 家電,害怕中,。,。。
|