为地震Viewer创建一个Preference页

   

在第5章，你已经创建了一个地震监视器，它能基于Internet种子显示出最近的地震列表。

 

在接下来的例子里，你将为这个地震Viewer创建一个Preference页，来允许用户配置应用程序设定来获得更加个性的体验。你将为程序提供以下功能：自动更新、更新频率和最小地震级别的过滤。

 

在本章的后面，你将进一步扩展这个例子，通过创建一个Content Provider来保存地震数据和与其它应用程序共享数据。

 

1. 打开你在第5章创建的Earthquake工程。

 

添加“Preference”屏幕中显示标签的字符串资源。另外，为新的菜单项添加一个字符串，来允许用户访问Preference屏幕。

 

<?xml version=”1.0” encoding=”utf-8”?>

<resources>

<string name=”app_name”>Earthquake</string>

<string name=”quake_feed”>

http://earthquake.usgs.gov/eqcenter/catalogs/1day-M2.5.xml

</string>

<string name=”menu_update”>Refresh Earthquakes</string>

<string name=”auto_update_prompt”>Auto Update?</string>

<string name=”update_freq_prompt”>Update Frequency</string>

<string name=”min_quake_mag_prompt”>Minimum Quake Magnitude</string>

<string name=”menu_preferences”>Preferences</string>

</resources>

 

2. 创建一个新的preferences.xml layout资源，来未Preferences Activity布局UI。包括一个Checkbox来显示“自动更新”的切换，Spinner来选择更新的频率和级别过滤。

 

<LinearLayout

xmlns:android=”http://schemas.android.com/apk/res/android”

android:orientation=”vertical”

android:layout_width=”fill_parent”

android:layout_height=”fill_parent”>

<TextView

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

android:text=”@string/auto_update_prompt”

/>

<CheckBox android:id=”@+id/checkbox_auto_update”

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

/>

<TextView

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

android:text=”@string/update_freq_prompt”

/>

<Spinner

android:id=”@+id/spinner_update_freq”

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

android:drawSelectorOnTop=”true”

/>

<TextView

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

android:text=”@string/min_quake_mag_prompt”

/>

<Spinner

android:id=”@+id/spinner_quake_mag”

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”

android:drawSelectorOnTop=”true”

/>

<LinearLayout

android:orientation=”horizontal”

android:layout_width=”fill_parent”

android:layout_height=”wrap_content”>

<Button

android:id=”@+id/okButton”

android:layout_width=”wrap_content”

android:layout_height=”wrap_content”

android:text=”@android:string/ok”

/>

<Button

android:id=”@+id/cancelButton”

android:layout_width=”wrap_content”

android:layout_height=”wrap_content”

android:text=”@android:string/cancel”

/>

</LinearLayout>

</LinearLayout>

 

3. 在/res/values/arrays.xml文件中创建四个数组资源。它们负责提供更新频率和最小级别的值。

 

<?xml version=”1.0” encoding=”utf-8”?>

<resources>

<string-array name=”update_freq_options”>

<item>Every Minute</item>

<item>5 minutes</item>

<item>10 minutes</item>

<item>15 minutes</item>

<item>Every Hour</item>

</string-array>

<array name=”magnitude”>

<item>3</item>

<item>5</item>

<item>6</item>

<item>7</item>

<item>8</item>

</array>

<string-array name=”magnitude_options”>

<item>3</item>

<item>5</item>

<item>6</item>

<item>7</item>

<item>8</item>

</string-array>

<array name=”update_freq_values”>

<item>1</item>

<item>5</item>

<item>10</item>

<item>15</item>

<item>60</item>

</array>

</resources>

 

4. 创建Preferences Activity。它将用于显示应用程序的Preference。重写onCreate方法来显示第2步中创建的layout，并且获得Checkbox和两个Spinner控件的引用。然后调用一下populateSpinners方法。

 

package com.paad.earthquake;

import android.app.Activity;

import android.content.SharedPreferences;

import android.content.SharedPreferences.Editor;

import android.os.Bundle;

import android.view.View;

import android.widget.ArrayAdapter;

import android.widget.Button;

import android.widget.CheckBox;

import android.widget.Spinner;

 

public class Preferences extends Activity {

CheckBox autoUpdate;

Spinner updateFreqSpinner;

Spinner magnitudeSpinner;

 

@Override

public void onCreate(Bundle icicle) {

super.onCreate(icicle);

setContentView(R.layout.preferences);

updateFreqSpinner = (Spinner)findViewById(R.id.spinner_update_freq);

magnitudeSpinner = (Spinner)findViewById(R.id.spinner_quake_mag);

autoUpdate = (CheckBox)findViewById(R.id.checkbox_auto_update);

populateSpinners();

}

 

private void populateSpinners() {

}

}

 

5. 填充populateSpinners方法，使用ArrayAdapter绑定每个Spinner到相应的数组上。

 

private void populateSpinners()

{

// Populate the update frequency spinner

ArrayAdapter<CharSequence> fAdapter;

fAdapter = ArrayAdapter.createFromResource(this, R.array.update_freq_options,

android.R.layout.simple_spinner_item);

fAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);

updateFreqSpinner.setAdapter(fAdapter);

 

// Populate the minimum magnitude spinner

ArrayAdapter<CharSequence> mAdapter;

mAdapter = ArrayAdapter.createFromResource(this, R.array.magnitude_options,

android.R.layout.simple_spinner_item);

mAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);

magnitudeSpinner.setAdapter(mAdapter);

}

 

6. 为Shared Preference的标识添加公共的静态字符串值，以及为每个Preference值添加键值。更新onCreate方法，来获取保存的Shared Preference，并调用updateUIFromPreferences方法。在updateUIFromPreferences方法，通过get<type>方法获得在Shared Preference中保存的值并更新到当前UI上。

 

public static final String USER_PREFERENCE = “USER_PREFERENCES”;

public static final String PREF_AUTO_UPDATE = “PREF_AUTO_UPDATE”;

public static final String PREF_MIN_MAG = “PREF_MIN_MAG”;

public static final String PREF_UPDATE_FREQ = “PREF_UPDATE_FREQ”;

SharedPreferences prefs;

 

@Override

public void onCreate(Bundle icicle) {

super.onCreate(icicle);

setContentView(R.layout.preferences);

updateFreqSpinner = (Spinner)findViewById(R.id.spinner_update_freq);

magnitudeSpinner = (Spinner)findViewById(R.id.spinner_quake_mag);

autoUpdate = (CheckBox)findViewById(R.id.checkbox_auto_update);

populateSpinners();

prefs = getSharedPreferences(USER_PREFERENCE, Activity.MODE_PRIVATE);

updateUIFromPreferences();

}

 

private void updateUIFromPreferences() {

boolean autoUpChecked = prefs.getBoolean(PREF_AUTO_UPDATE, false);

int updateFreqIndex = prefs.getInt(PREF_UPDATE_FREQ, 2);

int minMagIndex = prefs.getInt(PREF_MIN_MAG, 0);

updateFreqSpinner.setSelection(updateFreqIndex);

magnitudeSpinner.setSelection(minMagIndex);

autoUpdate.setChecked(autoUpChecked);

}

 

7. 在onCreate方法中，为OK和Cancel按钮添加事件处理函数。Cancel关闭Activity，而OK应该先调用savePreferences方法。

 

@Override

public void onCreate(Bundle icicle) {

super.onCreate(icicle);

setContentView(R.layout.preferences);

updateFreqSpinner = (Spinner)findViewById(R.id.spinner_update_freq);

magnitudeSpinner = (Spinner)findViewById(R.id.spinner_quake_mag);

autoUpdate = (CheckBox)findViewById(R.id.checkbox_auto_update);

populateSpinners();

prefs = getSharedPreferences(USER_PREFERENCE, Activity.MODE_PRIVATE);

updateUIFromPreferences();

 

Button okButton = (Button) findViewById(R.id.okButton);

okButton.setOnClickListener(new View.OnClickListener() {

public void onClick(View view)

{

savePreferences();

Preferences.this.setResult(RESULT_OK);

finish();

}

});

 

Button cancelButton = (Button) findViewById(R.id.cancelButton);

cancelButton.setOnClickListener(new View.OnClickListener() {

public void onClick(View view)

{

Preferences.this.setResult(RESULT_CANCELED);

finish();

}

});

}

 

private void savePreferences() {

}

 

8. 填充savePreference方法来记录当前的设置项，把UI的选择结果存到Shared Preference对象中。

 

private void savePreferences() {

int updateIndex = updateFreqSpinner.getSelectedItemPosition();

int minMagIndex = magnitudeSpinner.getSelectedItemPosition();

boolean autoUpdateChecked = autoUpdate.isChecked();

Editor editor = prefs.edit();

editor.putBoolean(PREF_AUTO_UPDATE, autoUpdateChecked);

editor.putInt(PREF_UPDATE_FREQ, updateIndex);

editor.putInt(PREF_MIN_MAG, minMagIndex);

editor.commit();

}

 

9. 以上完成了Preferences Activity。为了能在应用程序中能访问它，应将其添加到应用程序的manifest中。

 

<activity android:name=”.Preferences”

android:label=”Earthquake Preferences”>

</activity>

 

10. 现在，回到Earthquake Activity中，为显示Preferences Activity添加菜单项。扩展onCreateOptionsMenu方法，在其中添加一个新的项目来打开Preferences Activity。

 

static final private int MENU_PREFERENCES = Menu.FIRST+1;

@Override

public boolean onCreateOptionsMenu(Menu menu) {

super.onCreateOptionsMenu(menu);

menu.add(0, MENU_UPDATE, Menu.NONE, R.string.menu_update);

menu.add(0, MENU_PREFERENCES, Menu.NONE, R.string.menu_preferences);

return true;

}

 

11. 修改onOptionsItemSelected方法，当选择新的菜单项时显示Preferences Activity。创建一个显式的Intent，并将其传入startActivityForResult中。它将启动Preferences画面，并在其保存后通过onActivityResult处理函数通知Earthquake类。

 

private static final int SHOW_PREFERENCES = 1;

public boolean onOptionsItemSelected(MenuItem item) {

super.onOptionsItemSelected(item);

switch (item.getItemId())

{

case (MENU_UPDATE):

{

refreshEarthquakes();

return true;

}

case (MENU_PREFERENCES):

{

Intent i = new Intent(this, Preferences.class);

startActivityForResult(i, SHOW_PREFERENCES);

return true;

}

}

return false;

}

 

12. 启动应用程序，从Activity 菜单中选择Preferences。Preferences Activity应该显示如图6-1.

 

图6-1

 

13. 所有剩下来的就是应用设置到Earthquake上。自动更新的实现将留到第8章，在那里，你将学习如何使用Service和后台线程。现在，你可以在适当的位置添加框架代码，并应用地震级别过滤。

 

14. 创建updateFromPreferences方法并读取Shared Preference中的值，将这些值存到实例的变量中。

 

int minimumMagnitude = 0;

boolean autoUpdate = false;

int updateFreq = 0;

private void updateFromPreferences()

{

SharedPreferences prefs = getSharedPreferences(Preferences.USER_PREFERENCE, Activity.MODE_PRIVATE);

int minMagIndex = prefs.getInt(Preferences.PREF_MIN_MAG, 0);

if (minMagIndex < 0)

minMagIndex = 0;

int freqIndex = prefs.getInt(Preferences.PREF_UPDATE_FREQ, 0);

if (freqIndex < 0)

freqIndex = 0;

autoUpdate = prefs.getBoolean(Preferences.PREF_AUTO_UPDATE, false);

Resources r = getResources();

 

// Get the option values from the arrays.

int[] minMagValues = r.getIntArray(R.array.magnitude);

int[] freqValues = r.getIntArray(R.array.update_freq_values);

 

// Convert the values to ints.

minimumMagnitude = minMagValues[minMagIndex];

updateFreq = freqValues[freqIndex];

}

 

15. 通过更新addNewQuake方法来应用级别过滤。在将Quake对象添加到list之前检查一下Quake的级别。

 

private void addNewQuake(Quake _quake) {

if (_quake.getMagnitude() > minimumMagnitude)

{

// Add the new quake to our list of earthquakes.

earthquakes.add(_quake);

// Notify the array adapter of a change.

aa.notifyDataSetChanged();

}

}

 

16. 重写onActivityResult方法，当保存了Preferences Activity的变更后调用updateFromPreferences方法和refresh方法。

 

@Override

public void onActivityResult(int requestCode, int resultCode,Intent data)

{

super.onActivityResult(requestCode, resultCode, data);

if (requestCode == SHOW_PREFERENCES)

if (resultCode == Activity.RESULT_OK) {

updateFromPreferences();

refreshEarthquakes();

}

}

 

17. 最后，在onCreate方法中调用updateFromPreferences（在调用refreshEarthquake方法之前），确保设置项在Activity第一次启动时应用了。

 

@Override

public void onCreate(Bundle icicle) {

super.onCreate(icicle);

setContentView(R.layout.main);

earthquakeListView = (ListView)this.findViewById(R.id.earthquakeListView);

earthquakeListView.setOnItemClickListener(new OnItemClickListener() {

public void onItemClick(AdapterView _av, View _v, int _index, long arg3)

{

selectedQuake = earthquakes.get(_index);

showDialog(QUAKE_DIALOG);

}

});

int layoutID = android.R.layout.simple_list_item_1;

aa = new ArrayAdapter<Quake>(this, layoutID, earthquakes);

earthquakeListView.setAdapter(aa);

updateFromPreferences();

refreshEarthquakes();

}

转载于:https://www.cnblogs.com/xirihanlin/archive/2009/08/06/1540424.html