Android官方开发文档Training系列课程中文版：构建第一款安卓应用之工程创建

这节课你将会学到：
- 使用Android Studio创建一个工程。
- 使用命令行工具创建一个工程。

你也应该阅读：
- 安装SDK
- 管理工程

---

安卓项目包含了包括源代码在内的所有文件。Android SDK工具使我们很轻松的创建一个包含一系列默认目录和文件的的安卓工程。

这堂课展示了如何通过Android Studio或者使用SDK命令行工具创建一个新工程。

你应该确保安装了SDK，如果你使用Android Studio的话，你也应该去安装Android Studio，如果你还没有完成这些，请完成。

---

使用Android Studio创建工程

1. 在Android Studio中，创建一个新工程：

   • 如果你还没有打开工程，在Welcome屏幕中，点击New Project.
   • 如果你打开了一个工程，在File菜单上选择New Project.
     

2. 在配置你的新工程界面中，像上图一样填入你的信息，然后点击Next。

   • Application Name 是应用的名称，在这里，使用“My First App”。
   • Compay domain 提供了限定符，稍后它会出现在包名中。
   • Package name 是工程的全标识符名称。你的包名必须在安卓系统中是唯一的。
   • Project location 是你的工程项目文件存储目录。

3. 接下来选择应用将要运行的形式平台，这里选择 Phone and Tablet。

4. 对于Minimum SDK，选择API 8: Android 2.2 (Froyo).
   Minimum Required SDK 是指你的应用所支持的最低版本。为了尽可能的支持更多的设备，你应该在你应用所允许的范围之内将这个值设置到最低。如果任何可能不是核心功能的特性只允许在新的安卓版本上运行，你可以选择只在支持的设备上运行。
5. 不选择其它选项（TV, Wear, and Glass）,然后点击Next。
6. 接下来关于 Add an activity to < template >，这里选择Blank Activity，然后点击Next。
7. 接下来Choose options for your new file中，选择Activity Name 为 MyActivity. The Layout Name更换为activity_my,Title设置为MyActivity. The Menu Resource Name设为menu_my.
8. 点击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 标示对于应用测试过的最高支持版本，如果有新版本可用了，你应该在最新的版本上进行测试，并且更新这个值到最新的版本。
- 通过Building Your Project with Gradle了解更多Gradle的相关支持。

---

注意一下工程目录中/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 . 执行以下命令：

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

用刚刚你选择的目标编译平台替换< target-id >属性，使用你想保存工程目录的位置替换 < path-to-workspace >。

Tip: 添加 platform-tools/ 和 tools/ 目录到你的环境变量PATH中去。

现在你的安卓工程已经创建好了，它包含基于”Hello World！”应用的一些默认的文件，关于如何运行程序，请看下一节。