第十五章 示例項目

第十五章 示例項目

Android SDK示例項目中的應用能夠執(zhí)行種種功能，例如各類用戶界面元素、數據管理、交互、媒體及連接使用說明等。即使大家不打算在自己的開發(fā)過程中用到示例所包含的某些特定應用類型，其中的大部分功能仍然適用于其它不同類型的應用。總而言之，這些示例資源值得大家探索一番。

1. 安裝

第一步

要在Eclipse當中直接使用Android示例項目，大家首先需要確保自己已經將其正確安裝到位。在“Android SDK Manager”當中選擇“Window”，在拉下來的軟件包列表當中大家會在每個API級別的文件夾當中找到不同示例——選擇最新的一個然后將其展開。如果其中的“Samples for SDK”尚未安裝，現在就將其選中并安裝。

示例項目安裝完成之后，大家就可以在Eclipse當中直接找到它們了。請記住，我們在本系列教程的前幾篇文章中談到過如何利用SDK Manager保持Android SDK工具處于最新狀態(tài)，因此請各位在當前擁有可更新內容時馬上進行安裝。

2. 創(chuàng)建示例項目

第一步

大家可以在Eclipse當中創(chuàng)建一個示例項目，從而查看該示例中的代碼并在物理或者虛擬設備上加以運行。這樣我們就能通過復制和粘貼來借用示例當中所涉及的算法，或者通過解讀與學習把握概念、今后用在自己的應用程序當中。要在Eclipse當中創(chuàng)建示例項目，需依次選擇“File”、“New”然后是“Project”。展開Android文件夾之后，選擇“Android Sample Project”然后點擊“Next”。

選擇一個創(chuàng)建目標并點擊“Next”。

現在大家可以從示例列表當中作出選擇，其中包括早期遺留示例——大部分屬于全功能應用，包含我們可能在首次應用開發(fā)工作中所需要的處理流程類型。大家可以在業(yè)余時間慢慢研究這些示例，但作為初次接觸、我們這里先選擇“Notpad”示例并點擊“Finish”。

Eclipse會在我們的工作區(qū)當中利用示例代碼創(chuàng)建應用，過程與創(chuàng)建我們自己開發(fā)的應用一樣。完成后，大家應該可以在自己的Package Explorer當中找到Notepad應用了。展開該應用的文件夾，我們還可以進一步查看其中的內容。

第二步

大家可以花點時間看看示例項目當中所包含的各個文件，其中包括Manifest、source doe以及resource files，例如布局、可繪制對象、值以及菜單等。Notepad應用對于初學者來說算是很好的資源，大家可以通過它了解Android平臺上很多常見的功能類型?，F在讓我們打開Manifest文件并切換到XML選項卡。

大家不要被示例文件當中復雜的文件結構所嚇倒。如果各位在Eclipse View當中查看這些內容，特別是采用Outline View，肯定會看到它們與我們在前幾篇文章中開發(fā)過的應用擁有同樣的整體結構。

源文件當中通常包含大量代碼注釋，因此如果大家不能確定特定代碼段的具體含義、完全可以從注釋當中得到解答。在Outline View當中展開元素，我們會看到NotesList Activity將以應用程序main launcher Activity的形式被詳細列出。由于這是在系統(tǒng)上進入應用程序的主要入口，因此我們可以將其作為很好的應用源代碼探索起點。

第三步

在花時間瀏覽過其它Manifest內容之后，打開Notepad應用src文件夾下的NoteList Activity。

如大家所見，所有源代碼都擁有良好的注釋，不僅該類的作用擁有詳盡說明、其中每個方法以及各方法的組成部分也經過了解釋。下面請在Outine View當中查看onCreate方法。

大家可以很直觀地發(fā)現，onCreate方法中的代碼與之前我們所看到的ListActivity只存在細微的差別。我們發(fā)現列表當中的每個條目都會引用同一種布局，也就是noteslist item。打開應用程序的res布局文件夾并找到該布局。大家可以在該布局條目的標記與圖形視圖之間進行切換，這一點我們之前也已經說明過了。

大家可以利用這種通用型方式探索所有示例應用，即瀏覽各種組成元素、以邏輯方式遵循引用關系逐步查看各個源文件。

第四步

大家可以在物理設備或者Android虛擬設備（簡稱AVD）上運行這些示例應用，具體方式與運行自己開發(fā)的應用程序完全相同。讓我們再次捋清思路：接入一臺設備或者啟動AVD，而后進入Run Configurations。在其中選擇Android Application，點擊New按鈕并利用Browse按鈕定位要運行的示例應用。如大家所示，運行示例應用的過程與運行自己創(chuàng)建的應用并無二致。

如果大家在開發(fā)應用程序時用到了與示例應用當中類似的功能，則可以將示例應用內容打開并安置在自己的應用旁邊，從而以此為參考開發(fā)自己的算法。Notepad示例這類應用程序當中包含多種非常典型的處理過程，例如通過Content Provider處理數據——我們可以在NotePadProvider類當中看到這部分代碼。示例應用的設計初衷在于向開發(fā)者展示如何在Android平臺上完成特定任務，因此大家在遵循《Android開發(fā)者指南》的說明時這些示例能夠起到很好的輔助作用。

提示：當我們使用Android SDK當中的早期遺留示例時，會發(fā)現Eclipse顯示關于廢棄代碼的警告信息。這是因為早期遺留示例是針對早期SDK版本創(chuàng)建的。如果大家希望使用被Eclipse列為“不推薦”的任何功能，請首先查看新版本Android SDK中是否提供更新更有效的替代方案。

第五步

請大家隨意探索SDK示例中的代碼內容，很多示例內容的含義都非常清晰。不過有時候其內容功能與示例名稱之間的關系可能沒什么直接聯系。其中最值得關注的示例要數APi Demos，大家可以按前面介紹的方法在Notepad應用列表中找到它。

先利用APi Demos示例啟動一個示例項目，如前文所述將其在Package Explorer當中展開，然后打開src文件夾。該應用會被拆分為多個包，各自對應不同的功能類型。我們可以從這里看到并學到很多實用的知識。打開其中一個包，查看它所包含的各個類。與其它示例代碼一樣，這部分代碼同樣擁有詳盡而明確的注釋，能夠幫助大家理解每個類及方法的實際作用。API Demos應用當中包含圖形、動畫、媒體、安全以及可訪問性幾大功能。

3. 示例的其它使用方法

在Eclipse當中創(chuàng)建示例項目是最簡單也最實用的學習方法，能夠幫助大家透徹掌握Android SDK所提示的說明性代碼內容。不過我們還可以通過其它方式來充分利用SDK示例代碼。大家可以在自己的計算機上從ADT Bundle目錄中找到各個示例項目的具體文件。在其中的sdk文件夾內，大家會看到一個名為samples的文件夾。我們在各個平臺層面上已經安裝過的示例都能在這里找到，而且它們都擁有自己的專有文件夾。在該文件夾中，大家還會看到被劃分為不同示例類型的文件夾。我們可以通過這種方式瀏覽、打開并與源代碼文件進行交互。

在Android開發(fā)者網站的Samples部分，大家可以下載并查看該平臺上的各種示例代碼。這些示例旨在與利用Gradle創(chuàng)建的Android Studio相協(xié)作。大家可以下載完整的項目并將其導入至Android Studio當中，從而在該IDE下與這些內容進行交互或者將應用運行在Android設備之上。

總結

Android示例當中包含大量功能。盡管其中一部分早期遺留內容現在看起來有點過時，但作為學習材料仍然具備良好的價值。如果大家發(fā)現自己打算開發(fā)的功能在示例項目中已經存在，那正好能省下大量的開發(fā)時間——只需對SDK給出的內容稍加改動即可。在本系列的下一篇文章中，我們將探討在應用程序開發(fā)并測試結束之后，該如何將成果發(fā)布出去。