> 編寫:[yuanfentiank789](https://github.com/yuanfentiank789) - 原文:[http://developer.android.com/training/basics/firstapp/creating-project.html](http://developer.android.com/training/basics/firstapp/creating-project.html)
一個Android項目包含了所有構成Android應用的源代碼文件。
本小節介紹如何使用Android Studio或SDK Tools命令行來創建一個新的項目。
> **Note**:在此之前,我們應該已經安裝了Android SDK,如果使用Android Studio開發,應該確保已經安裝了[Android Studio](http://developer.android.com/sdk/installing/studio.html)。否則,請先閱讀 [Installing the Android SDK](http://developer.android.com/sdk/installing/index.html)按照向導完成步驟安裝。
### 使用Android Studio創建項目
1. 使用Android Studio創建Android項目,啟動Android Studio
- 如果我們還沒有用Android Studio打開過項目,會看到歡迎頁,點擊New Project
- 如果已經用Android Studio打開過項目,點擊File==>New Project新建項目
2. 參照圖1在彈出的窗口(**Configure your new project**)中填入內容,點擊**Next**.
按照要求使用如圖所示的值會使學習變得更容易。
- **Application Name** 此處填寫想呈現給用戶的應用名稱,此處我們使用“My First App".
- **Company domain** 包名限定符,Android Studio會將這個限定符應用于每個新建的Android項目
- **Package Name**是應用的包命名空間(同Java的包的概念),該包名在同一Android系統上所有已安裝的應用中具有唯一性,我們可以獨立地編輯該包名.
- **Project location**操作系統存放項目的目錄

**圖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表示我們的應用支持的最低Android版本,為了支持盡可能多的設備,我們應該設置為能支持你應用核心功能的最低API版本。如果某些非核心功能僅在較高版本的API支持,你可以只在支持這些功能的版本上開啟它們(參考[兼容不同的系統版本](#)),此處采用默認值即可。
5. 不要勾選其他選項 (TV, Wear, and Glass) ,點擊 **Next**.
6. 在**Add an [activity](# "An activity represents a single screen with a user interface.") to __** 窗口選擇**Blank [Activity](# "An activity represents a single screen with a user interface.")**,點擊 **Next**.
7. 在**Choose options for your new file** 窗口修改**[Activity](# "An activity represents a single screen with a user interface.") Name** 為_MyActivity_,修改 **Layout Name** 為_activity_my_,**Title** 修改為_MyActivity_,**Menu Resource Name** 修改為_menu_my_。
8. 點擊**Finish**完成創建。
剛創建的Android項目是一個基礎的Hello World項目,包含一些默認文件,我們花一點時間看看最重要的部分:
app/src/main/res/layout/activity_my.xml
這是剛才用Android Studio創建項目時新建的[Activity](# "An activity represents a single screen with a user interface.")對應的xml布局文件,按照創建新項目的流程,Android Studio會同時展示這個文件的文本視圖和圖形化預覽視圖,該文件包含一些默認設置和一個顯示內容為“Hello world!”的TextView元素。
app/src/main/java/com.mycompany.myfirstapp/MyActivity.java
用Android Studio創建新項目完成后,可在Android Studio看到該文件對應的選項卡,選中該選項卡,可以看到剛創建的[Activity](# "An activity represents a single screen with a user interface.")類的定義。編譯并運行該項目后,[Activity](# "An activity represents a single screen with a user interface.")啟動并加載布局文件activity_my.xml,顯示一條文本:"Hello world!"
app/src/main/AndroidManifest.xml
[manifest](http://developer.android.com/guide/topics/manifest/manifest-intro.html)文件描述了項目的基本特征并列出了組成應用的各個組件,接下來的學習會更深入了解這個文件并添加更多組件到該文件中。
app/build.gradle
Android Studio使用Gradle 編譯運行Android工程. 工程的每個模塊以及整個工程都有一個build.gradle文件。通常你只需要關注模塊的build.gradle文件,該文件存放編譯依賴設置,包括defaultConfig設置:
-
compiledSdkVersion是我們的應用將要編譯的目標Android版本,此處默認為你的SDK已安裝的最新Android版本(目前應該是4.1或更高版本,如果你沒有安裝一個可用Android版本,就要先用[SDK Manager](http://developer.android.com/sdk/installing/adding-packages.html)來完成安裝),我們仍然可以使用較老的版本編譯項目,但把該值設為最新版本,可以使用Android的最新特性,同時可以在最新的設備上優化應用來提高用戶體驗。
- applicationId 創建新項目時指定的包名。
- minSdkVersion 創建項目時指定的最低SDK版本,是新建應用支持的最低SDK版本。
- targetSdkVersion 表示你測試過你的應用支持的最高Android版本(同樣用API level表示).當Android發布最新版本后,我們應該在最新版本的Android測試自己的應用同時更新target sdk到Android最新版本,以便充分利用Android新版本的特性。更多知識,請閱讀[Supporting Different Platform Versions](http://developer.android.com/training/basics/supporting-devices/platforms.html)。
更多關于Gradle的知識請閱讀[Building Your Project with Gradle](http://developer.android.com/sdk/installing/studio-build.html)
注意/res目錄下也包含了[resources](http://developer.android.com/guide/topics/resources/overview.html)資源:
drawable/
存放各種densities圖像的文件夾,mdpi,hdpi等,這里能夠找到應用運行時的圖標文件ic_launcher.png
layout/
存放用戶界面文件,如前邊提到的activity_my.xml,描述了MyActivity對應的用戶界面。
menu/
存放應用里定義菜單項的文件。
values/
存放其他xml資源文件,如string,color定義。string.xml定義了運行應用時顯示的文本"Hello world!"
要運行這個APP,繼續[下個小節](#)的學習。
### 使用命令行創建項目
如果沒有使用Android Studio開發Android項目,我們可以在命令行使用SDK提供的tools來創建一個Android項目。
1. 打開命令行切換到SDK根目錄下;
2. 執行:
~~~
tools/android list targets
~~~
會在屏幕上打印出我們所有的Android SDK中下載好的可用Android platforms,找想要創建項目的目標platform,記錄該platform對應的Id,推薦使用最新的platform。我們仍可以使自己的應用支持較老版本的platform,但設置為最新版本允許我們為最新的Android設備優化我們的應用。如果沒有看到任何可用的platform,我們需要使用Android SDK Manager完成下載安裝,參見 [Adding Platforms and Packages](http://developer.android.com/sdk/installing/adding-packages.html)。
3. 執行:
~~~
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>`為我們想要保存項目的路徑。
> **Tip**:把`platform-tools/`和 `tools/`添加到環境變量`PATH`,開發更方便。
到此為止,我們的Android項目已經是一個基本的“Hello World”程序,包含了一些默認的文件。要運行它,繼續[下個小節](#)的學習。
- 序言
- Android入門基礎:從這里開始
- 建立第一個App
- 創建Android項目
- 執行Android程序
- 建立簡單的用戶界面
- 啟動其他的Activity
- 添加ActionBar
- 建立ActionBar
- 添加Action按鈕
- 自定義ActionBar的風格
- ActionBar的覆蓋層疊
- 兼容不同的設備
- 適配不同的語言
- 適配不同的屏幕
- 適配不同的系統版本
- 管理Activity的生命周期
- 啟動與銷毀Activity
- 暫停與恢復Activity
- 停止與重啟Activity
- 重新創建Activity
- 使用Fragment建立動態的UI
- 創建一個Fragment
- 建立靈活動態的UI
- Fragments之間的交互
- 數據保存
- 保存到Preference
- 保存到文件
- 保存到數據庫
- 與其他應用的交互
- Intent的發送
- 接收Activity返回的結果
- Intent過濾
- Android分享操作
- 分享簡單的數據
- 給其他App發送簡單的數據
- 接收從其他App返回的數據
- 給ActionBar增加分享功能
- 分享文件
- 建立文件分享
- 分享文件
- 請求分享一個文件
- 獲取文件信息
- 使用NFC分享文件
- 發送文件給其他設備
- 接收其他設備的文件
- Android多媒體
- 管理音頻播放
- 控制音量與音頻播放
- 管理音頻焦點
- 兼容音頻輸出設備
- 拍照
- 簡單的拍照
- 簡單的錄像
- 控制相機硬件
- 打印
- 打印照片
- 打印HTML文檔
- 打印自定義文檔
- Android圖像與動畫
- 高效顯示Bitmap
- 高效加載大圖
- 非UI線程處理Bitmap
- 緩存Bitmap
- 管理Bitmap的內存
- 在UI上顯示Bitmap
- 使用OpenGL ES顯示圖像
- 建立OpenGL ES的環境
- 定義Shapes
- 繪制Shapes
- 運用投影與相機視圖
- 添加移動
- 響應觸摸事件
- 添加動畫
- View間漸變
- 使用ViewPager實現屏幕側滑
- 展示卡片翻轉動畫
- 縮放View
- 布局變更動畫
- Android網絡連接與云服務
- 無線連接設備
- 使得網絡服務可發現
- 使用WiFi建立P2P連接
- 使用WiFi P2P服務
- 執行網絡操作
- 連接到網絡
- 管理網絡
- 解析XML數據
- 高效下載
- 為網絡訪問更加高效而優化下載
- 最小化更新操作的影響
- 避免下載多余的數據
- 根據網絡類型改變下載模式
- 云同步
- 使用備份API
- 使用Google Cloud Messaging
- 解決云同步的保存沖突
- 使用Sync Adapter傳輸數據
- 創建Stub授權器
- 創建Stub Content Provider
- 創建Sync Adpater
- 執行Sync Adpater
- 使用Volley執行網絡數據傳輸
- 發送簡單的網絡請求
- 建立請求隊列
- 創建標準的網絡請求
- 實現自定義的網絡請求
- Android聯系人與位置信息
- Android聯系人信息
- 獲取聯系人列表
- 獲取聯系人詳情
- 使用Intents修改聯系人信息
- 顯示聯系人頭像
- Android位置信息
- 獲取最后可知位置
- 獲取位置更新
- 顯示位置地址
- 創建和監視地理圍欄
- Android可穿戴應用
- 賦予Notification可穿戴特性
- 創建Notification
- 在Notifcation中接收語音輸入
- 為Notification添加顯示頁面
- 以Stack的方式顯示Notifications
- 創建可穿戴的應用
- 創建并運行可穿戴應用
- 創建自定義的布局
- 添加語音功能
- 打包可穿戴應用
- 通過藍牙進行調試
- 創建自定義的UI
- 定義Layouts
- 創建Cards
- 創建Lists
- 創建2D-Picker
- 創建確認界面
- 退出全屏的Activity
- 發送并同步數據
- 訪問可穿戴數據層
- 同步數據單元
- 傳輸資源
- 發送與接收消息
- 處理數據層的事件
- Android TV應用
- 創建TV應用
- 創建TV應用的第一步
- 處理TV硬件部分
- 創建TV的布局文件
- 創建TV的導航欄
- 創建TV播放應用
- 創建目錄瀏覽器
- 提供一個Card視圖
- 創建詳情頁
- 顯示正在播放卡片
- 幫助用戶在TV上探索內容
- TV上的推薦內容
- 使得TV App能夠被搜索
- 使用TV應用進行搜索
- 創建TV游戲應用
- 創建TV直播應用
- TV Apps Checklist
- Android企業級應用
- Ensuring Compatibility with Managed Profiles
- Implementing App Restrictions
- Building a Work Policy Controller
- Android交互設計
- 設計高效的導航
- 規劃屏幕界面與他們之間的關系
- 為多種大小的屏幕進行規劃
- 提供向下和橫向導航
- 提供向上和歷史導航
- 綜合:設計樣例 App
- 實現高效的導航
- 使用Tabs創建Swipe視圖
- 創建抽屜導航
- 提供向上的導航
- 提供向后的導航
- 實現向下的導航
- 通知提示用戶
- 建立Notification
- 當啟動Activity時保留導航
- 更新Notification
- 使用BigView風格
- 顯示Notification進度
- 增加搜索功能
- 建立搜索界面
- 保存并搜索數據
- 保持向下兼容
- 使得你的App內容可被Google搜索
- 為App內容開啟深度鏈接
- 為索引指定App內容
- Android界面設計
- 為多屏幕設計
- 兼容不同的屏幕大小
- 兼容不同的屏幕密度
- 實現可適應的UI
- 創建自定義View
- 創建自定義的View類
- 實現自定義View的繪制
- 使得View可交互
- 優化自定義View
- 創建向后兼容的UI
- 抽象新的APIs
- 代理至新的APIs
- 使用舊的APIs實現新API的效果
- 使用版本敏感的組件
- 實現輔助功能
- 開發輔助程序
- 開發輔助服務
- 管理系統UI
- 淡化系統Bar
- 隱藏系統Bar
- 隱藏導航Bar
- 全屏沉浸式應用
- 響應UI可見性的變化
- 創建使用Material Design的應用
- 開始使用Material Design
- 使用Material的主題
- 創建Lists與Cards
- 定義Shadows與Clipping視圖
- 使用Drawables
- 自定義動畫
- 維護兼容性
- Android用戶輸入
- 使用觸摸手勢
- 檢測常用的手勢
- 跟蹤手勢移動
- Scroll手勢動畫
- 處理多觸摸手勢
- 拖拽與縮放
- 管理ViewGroup中的觸摸事件
- 處理鍵盤輸入
- 指定輸入法類型
- 處理輸入法可見性
- 兼容鍵盤導航
- 處理按鍵動作
- 兼容游戲控制器
- 處理控制器輸入動作
- 支持不同的Android系統版本
- 支持多個控制器
- Android后臺任務
- 在IntentService中執行后臺任務
- 創建IntentService
- 發送工作任務到IntentService
- 報告后臺任務執行狀態
- 使用CursorLoader在后臺加載數據
- 使用CursorLoader執行查詢任務
- 處理查詢的結果
- 管理設備的喚醒狀態
- 保持設備的喚醒
- 制定重復定時的任務
- Android性能優化
- 管理應用的內存
- 代碼性能優化建議
- 提升Layout的性能
- 優化layout的層級
- 使用include標簽重用layouts
- 按需加載視圖
- 使得ListView滑動順暢
- 優化電池壽命
- 監測電量與充電狀態
- 判斷與監測Docking狀態
- 判斷與監測網絡連接狀態
- 根據需要操作Broadcast接受者
- 多線程操作
- 在一個線程中執行一段特定的代碼
- 為多線程創建線程池
- 啟動與停止線程池中的線程
- 與UI線程通信
- 避免出現程序無響應ANR
- JNI使用指南
- 優化多核處理器(SMP)下的Android程序
- Android安全與隱私
- Security Tips
- 使用HTTPS與SSL
- 為防止SSL漏洞而更新Security
- 使用設備管理條例增強安全性
- Android測試程序
- 測試你的Activity
- 建立測試環境
- 創建與執行測試用例
- 測試UI組件
- 創建單元測試
- 創建功能測試
- 術語表