創(chuàng)建Android項(xiàng)目

編寫:yuanfentiank789 - 原文:http://developer.android.com/training/basics/firstapp/creating-project.html

一個Android項(xiàng)目包含了所有構(gòu)成Android應(yīng)用的源代碼文件。

本小節(jié)介紹如何使用Android Studio或者是SDK Tools中的命令行來創(chuàng)建一個新的項(xiàng)目。

Note：在此之前，我們應(yīng)該已經(jīng)安裝了Android SDK，如果使用Android Studio開發(fā)，應(yīng)該確保已經(jīng)安裝了Android Studio。否則，請先閱讀 Installing the Android SDK按照向?qū)瓿砂惭b步驟。

使用Android Studio創(chuàng)建項(xiàng)目

1. 使用Android Studio創(chuàng)建Android項(xiàng)目，啟動Android Studio。

• 如果我們還沒有用Android Studio打開過項(xiàng)目，會看到歡迎頁，點(diǎn)擊New Project。
• 如果已經(jīng)用Android Studio打開過項(xiàng)目，點(diǎn)擊菜單中的File，選擇New Project來創(chuàng)建一個新的項(xiàng)目。

2. 參照圖1在彈出的窗口（Configure your new project）中填入內(nèi)容，點(diǎn)擊Next。按照如圖所示的值進(jìn)行填寫會使得后續(xù)的操作步驟不不容易差錯。

• Application Name此處填寫想呈現(xiàn)給用戶的應(yīng)用名稱，此處我們使用“My First App”。
• Company domain 包名限定符，Android Studio會將這個限定符應(yīng)用于每個新建的Android項(xiàng)目。
• Package Name是應(yīng)用的包命名空間（同Java的包的概念），該包名在同一Android系統(tǒng)上所有已安裝的應(yīng)用中具有唯一性，我們可以獨(dú)立地編輯該包名。
• Project location操作系統(tǒng)存放項(xiàng)目的目錄。

圖1 Configure your new project

3. 在Select the form factors your app will run on窗口勾選Phone and Tablet。

4. Minimum SDK, 選擇 API 8: Android 2.2 (Froyo). Minimum Required SDK表示我們的應(yīng)用支持的最低Android版本，為了支持盡可能多的設(shè)備，我們應(yīng)該設(shè)置為能支持你應(yīng)用核心功能的最低API版本。如果某些非核心功能僅在較高版本的API支持，你可以只在支持這些功能的版本上開啟它們(參考兼容不同的系統(tǒng)版本),此處采用默認(rèn)值即可。

5. 不要勾選其他選項(xiàng) (TV, Wear, and Glass) ，點(diǎn)擊 Next.

6. 在Add an activity to 窗口選擇Basic Activity，點(diǎn)擊 Next.

7. 在Choose options for your new file 窗口修改Activity Name 為MyActivity，修改 Layout Name 為activity_my，Title 修改為MyActivity，Menu Resource Name 修改為menu_my。

8. 點(diǎn)擊Finish完成創(chuàng)建。

剛創(chuàng)建的Android項(xiàng)目是一個基礎(chǔ)的Hello World項(xiàng)目，包含一些默認(rèn)文件，我們花一點(diǎn)時間看看最重要的部分：

app/src/main/res/layout/activity_my.xml

這是剛才用Android Studio創(chuàng)建項(xiàng)目時新建的Activity對應(yīng)的xml布局文件，按照創(chuàng)建新項(xiàng)目的流程，Android Studio會同時展示這個文件的文本視圖和圖形化預(yù)覽視圖，該文件包含一些默認(rèn)設(shè)置和一個顯示內(nèi)容為“Hello world!”的TextView元素。

app/src/main/java/com.mycompany.myfirstapp/MyActivity.java

用Android Studio創(chuàng)建新項(xiàng)目完成后，可在Android Studio看到該文件對應(yīng)的選項(xiàng)卡，選中該選項(xiàng)卡，可以看到剛創(chuàng)建的Activity類的定義。編譯并運(yùn)行該項(xiàng)目后，Activity啟動并加載布局文件activity_my.xml，顯示一條文本："Hello world!"

app/src/main/AndroidManifest.xml

manifest文件描述了項(xiàng)目的基本特征并列出了組成應(yīng)用的各個組件，接下來的學(xué)習(xí)會更深入了解這個文件并添加更多組件到該文件中。

app/build.gradle

Android Studio使用Gradle 編譯運(yùn)行Android工程. 工程的每個模塊以及整個工程都有一個build.gradle文件。通常你只需要關(guān)注模塊的build.gradle文件，該文件存放編譯依賴設(shè)置，包括defaultConfig設(shè)置：

• compiledSdkVersion 是我們的應(yīng)用將要編譯的目標(biāo)Android版本，此處默認(rèn)為你的SDK已安裝的最新Android版本(目前應(yīng)該是4.1或更高版本，如果你沒有安裝一個可用Android版本，就要先用SDK Manager來完成安裝)，我們?nèi)匀豢梢允褂幂^老的版本編譯項(xiàng)目，但把該值設(shè)為最新版本，可以使用Android的最新特性，同時可以在最新的設(shè)備上優(yōu)化應(yīng)用來提高用戶體驗(yàn)。
• applicationId 創(chuàng)建新項(xiàng)目時指定的包名。
• minSdkVersion 創(chuàng)建項(xiàng)目時指定的最低SDK版本，是新建應(yīng)用支持的最低SDK版本。
• targetSdkVersion 表示你測試過你的應(yīng)用支持的最高Android版本(同樣用API level表示).當(dāng)Android發(fā)布最新版本后，我們應(yīng)該在最新版本的Android測試自己的應(yīng)用同時更新target sdk到Android最新版本，以便充分利用Android新版本的特性。更多知識，請閱讀Supporting Different Platform Versions。

更多關(guān)于Gradle的知識請閱讀Building Your Project with Gradle

注意/res目錄下也包含了resources資源：

drawable<density>/

存放各種densities圖像的文件夾，mdpi，hdpi等，這里能夠找到應(yīng)用運(yùn)行時的圖標(biāo)文件ic_launcher.png

layout/

存放用戶界面文件，如前邊提到的activity_my.xml，描述了MyActivity對應(yīng)的用戶界面。

menu/

存放應(yīng)用里定義菜單項(xiàng)的文件。

values/

存放其他xml資源文件，如string，color定義。string.xml定義了運(yùn)行應(yīng)用時顯示的文本"Hello world!"

要運(yùn)行這個APP，繼續(xù)下個小節(jié)的學(xué)習(xí)。

使用命令行創(chuàng)建項(xiàng)目

如果沒有使用Android Studio開發(fā)Android項(xiàng)目，我們可以在命令行使用SDK提供的tools來創(chuàng)建一個Android項(xiàng)目。

1. 打開命令行切換到SDK根目錄下；

2. 執(zhí)行:

tools/android list targets

會在屏幕上打印出我們所有的Android SDK中下載好的可用Android platforms，找想要創(chuàng)建項(xiàng)目的目標(biāo)platform，記錄該platform對應(yīng)的Id，推薦使用最新的platform。我們?nèi)钥梢允棺约旱膽?yīng)用支持較老版本的platform，但設(shè)置為最新版本允許我們?yōu)樽钚碌腁ndroid設(shè)備優(yōu)化我們的應(yīng)用。 如果沒有看到任何可用的platform，我們需要使用Android SDK Manager完成下載安裝，參見 Adding Platforms and Packages。

3. 執(zhí)行：

android create project --target <target-id> --name MyFirstApp \
--path <path-to-workspace>/MyFirstApp --activity MyActivity \
--package com.example.myfirstapp

替換<target-id>為上一步記錄好的Id，替換<path-to-workspace>為我們想要保存項(xiàng)目的路徑。

Tip:把platform-tools/和 tools/添加到環(huán)境變量PATH，開發(fā)更方便。

到此為止，我們的Android項(xiàng)目已經(jīng)是一個基本的“Hello World”程序，包含了一些默認(rèn)的文件。要運(yùn)行它，繼續(xù)下個小節(jié)的學(xué)習(xí)。