翻譯:趙錕
原文：http://www.smashingmagazine.com/2011/03/28/get-started-developing-for-android-with-eclipse-reloaded/

在我們教程系列的第一部分中，我們使用android和eclipse開發了一個簡單的飲茶計時器的應用程序。在第二部分，我們將繼續開發這個程序，并給它增加一些其他的額外的功能。在開發的過程中，我們將給你介紹更多重要而強大的android sdk特性，包括持久化數據存儲，activity和intent，和共享用戶首選項（譯者注：類似于windows 的注冊表的一種機制）。

跟著本教程，你需要上一篇教程中的代碼，如果你想直接使用代碼，你可以使用如下的指令從github上check out出tutorial_par_1標記的代碼：

$ git clone git://github.com/cblunt/brewclock.git
$ cd brewclock
$ git checkout tutorial_part_1

在github中檢出了代碼后，你需要將代碼倒入到eclipse中的項目中：

1. 運行 eclipse 選擇 file → import…
2. 在導入窗口, 選擇 “existing projects into workspace”并點擊 “next.”
3. 在下一屏，點擊 “browse,”選擇你從github上clone出的代碼目錄。
4. 點擊“finish” 將項目導入到eclipse中。

在導入項目到eclipse之后，你有可能會看到有如下的警告信息：

android required .class compatibility set to 5.0.
please fix project properties.

如果有這種情況，右鍵點擊“project explorer ”中新導入的brewclock項目，并選擇 “fix project properties,” 并重啟eclipse。

數據持久化入門

當前,brewclock 讓用戶為他們泡的茶設置一個定時器。這個非常棒的一個工作，但是如果對于不同的茶使用同一個泡茶時間的結果會怎樣呢，是不每種茶都應該有自己的一個泡茶時間呢？如果這樣，那豈不是所有的用戶都需要記下每一類茶所需要泡的時間！這不是一個很好的用戶體驗。因此，在這篇教程中，我將新增一個功能來為用戶每種不同的茶葉存放一個泡茶時間，并當用戶想泡茶的時候，可以從茶葉列表中進行選擇。

為了實現這個目的，我們得利用android的豐富的數據持久化的api。android提供了幾種方式來存儲數據，本文將要覆蓋其中的兩種方式。第一種，使用sqlite數據庫引擎來為我們存儲數據。

sqlite 是一種流行的輕量級sql數據庫引擎，它將數據存在單個文件中。sqlite經常用于桌面或在那些運行不能運行客戶端-服務器sql引擎（例如mysql或postgresql)的嵌入式的應用上。

每個安裝在android上的應用都可以保存和使用多個sqlite數據庫文件（由數據存儲容量決定），這些數據由系統自動地進行管理。應用程序的數據是私有并且不能被其他的應用程序所訪問。（數據可以通過contentprovider(譯者注：內容提供者類)類進行共享，但是我們不會在本教程中覆蓋關于內容提供者的內容）。當數據應用程序被更新時，數據庫文件就進行持久化，當應用程序被刪除時，數據庫文家就被刪除。

我們在brewclock應用使用sqlite數據來維護我們的茶葉列表和泡茶所需要的時間。下面是我們我們將使用的數據表的一個總體介紹。

+-------------------------------------+
| table: teas                         |
+------------+------------------------+
| column     | description            |
+------------+------------------------+
| _id        | integer, autoincrement |
| name       | text, not null         |
| brew_time  | integer, not null      |
+------------+------------------------+

如果以前你使用過sql，你應該熟悉這些內容。數據表有三個字段，一個唯一標示（_id），茶葉名稱(name)和泡茶時間(brew_time)字段。我們將使用android提供給我們的api在應用中建立數據表。系統將負責在正確的位置為我們的創建數據庫文件。

抽象數據庫

為了確保數據庫的代碼容易被維護，我們用一個單獨的類teadata來抽象所有處理數據庫創建，插入，和查詢的代碼。如果你熟悉模型-試圖-控制(譯者注：mvc)方法的話，這個你也應該熟悉。所有數據庫代碼與我們的brewclockactitvity類隔離開來。actitvity可以初始化一個新的teadata實例（這個實例將連接數據庫）并完成它所需要的工作。以這種方式工作保證了我們可以方便的更改我們所使用的數據庫而不用修改其他那些和數據庫不相關部分的代碼。

通過菜單file → new → class.在brewclock項目中創建一個teadata的新類。確保teadata擴展于android.database.sqlite.sqliteopenhelper 類，并選中“constructors from superclass”復選框。

teadata 類將為你自動地處理sqlite數據庫的創建和版本。我們需要增加一些方法來作為其他代碼到數據庫的接口。

增加兩個常量來存儲數據庫的名字和版本,增加表名和表中列名。我們使用android提供的常類basecolumns._id來做為表的唯一id列：

// src/com/example/brewclock/teadata.java
import android.app.activity;
import android.content.contentvalues;
import android.content.context;
import android.database.cursor;
import android.database.databaseutils;
import android.provider.basecolumns;

public class teadata extends sqliteopenhelper {
  private static final string database_name = "teas.db";
  private static final int database_version = 1;

  public static final string table_name = "teas";

  public static final string _id = basecolumns._id;
  public static final string name = "name";
  public static final string brew_time = "brew_time";

  // …
}

為teadata增加一個構造方法，以數據庫名稱合版本號為參數調用其父類的構造方法。android將會自動地打開數據庫（如果數據庫不存在就自動創建它）。

// src/com/example/brewclock/teadata.java
public teadata(context context) {
  super(context, database_name, null, database_version);
}

我們需要重載oncreate方法，并執行一個sql 串執行創建數據庫表的操作。android將會在數據庫文件第一次被創建時調用這個方法。

在啟動過程中，android檢查數據庫的版本是否我們傳入的版本一致。如果版本發生了改變，android將會調用onupgrade方法，在這個方法總，你可以編寫修改數據庫結構的業務邏輯。在本教程中，我們將讓android刪除數據庫并重建數據庫。

在oncreate和onupgrade中增加如下的代碼:

// src/com/example/brewclock/teadata.java
@override
public void oncreate(sqlitedatabase db) {
  // create table teas (id integer primary key autoincrement, name text not null, brew_time integer);
  string sql =
    "create table " + table_name + " ("
      + _id + " integer primary key autoincrement, "
      + name + " text not null, "
      + brew_time + " integer"
      + ");";

  db.execsql(sql);
}

@override
public void onupgrade(sqlitedatabase db, int oldversion, int newversion) {
  db.execsql("drop table if exists " + table_name);
  oncreate(db);
}

下一步，我們需要新增代碼讓我們方便地在數據庫中新增茶葉記錄。我們新增一個帶茶葉名稱和泡茶時間的方法來負責插入記錄。android為了盡量避免開發者使用sql語句，提供了一堆類來處理向數據庫中查入記錄。首先，我們創建一個contentvalues集合，并將相關的值插入到這個集合中去。

對于contentvalues集合，我們只要簡單地提供一個列名和值來插入就行了。android負責創建和運行正確的sql。使用android的數據類確保了你能寫出安全，跨平臺的數據庫操作代碼。

add a new method, insert(), to the teadata class:

// src/com/example/brewclock/teadata.java
public void insert(string name, int brewtime) {
  sqlitedatabase db = getwritabledatabase();

  contentvalues values = new contentvalues();
  values.put(name, name);
  values.put(brew_time, brewtime);

  db.insertorthrow(table_name, null, values);
}

查詢數據

我們應用程序具有了在數據庫中保存數據的能力后，我們同樣也需要一種方式將數據取回來。android提供了游標cursor接口來完成這件工作。一個游標代表了針對數據庫運行一個sql返回的結果集，游標在這個結果集中維護了一個指針來指向結果集中的一行。這個指針可以向前，向后移動，并返回每一列的值，下面我們用圖形來幫助你理解游標:

sql 查詢: select * from teas limit 3;

+-----------------------------------+

|  _id  |  name       |  brew_time  |

+-----------------------------------+

|    1  |  earl grey  |          3  |

|    2  |  green      |          1  | <= cursor

|    3  |  assam      |          5  |

+-------+-------------+-------------+

在這個例子中，游標指向了結果集中的第二條記錄（綠茶）。我們可以通過調用cursor.movetoprevious()方法，將游標向前移動，讓它指向第一行（earl grey），或者調用movetonext向前移動指向assam。要取到游標所指向記錄的茶葉的名稱，我們只要調用cursor.getstring(1)，1代表我們向提取數據列的下標（注意下標識從0開始的，1代表第二列，依次類推）。

在了解游標后，我們增加一個創建游標對象并返回數據庫中所有的茶葉信息。在teadata中增加all方法：

// src/com/example/brewclock/teadata.java
public cursor all(activity activity) {
  string[] from = { _id, name, brew_time };
  string order = name;

  sqlitedatabase db = getreadabledatabase();
  cursor cursor = db.query(table_name, from, null, null, null, null, order);
  activity.startmanagingcursor(cursor);

  return cursor;
}

因為這個方法乍一看有點古怪，所以讓我們先來關心一下這個方法的一些細節。我們沒有使用sql的查詢語句，而是使用了android提供的數據庫接口方法。

第一，我們需要告訴android，我們所關心的列的信息。我們創建了一個字符串數組，數組中存放這teadata中列的標示信息。我們還設置了我名們期望的結果集按照哪一個列進行排序的列名。

第二，我們使用getreadalbedatabase()創建了一個到數據庫的只讀連接，并調用query方法告訴android我們希望用query方法運行一個查詢。query()方法有很多的參數，android在內部將這些參數轉化為一個查詢語句。此外，android的抽象層保證了即使底層數據儲存機制發生了變化，我們的應用程序代碼也能正確的工作。

由于我們只要返回表中的所有記錄，所以我們沒有在方法中使用到鏈接join，過濾filter和分組group（例如：在sql中的where，join，和group by）。from和order變量告訴查詢數據庫需要返回那些列和提取數據時按什么列進行排序。我們使用sqlitedatabase.query()作為和數據庫的人機交互接口。

最后，我們讓activity（在本例中，我們的brewclockactivity）來管理游標。通常，游標需要人工刷新內容，因此當我們增加一個新茶信息到數據庫中時，我們就需要刷新我們的游標。每當我們的應用被掛起和恢復的時候，通過調用startmanagingcursor()讓android來幫我們重建結果集。

在teadata類中增加count方法:

// src/com/example/brewclock/teadata.java
  public long count() {
    sqlitedatabase db = getreadabledatabase();
    return databaseutils.querynumentries(db, table_name);
  }

保存teadata類，使用修正沒有import 的類(source → organize imports)，在完成我們的數據類后，下一步我們將著手修改我們brewclock的人機界面。

修改brewclock用戶界面，允許進行茶葉選擇

持久化茶和泡茶的時間的目的是讓用能快速的選擇他們所鐘愛的預設置的茶。為了完成這個功能，我們需要再brewclock的主界面上增加一個spinner（類似于桌面上彈出菜單），生成一個來自于teadata的茶列表。

和前面的教程一樣，我們使用了eclipse的布局器編輯器在brewclock的主界面布局xml文件中增加spinner。在linearlayout元素下面增加下面這些代碼（大約在24行）。如果你打開了可視化的布局編輯器后，你可以點擊窗口下面的地”code view”進行切換。

<!-- /res/layout/main.xml -->

<!-- tea selection -->
<linearlayout
  android:orientation="vertical"
  android:layout_width="fill_parent"
  android:layout_height="wrap_content">

  <spinner
    android:id="@+id/tea_spinner"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content" />

</linearlayout>

在brewclockactivity類里面,增加一個成員變量指向spinner，通過使用findviewbyid連接界面上的控件：

// src/com/example/brewclock/brewclockactivity.java
protected spinner teaspinner;
protected teadata teadata;

// …

public void oncreate(bundle savedinstancestate) {
  // …
  teadata = new teadata(this);
  teaspinner = (spinner) findviewbyid(r.id.tea_spinner);
}

運行你的程序以確保新的界面正確地生效。你應該在泡茶計數器下看見一個空白的彈出式菜單（或者是spinner)。如果點擊spinner，android將顯示一個彈出式的菜單并為你提供選擇列表。在這時，菜單的內容因該是空的，現在讓我們來綁定spinner和我們的茶葉數據庫。

數據綁定

當android從數據庫中查詢數據時，它將會返回一個游標cursor對象。cursor代表了來自數據庫的結果集，并可以移動游標來提取結果中的數據。使用一類android提供的稱為“適配器adapter”的類，我們很容易將這個結果集綁定到spinner上。適配器完成了提取數據庫結果集中的數據并在界面上顯示這些數據等這些復雜而困難工作。

在我們的teadata.all()方法中已經可以返回一個帶有tea表內容的游標，使用這個游標，我們所需要做的工作就是創建一個simplecursor適配器來綁定我們的teaspinner，android會負責處理將數據顯示在spinner的列表中。

通過創建一個simplecursoradapter類來連接spinner與teadata.all()返回的游標：

// com/example/brewclock/brewclockactivity.java

public void oncreate(bundle savedinstancestate) {
  // …
  cursor cursor = teadata.all(this);

  simplecursoradapter teacursoradapter = new simplecursoradapter(
    this,
    android.r.layout.simple_spinner_item,
    cursor,
    new string[] { teadata.name },
    new int[] { android.r.id.text1 }
  );

  teaspinner.setadapter(teacursoradapter);
  teacursoradapter.setdropdownviewresource(android.r.layout.simple_spinner_dropdown_item);
}

注意，我們使用了android內建的android.r對象。這個對象提供了你的應用程序中的默認資源，例如視圖和布局。在我們的代碼中，我們使用了android.r.layout.simple_spinner_item，它是簡單的文本標簽布局。

如果你再次運行的應用程序，你將會看到spinner中仍然是空的！雖然我們已經連接了我們的數據庫，但是由于數據庫中沒有任何記錄，所以我們任何看到了空列表。

我們通過在構造方法中增加一些默認記錄來讓用戶可以選擇所需要的茶葉，為了避免重復記錄，我們只有在數據庫中記錄為0的情況才增加默認記錄。在本教程的代碼中，我們使用前面增加的count()來檢查數據庫中表記錄是否為空。

增加當數據庫中表為空的默認記錄代碼。把這些代碼增加從數據庫提取茶葉數據的前面（譯者注：上一段的代碼前）。

// com/example/brewclock/brewclockactivity.java
public void oncreate(bundle savedinstancestate) {
  // …

  // add some default tea data! (adjust to your preference :)
  if(teadata.count() == 0) {
    teadata.insert("earl grey", 3);
    teadata.insert("assam", 3);
    teadata.insert("jasmine green", 1);
    teadata.insert("darjeeling", 2);
  }

  // code from the previous step:
  cursor cursor = teadata.all(this);

  // …
}

現在再次運行你的應用程序。你將會發現茶葉spinner有了一條選擇。點擊spinner讓你可以從數據庫選擇你要的茶葉。

恭喜你！你已經成功關聯了你的界面和代碼。這是任何軟件開發過程中一個非常重要的方面。正如你所看見的，android將這一步簡化的非常容易，但是功能有是非常的nb。使用游標和適配器，你可以將數據源（叢簡單的字符串數組到復雜的數據庫查詢）綁定到任何類型的視圖：spinner或列表，設置是類似itunes cover-flow gallery!

雖然現在已經可以開始泡茶了，但是我們工作還遠沒有結束。當你從spinner選擇了不同的茶，這個選擇卻不會發生任何作用。我們需要根據用戶所選茶葉的種類取更新我們的泡茶時間。

讀取選中茶葉數據并更新泡茶時間

為了能讀取用戶從數據庫中選擇茶葉的數據，我們必須增加一個針對此事件的監聽器。類似于處理按鈕點擊事件的onclicklistener監聽器一樣，我們將實現一個onitemselectedlistener。當用戶從視圖中做出一個選擇的事件將觸發這個監聽器，例如從我們的spinner。

在brewclockactivity中增加需要實現的接口onitemselectedlistener。并增加其響應的處理方法onitemselected()和onnothingselected()：

// src/com/example/brewclock/brewclockactivity.java
public class brewclockactivity extends activity implements onclicklistener, onitemselectedlistener {
  // …
  public void onitemselected(adapterview<?> spinner, view view, int position, long id) {
    if(spinner == teaspinner) {
      // update the brew time with the selected tea’s brewtime
      cursor cursor = (cursor) spinner.getselecteditem();
      setbrewtime(cursor.getint(2));
    }
  }

  public void onnothingselected(adapterview<?> adapterview) {
    // do nothing
  }
}

在這里我們要檢查是觸發的spinner此事件是不是brewclock的teaspinner。如果是，我們將提取代表選中記錄的游標對象。這些都是由關聯teadata和spinner的simplecursoradapter來提供我們完成的。android知道哪個查詢產生的spinner數據，也知道用戶選擇的哪個數據。android使用游標來返回數據庫的一行記錄，也代表了用戶所選擇的茶葉數據。

cursor的getint()方法帶了一個我們想提取的列的下標為參數。在我們的teadata.all()方法中創建游標的時候，我們讀取的列是_id,name和brew_time。假設我們在teaspinner中選擇的是jasmine tea，那么將返回我們所選數據所對應的數據庫記錄。

然后我們再通過傳遞參數2來選擇此記錄的第二列的整型值。這個值提供給setbrewtime()方法。這個方法用于更新界面上的泡茶時間。

最后，我們需要告訴teaspinner brewclockactivity正在監聽onitemselected事件。在brewclockactivity的oncreate方法中增加下面的代碼：

// src/com/example/brewclock/brewclockactivity.java
public void oncreate() {
  // …
  teaspinner.setonitemselectedlistener(this);
}

大功告成！再次運行你的程序，并從spinner選擇不同的茶葉。每次你所選的茶葉它所對應的泡茶時間都回顯示對應的界面上。我們余下的代碼中已經可以處理從當前時間開始遞減計數。所以在有預先設置的茶葉種類下，我們已經可以完成我們所想要的功能。

你當然可以，回到之前的代碼中去增加一些茶葉種類你滿足你的口味。但是如果你發布brewclock程序到android market，每當有人向增加新的茶葉數據到數據庫中，我就需要去手動的取更新數據中的內容并重新發布它；這樣所有的人就必須去更新它，并且所有的人都有一個同樣的列表。這聽起來非常的不靈活，因此我們還有很多的工作需要完成！

如果用戶自己有方法新增茶葉種類到數據庫里面，將會非常的不錯的做法。因此我們將在下一章繼續。。。

activity 介紹

和你應用程序中每個屏幕關聯的代碼就是activity。每次當你從一屏切換到另外一屏，android就會創建一個新的activity。在真實世界中，雖然一個應用程序經常由多個屏幕/activity構成，andriod卻將每個屏幕看作獨立的個體。多個activity工作在一起形成一種關聯的體驗，這是因為android讓你非常容易地在屏幕/activity之間傳遞數據。

在本節最后，你將為你的應用程序新增一個新的activity（addteaactivity）并將它注冊到android系統中。你還需要從最初的brewclockactivity傳遞數據到新的activity中。

首先，我們需要給用戶一種方式切換到新的activity上。我們將使用選項菜單來完成之一步。

選項菜單

當用戶他們的設備上的“menu”按鍵時，選項菜單以彈出菜單的形式出現。android負責菜單的自動創建和顯示；你只需要告訴android，菜單顯示什么內容和當用戶點擊菜單時該做什么就行。

然而,最好不要在代碼中硬編碼菜單的標題，我們可以使用android的字符串資源。字符串資源是一個獨立的文件，在這個文件中你可以維護所有用于用戶閱讀的字符串和標簽資源，并可以在代碼調用它們。這就意味著當你在未來需要修改字符串時，你只要修改這一處地方即可。.

在project explorer中導航到“res/values”下，你將會看到string.xml文件已經存在。這個是你再創建新項目的時候由eclipse創建的，這文件存放著在整個應用程序我們將要使用的字符串。

雙擊打開strings.xml ,通過窗口底部的選項頁切換到xml 視圖。

在<resources>…</resources> 元素中增加下面的內容:

<!-- res/values/strings.xml -->
  <resources>
    <!-- … -->
    <string name="add_tea_label">add tea</string>
  </resources>

我們在這里定義了一個字符串，add_tea_label和它關聯的文本，我們可以在整個程序代碼中通過add_tea_label來使用其關聯的文本。如果標簽因為某個原因需要修改，我們只需要在這個文件修改這一個地方就能完成整個程序的修改。

下一步，讓我們創建一個新文件完成選項菜單的定義，如果字符串和布局一樣，菜單也使用xml來定義。因此我們將在eclipse中川建一個新的xml文件：

通過選擇file → new → other, 并選擇“android xml file.”在eclipse中創建一個新的xml文件。

選擇資源的類型為 “menu”，保存文件名為main.xml。eclipse將為你自動的創建一個目錄res/menu, 來存放你的菜單文件。

打開res/menus/main.xml 文件, 通過窗口底部的“main.xml”選項頁來切換到xml視圖。

增加菜單項， add_tea。

<!-- res/values/strings.xml -->
  <resources>
    <!-- … -->
    <string name="add_tea_label">add tea</string>
  </resources>

注意android:title 屬性被設置為@string/add_tea_label。這告訴android在我們的strings.xml文件中查找add_tea_label并返回相關聯的標簽內容。在本列中我們的菜單項的標簽時“add tea”。

下一步，我們將告訴我們的activity，當用戶點擊設備上的“memu”按鍵時來顯示這個選項菜單。

返回brewclockactivity.java代碼, 重載oncreateoptionsmenu 方法,這個方法告訴android 當用戶點擊“menu”按鍵時，裝載我們的菜單：

// src/com/example/brewclock/brewclockactivity.java
@override
public boolean oncreateoptionsmenu(menu menu) {
  menuinflater inflater = getmenuinflater();
  inflater.inflate(r.menu.main, menu);

  return true;
}

當用戶點擊他設備上的“menu”按鍵時，android將調用oncreateoptionsmenu。在這個方法中，我們創建了一個menuinflater, 這個對象將從你的應用程序包中裝載你的菜單資源。就如同按鈕和文本域組成你的應用程序布局一樣，main.xml資源也是通過全局對象r來生效的，因此我們將此對象提交給menuinflater對象。

為了測試菜單，保存并在模擬器中并運行應用程序。當程序運行起來使，點擊“menu”按鍵，你將會看到一個彈出式的菜單顯示了一個“add tea”選項。

如果你點擊“add tea”選項，android自動地檢測到點擊并關閉菜單。在后臺，android將會提醒應用程序選項已經被點擊。

處理菜單點擊

當用戶點擊 “add tea” 菜單選項，我們想要顯示一個新的activity以便我們能進入增加新茶葉種類的界面。通過選擇file → new → class來創建一個的activiy。

將新類命名為 addteaactivity,并確保它繼承于android.app.activity類。這個類也放在com.example.brewclock包中:

// src/com/example/brewclock/addteaactivity.java
package com.example.brewclock;

import android.app.activity;
import android.os.bundle;

public class addteaactivity extends activity {
  @override
  public void oncreate(bundle savedinstancestate) {
    super.oncreate(savedinstancestate);
  }
}

上面樣例中的空白activity將不會完成任何工作。但是通過它，我們已經可以完成選項菜單的功能。

在brewclockactivity增加一個重載方法onoptionsitemselected 。當用戶點擊菜單項時，這個方法被android調用。 (注意點擊的menuitem為它的接收參數：

// src/com/example/brewclock/brewclockactivity.java
@override
public boolean onoptionsitemselected(menuitem item) {
  switch(item.getitemid()) {
    case r.id.add_tea:
      intent intent = new intent(this, addteaactivity.class);
      startactivity(intent);
      return true;

    default:
      return super.onoptionsitemselected(item);
  }
}

通過上面的代碼，我們告訴android，當“add tea”被點擊的時候，我們將要創建一個的activity；在本教程中，就是addteaactivity。然而，不要直接創建這個類的實例，注意我們使用了intent。intent有著android框架的強大特性；他們將activity綁定在一起來組成應用程序，并允許在他們之間相互傳遞數據。

intent的優點甚至讓你的應用程序可以使用用戶安裝的其他的應用程序。例如，當用戶要從圖庫里面顯示一張圖片，android自動地給顯一個對話框來讓用戶選擇應用程序來顯示圖片。任何注冊為可以處理圖片顯示的應用程序都會出現在這個對話框的列表中。

intent功能強大而復雜的主體, 因此它值得你從官方的文檔official android sdk documentation中仔細研究。

讓我們運行我們的應用程序，以測試我們的“add tea”屏幕。

運行你的項目，按下menu按鍵，并點擊 “add tea.”。

不如你預期的，你并沒有看到 “add tea” activity，出現在你面前的是一個android開發者經常看到的對話框：

雖然我們創建了一個intent并告訴android啟動我們的addteaactivity activity, 由于我們沒有將這個activity注冊到android系統中，我們的應用程序最終還是crash掉了。系統不知道從哪里去找到我們試圖運行的activity（應該還記得intent可以啟動安裝在設備上的任何activity吧）。讓我們在應用程序的mainfest文件來注冊這些acitivity。

打開應用的manifest文件，在eclipse中的androidmanifest.xml。通過窗口底部的“androidmanifest.xml”選項頁切換到xml視圖

應用程序的mainfest文件是保存你應用程序全局設置和信息的地方。你將會看見里面已經有一個.brewclockactivity 的activity聲明，并且這個activity在程序運行的時候啟動。

在<application>中, 增加一個 <activity> 節點，描述為“add tea”的 activity. 使用我們早先在strings.xml聲明的 add_tea_label字符串作為這個activity的標題：

<!-- androidmanifest.xml -->
<application …>
  …
  <activity android:name=".addteaactivity" android:label="@string/add_tea_label" />
</application>

在你再次運行brewclock保存這個manifest文件。這一次，當你打開菜單并點擊“add tea,”時android將會啟動addteaactivity。按下back按鍵返回主屏幕。

完成了activity的關聯，下一步我們將要開發一個增加新茶的界面！

開發茶葉編輯器界面

開發一個增加茶葉界面和上一個教程中開發的brewclock主界面是非常相似的。首先要創建一個布局文件，然后在按照下面的講解添加適合的xml內容。

和主界面開發所有不同的是，你可以使用android最近改進的eclipse布局編輯器來開界面。創建一個新的xml文件來定義你的布局。從菜單file → new然后選擇 “android xml file,” 選擇 “layout”類型。并將文件命令為add_tea.xml。

用下面的布局內容替換add_tea.xml 文件的內容：

<!-- res/layouts/add_tea.xml -->
<?xml version="1.0" encoding="utf-8"?>
<linearlayout
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="fill_parent"
  android:layout_height="fill_parent"
  android:orientation="vertical"
  android:padding="10dip">

  <textview
    android:text="@string/tea_name_label"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content" />

  <edittext
    android:id="@+id/tea_name"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"/>

  <textview
    android:text="@string/brew_time_label"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

  <seekbar
    android:id="@+id/brew_time_seekbar"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:progress="2"
    android:max="9" />

  <textview
    android:id="@+id/brew_time_value"
    android:text="3 m"
    android:textsize="20dip"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal" />
</linearlayout>

為了這個界面上使用的字符串，我們同樣也需要在strings.xml 中增加一些新的內容：

<!-- res/values/strings.xml -->
<resources>
  <!-- … -->
  <string name="tea_name_label">tea name</string>

  <string name="brew_time_label">brew time</string>
</resources>

在這個布局中，我們加了一個新的界面控件類型，seekbar。這個控件可以讓用戶通過從左向右拖拉一個指示器thumb，非常容易的指定泡茶時間。這個值得范圍從0到android:max。

在這個界面中，我們使用刻度是0到9，意思是從1分鐘到10分鐘（泡0分鐘茶等于是浪費好茶）。第一，我們需要確保addteaactivity能正確地加載我們的界面:

在activity的oncreate()方法中增加下面的代碼用于加載和顯示add_tea布局文件：

// src/com/example/brewclock/addteaactivity.java
public void oncreate(bundle savedinstancestate) {
  super.oncreate(savedinstancestate);
  setcontentview(r.layout.add_tea);
}

現在通過運行項目來測試你的應用程序，按下“menu”按鍵，并點擊“add tea”菜單。

你將從“add tea”屏幕上看到你的新界面。你可以在文本域中輸入文字和從左到右拖動seekbar。但是由于我們沒有增加相關代碼，這個界面并沒有實現什么具體的功能。

在addteaactivity中增加下面這些屬性，并關聯到我們界面上元素：

// src/com/example/brewclock/addteaactivity.java
public class addteaactivity {
  // …

  /** properties **/
  protected edittext teaname;
  protected seekbar brewtimeseekbar;
  protected textview brewtimelabel;

  // …

下一步,關聯屬性和你的界面：

public void oncreate(bundle savedinstancestate) {
  // …
  // connect interface elements to properties
  teaname = (edittext) findviewbyid(r.id.tea_name);
  brewtimeseekbar = (seekbar) findviewbyid(r.id.brew_time_seekbar);
  brewtimelabel = (textview) findviewbyid(r.id.brew_time_value);
}

界面非常的簡單，我們只要增加相應seekbar 改變事件的監聽器。當用戶從左到右移動seekbar指示器時，我們的應用程序需要讀出新值并更新seekbar之下泡茶時間標簽的內容。我們將使用一個監聽器來檢測seekbar何時改變的：

在addteaactivity類聲明中增加實現 onseekbarchangedlistener接口，并添加所必要的方法：

// src/com/example/brewclock/addteaactivity.java
public class addteaactivity
extends activity
implements onseekbarchangelistener {
  // …

  public void onprogresschanged(seekbar seekbar, int progress, boolean fromuser) {
    // todo detect change in progress
  }

  public void onstarttrackingtouch(seekbar seekbar) {}

  public void onstoptrackingtouch(seekbar seekbar) {}
}

我們唯一感興趣的事件時onprogresschanged，因此我們需要在這個方法內增加代碼更新泡茶時間標簽的內容為seekbar選中的值。之前我們說過seekbar的刻度是0到9，因此我們需要將seekbar的加1的值來顯示給用戶才有意義。

在addteaactivity.java代碼中增加如下的onprogresschanged()代碼：

// src/com/example/brewclock/addteaactivity.java
public void onprogresschanged(seekbar seekbar, int progress, boolean fromuser) {
  if(seekbar == brewtimeseekbar) {
    // update the brew time label with the chosen value.
    brewtimelabel.settext((progress + 1) + " m");
  }
}

在addteaactivity的oncreate方法中設置監聽器：

// src/com/example/brewclock/addteaactivity.java
public void oncreate(bundle savedinstancestate) {
  // …

  // setup listeners
  brewtimeseekbar.setonseekbarchangelistener(this);
}

現在運行你的程序，并拖動seekbar,泡茶時間標簽的內容將會同步更新為正確地值：

保存新增茶葉

完成了增加茶葉界面之后,剩下的工作就是讓用戶可以將他們新增的茶葉保存到數據庫中.我們將會對界面上輸入數據增加一點校驗,以避免茶葉名為空的數據被保存到數據庫中！

在編輯器中打開strings.xml 增加一些我們在應用程序將要使用到的新標簽。

<!-- res/values/strings.xml -->
<string name="save_tea_label">save tea</string>
<string name="invalid_tea_title">tea could not be saved.</string>

<string name="invalid_tea_no_name">enter a name for your tea.</string>

如同前面的那樣，我們需要為addteaactivity創建一個新的選項菜單來讓用戶可以執行保存茶葉的指令：

在res/menus 目錄，通過選擇file → new 并選 other → android xml 文件來創建一個新的 add_tea.xml xml文件, 記住資源類型為“menu”。

增加保存茶葉的菜單項：

<!-- res/menus/add_tea.xml -->
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
  <item android:title="@string/save_tea_label" android:id="@+id/save_tea" />
</menu>

返回 addteaactivity 代碼中,類似你在brewclockactivity中一樣，增加重載方法oncreateoptionsmenu 和onoptionsitemselected。唯一的區別是這次你提供的menuinflater的資源文件名是add_tea.xml ：

// src/com/example/brewclock/addteaactivity.java
@override
public boolean oncreateoptionsmenu(menu menu) {
  menuinflater inflater = getmenuinflater();
  inflater.inflate(r.menu.add_tea, menu);

  return true;
}

@override
public boolean onoptionsitemselected(menuitem item) {
  switch(item.getitemid()) {
    case r.id.save_tea:
      savetea();

    default:
      return super.onoptionsitemselected(item);
  }
}

下一步, 增加新方法, savetea(), 來保存茶葉信息。savetea 首先從界面上讀取茶葉的名稱和用戶所選的泡茶時間，如果這些輸入數據都能通過驗證，就將這些數據保存到數據庫中：

// src/com/example/brewclock/addteaactivity.java
public boolean savetea() {
  // read values from the interface
  string teanametext = teaname.gettext().tostring();
  int brewtimevalue = brewtimeseekbar.getprogress() + 1;

  // validate a name has been entered for the tea
  if(teanametext.length() < 2) {
    alertdialog.builder dialog = new alertdialog.builder(this);
    dialog.settitle(r.string.invalid_tea_title);
    dialog.setmessage(r.string.invalid_tea_no_name);
    dialog.show();

    return false;
  }

  // the tea is valid, so connect to the tea database and insert the tea
  teadata teadata = new teadata(this);
  teadata.insert(teanametext, brewtimevalue);
  teadata.close();

  return true;
}

大段的代碼，讓我們過一遍這段代碼的邏輯。

首先，我們從文本框中讀取茶葉名稱，從seekbar讀取泡茶時間（記著讀的時間要加1以保證時間在1到10分鐘之內）。下一步，我們驗證茶葉名大于等于2個字符（這是非常簡單的驗證，如果想做更復雜的驗證，那么就使用正則表達式吧）。

如果茶葉名稱非法，我們需要讓用戶知道。我們使用android提供的工具類，alertdialog.biulder類，這個類給我們提供了一個快捷創建和顯示模態窗口的方法。在設置完標題和錯誤信息后，通過調用show方法來顯示對話框。這個對話框是模態的modal，因此用戶只有按下back按鍵，這個對話框才會關閉。在這時，我們不想保存任何數據，所以我們的方法返回了false。

如果茶名稱合法，我們通過teadata類創建一個到茶葉數據庫的臨時連接。這里又一次的顯示出把數據庫訪問抽象成一個獨立文件的好處：你可以從任何地方完成對數據庫（譯者注：其實應該是對teadata 類）的訪問。

當調用完teadata.insert() 來增加記錄到數據庫后，我們不再需要數據庫連接，因此在我們返回成功前，我們關閉了連接。

在模擬器中運行你的程序，按下“menu”按鍵，點擊屏幕上的“add tea”。試圖通過在此按下“menu”和點擊屏幕的 “save tea.”來保存空茶葉名的茶葉數據。由于是沒有茶葉名，一條錯誤消息將出現在你的面前：

下一步，試著鍵入你的茶葉名，并選擇合適的泡茶時間，再次從菜單選擇 “save tea” 。這一次，你將不在看到錯誤的消息。事實上，你什么都看消息不到。

改進用戶體驗

這樣做不是一個很好的用戶體驗，用戶不能知道他的茶葉是否已經成功地保存了。事實上，用戶只有從“add tea”界面返回，去茶葉列表中查看這一個辦法來檢查他的是否成功的被保存。這樣的做法不好，讓用戶知道他們的茶葉數據被成功地保存會是更好的一種方式。在茶葉數據被成功保存后，讓我們在屏幕上顯示一條成功信息。

我們要一條被動的非模態化的信息，因此alertdialog這次就不能滿足我們的需求了。下面我們將要使用另外一個android的非常流行的特性，toast。

toast 在接近屏幕的下方顯示一條消息，但是并不會終止用戶的操作。toast經常用于做非重要的的提醒和狀態更新。.

在strings.xml 資源文件中新增一個字符串。注意字符串中的%s。我們在下一步中將保存的茶葉名字結合到這個字符串來顯示信息。

<!-- res/values/strings.xml -->
<string name="save_tea_success">%s tea has been saved.</string>

注意，在onoptionsitemselected 代碼中進行修改，當savetea返回真時，創建并顯示一條彈出式的toast。第二參數getstring()用來連接茶葉名稱到toast信息中。最后，我們需要將茶葉名稱清楚，以便用戶可以快速增加更多的新茶。

// src/com/example/brewclock/addteaactivity.java
// …
switch(item.getitemid()) {
 case r.id.save_tea:
   if(savetea()) {
     toast.maketext(this, getstring(r.string.save_tea_success, teaname.gettext().tostring()), toast.length_short).show();
     teaname.settext("");
   }
// …

現在，重新運行應用程序，并增加和保存一些新茶葉。你將會看到彈出式的toast并讓你知道你的茶葉信息已經被保存成功。getstring()方法用于連接存在xml文件中的string和茶葉名稱，并將%s替換成茶葉的名稱。

按下“back”按鍵，返回應用程序的主屏幕，點擊茶葉spinner。你新增的在數據庫中的茶葉已近可以顯示在spinner的選項中！

用戶首選項

現在brewclock已經完成了所有的功能。用戶可以增加他們喜愛的茶葉和各自不同的泡茶時間到數據庫中，并且他們可以快速的從選擇他們并開始泡上一杯新茶。任何新增的茶葉信息都被保存在數據庫中，因此，即使你退出你的程序，這些茶葉信息在你下次啟動程序時仍然可以從spinner列表中找到。

當你重啟brewclock的時候，有一件事你必須注意，就是泡茶計數被清為了0。這使得跟蹤我們每天喝了多少茶（一條重要的數據）變得困難。作為最后一個練習，讓我們將泡茶計數保存在我們設備上。

我們將不通過增加茶葉數據庫的表來完成這個功能，我們將使用android的“共享首選項shared preferences”，一個android提供給你應用程序用于存儲簡單數據的數據庫（字符串，數字，等等）。例如，優秀的最高分和用戶首選項等（譯者注：非常類似windows下的注冊表）。

我們首先在brewclockactivity.java 中增加一堆常量。這些常量用于存放你的共享首選項的名稱。我們將使用鍵的名稱來訪問泡茶計數。android負責保存和持久化我們的共享首選項文件。

// src/com/example/brewclock/brewclockactivity.java

protected static final string shared_prefs_name = "brew_count_preferences";

protected static final string brew_count_shared_pref = "brew_count";

下一步，為了我們能在用戶首選項中讀寫泡茶計數，而不是直接的依賴于代碼中的初始值，我們將在代碼中做一些修改。在brewclockactivity 的 oncreate 方法中我們將就該setbrewcount附件的代碼：

// src/com/example/brewclock/brewclockactivity.java
public void oncreate() {
  // … 

  // set the initial brew values
  sharedpreferences sharedpreferences = getsharedpreferences(shared_prefs_name, mode_private);
  brewcount = sharedpreferences.getint(brew_count_shared_pref, 0);
  setbrewcount(brewcount);

  // …
}

這里我們將以使用sharedpreference來獲取應用程序的共享首選項的實例，并希望得到brew_count鍵值的值（通過我們之前定義的brew_count_shared_pref常量來標示）。如果值能獲取，這個值將返回給應用程序，如果沒有我們使用getint的第二參數作為默認值返回（在教程中為0）。

現在我們取得存儲的泡茶計數值，我們需要確保每當泡茶計數更新的時候，這個值能寫回到共享首選項中。

brewclockactivity的setbrewcount中增加下面的代碼：

// src/com/example/brewclock/brewclockactivity.java
 public void setbrewcount(int count) {
   brewcount = count;
   brewcountlabel.settext(string.valueof(brewcount));

   // update the brewcount and write the value to the shared preferences.
   sharedpreferences.editor editor = getsharedpreferences(shared_prefs_name, mode_private).edit();
   editor.putint(brew_count_shared_pref, brewcount);
   editor.commit();
 }

共享首選項不能直接地保存。我們需要使用android的sharedpreferences.editor類。調用sharedpreferences的edit方法，返回一個editor實例，這個實例用來保存我們的首選項值。我們只要調用editor實例的commit方法就可以將值保存到共享首選項中。

我們應用程序的所有代碼都已完成，現在讓我們測試一下我們的程序！

在模擬器中運行應用程序，定一個泡茶時間（這真是一個良好的借口去泡一杯你自己愛喝的茶哦）并退出應用程序，試著運行模擬器上的安裝的其他應用程序確保brewclock被終止。記住，除非這個應用程序已經不在內存中，否則android不會終止一個activity。

當你下一次運行你的應用程序時，你將看見之前的泡茶計數已經被維護了。

總結

恭喜!你已經完成了這個應用的程序的所有開發工作,并使用了android　sdk中的數個核心組件。在本教程中，你從中學到了：

• 創建一個簡單的sqlite數據庫，并保存你的數據；
• 使用android的數據庫類和編寫客戶化類抽象數據訪問；
• 在你的應用程序中增加選項菜單。；
• 在你應用程序中創建并注冊新activity并使用intent將他們綁定成一組界面；
• 使用內建的“共享首選項”數據庫來保存和提取簡單用戶數據。

無論你要開發神馬樣類型的應用程序，數據存儲和持久化是一個重要的主題。從工具程序和業務工具到3-d游戲，幾乎每個應用程序都需要使用到android提供的數據工具類。

activities

雖然brewclock現在在某方面來說已經是個功能完善的應用程序了。但是我們仍然可以在增加一些功能以改進用戶體驗。例如你可以使用下面的方法來改進你的應用程序：

• 在保存茶葉的時候檢查是否存在茶葉名稱重名；
• 增加一個菜單選項以將泡茶統計清0；
• 在共享首選項中保存最后所選的泡茶名稱和時間以便程序重啟時有一個有意義的默認值；
• 增加用戶從茶葉數據庫中刪除記錄的選項。

在github庫 可以獲取到所有的源代碼，庫中的未來的分支包含著activitiy的解決方案 你可以通過切換你的本地代碼拷貝到tutorial_2分支，下載這個開發教程源代碼：

$ git clone git://github.com/cblunt/brewclock.git

$ cd brewclock

$ git checkout tutorial_2

我希望你喜歡這個教程，希望這個教程能幫助你設計和開發更棒的android應用程序。請通過在下面的回復讓我知道你的建議和意見，當然我也歡迎你將你建議寫在email中并發送給我。

感謝anselm的建議和反饋！

（全文完）