Android官方開發文檔Training系列課程中文版：建構第一款安卓應用之工程建立

這節課你将會學到：

你也應該閱讀：

安卓項目包含了包括源代碼在内的所有檔案。Android SDK工具使我們很輕松的建立一個包含一系列預設目錄和檔案的的安卓工程。

這堂課展示了如何通過Android Studio或者使用SDK指令行工具建立一個新工程。

你應該確定安裝了SDK，如果你使用Android Studio的話，你也應該去安裝Android Studio，如果你還沒有完成這些，請完成。

在Android Studio中，建立一個新工程：

如果你還沒有打開工程，在Welcome螢幕中，點選New Project.

如果你打開了一個工程，在File菜單上選擇New Project.

在配置你的新工程界面中，像上圖一樣填入你的資訊，然後點選Next。

Application Name 是應用的名稱，在這裡，使用“My First App”。

Compay domain 提供了限定符，稍後它會出現在包名中。

Package name 是工程的全辨別符名稱。你的包名必須在安卓系統中是唯一的。

Project location 是你的工程項目檔案存儲目錄。

接下來選擇應用将要運作的形式平台，這裡選擇 Phone and Tablet。

對于Minimum SDK，選擇API 8: Android 2.2 (Froyo).

Minimum Required SDK 是指你的應用所支援的最低版本。為了盡可能的支援更多的裝置，你應該在你應用所允許的範圍之内将這個值設定到最低。如果任何可能不是核心功能的特性隻允許在新的安卓版本上運作，你可以選擇隻在支援的裝置上運作。

不選擇其它選項（TV, Wear, and Glass）,然後點選Next。

接下來關于 Add an activity to < template >，這裡選擇Blank Activity，然後點選Next。

接下來Choose options for your new file中，選擇Activity Name 為 MyActivity. The Layout Name更換為activity_my,Title設定為MyActivity. The Menu Resource Name設為menu_my.

點選Finish按鈕完成工程的建立。

現在你的安卓工程包含了一些基于“Hello World”應用的預設檔案。稍後我們複習一下這些最重要的東西：

app/src/main/res/layout/activity_my.xml 這個XML是Activity的布局檔案，在建立工程的過程中，AS提供了包含TextView的布局檔案，和UI的螢幕預覽。這個檔案包含了一些預設的設定和一個TextView元素用來展示”Hello World”消息。

app/src/main/java/com.mycompany.myfirstapp/MyActivity.java 當在工程建立模闆完成建立的時候，這個檔案便會出現。當你建構并且運作APP時，Activity類便會啟動一個Activity并且加載布局檔案，然後顯示一個 “Hello World!”。

app/src/main/AndroidManifest.xml manifest file檔案描述了應用的最基本特性，并定義了每一個元件，你在接來下将會重複範文這個檔案，然後添加更多的元件到這裡。

app/build.gradle Android Studio使用Gradle去編譯并且建構你的App，你工程的每一個元件都會有這個檔案，整個工程也會有這麼一個檔案。通常情況下，你應該隻對元件下對的gradle檔案有興趣。這裡包括了用用的建構依賴資訊，包括一些defaultConfig設定： - compiledSdkVersion 表示你應用編譯依靠的編譯平台版本。預設情況下，這裡設定的是你SDK中最新的版本。 - applicationId 是在你建立工程過程中指定的用于标示你程式的辨別符的全稱。 - minSdkVersion 标示應用的最低支援版本 - targetSdkVersion 标示對于應用測試過的最高支援版本，如果有新版本可用了，你應該在最新的版本上進行測試，并且更新這個值到最新的版本。

注意一下工程目錄中/res檔案夾下的子檔案夾的相關資源： drawable< density >/ 圖像檔案夾(比如位圖)為應付各種密度而設計，比如中等密度(mdpi)和高密度(hdpi) 螢幕，其它圖像檔案夾包含了其它螢幕密度的圖像資源。在這裡你會找到在你啟動預設APP時候的啟動圖檔ic_launcher.png. layout/ 該檔案夾為應用的使用者布局檔案夾，就像activity_my.xml，剛才在上面已經讨論過了，它描述了MyActivity 類的最基本布局。 menu/ 該檔案夾定義了應用的菜單配置 該檔案夾是其它類型資源檔案夾，它包含了一系列的資源，比如字元串和顔色屬性。string.xml檔案定義了你啟動預設APP時候的”Hello World!”。

我們會在下節讨論如何運作APP。

如果你沒有使用IDE AS，你可以使用SDK 工具中的指令行來建立項目：

1. 更換目錄到安卓SDK sdk/ 路徑下。

2. 執行：

tools/android list targets 這時會列出你下載下傳的可用的安卓平台版本，找到你想編譯的平台版本，我們推薦盡可能選擇最高的版本，你仍然可以建構你的APP去支援老版本，但是如何設定了最新的版本，那麼最好使用含有最新版本系統的裝置。 如果你沒有看到任何的清單列出來，你應該使用Android SDK Manager 工具來下載下傳安裝。

3 . 執行以下指令：

用剛剛你選擇的目标編譯平台替換< target-id >屬性，使用你想儲存工程目錄的位置替換 < path-to-workspace >。

Tip: 添加 platform-tools/ 和 tools/ 目錄到你的環境變量PATH中去。

現在你的安卓工程已經建立好了，它包含基于”Hello World！”應用的一些預設的檔案，關于如何運作程式，請看下一節。