Android SDK 上手指南：示例項(xiàng)目

Android SDK 示例項(xiàng)目中的應(yīng)用能夠執(zhí)行種種功能，例如各類用戶界面元素、數(shù)據(jù)管理、交互、媒體及連接使用說明等。即使大家不打算在自己的開發(fā)過程中用到示例所包含的某些特定應(yīng)用類型，其中的大部分功能仍然適用于其它不同類型的應(yīng)用。

介紹 Android SDK 示例項(xiàng)目中的應(yīng)用能夠執(zhí)行種種功能，例如各類用戶界面元素、數(shù)據(jù)管理、交互、媒體及連接使用說明等。即使大家不打算在自己的開發(fā)過程中用到示例所包含的某些特定應(yīng)用類型，其中的大部分功能仍然適用于其它不同類型的應(yīng)用?？偠灾@些示例資源值得大家值得探索一番。

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

http://wiki.jikexueyuan.com/project/android-sdk/images/29.png" alt="" />

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

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

http://wiki.jikexueyuan.com/project/android-sdk/images/30.png" alt="" />

選擇一個(gè)創(chuàng)建目標(biāo)并點(diǎn)擊“Next”。

http://wiki.jikexueyuan.com/project/android-sdk/images/31.png" alt="" />

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

http://wiki.jikexueyuan.com/project/android-sdk/images/32.png" alt="" />

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

http://wiki.jikexueyuan.com/project/android-sdk/images/33.png" alt="" />

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

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

http://wiki.jikexueyuan.com/project/android-sdk/images/34.png" alt="" />

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

第三步 在花時(shí)間瀏覽過其它 Manifest 內(nèi)容之后，打開 Notepad 應(yīng)用 src 文件夾下的 NoteList Activity。

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

http://wiki.jikexueyuan.com/project/android-sdk/images/35.png" alt="" />

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

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

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

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

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

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

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

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

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

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

原文鏈接：

http://mobile.tutsplus.com/tutorials/android/android-sdk-samples/