【Android Developers Training】 1. 创建一个Android项目工程

注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。

原文链接：http://developer.android.com/training/basics/firstapp/creating-project.html

---

一、创建一个Android项目工程

    一个Android项目工程包含所有构成你的Android应用的源代码文件，利用Android SDK工具可以很轻松地创建一个新的含有默认项目目录和文件的Android项目工程。

    这次课程展示了如何使用Eclipse（拥有ADT插件）或者在命令行下使用SDK工具创建一个新的Android项目工程。

注：您必须已经安装了Android SDK，并且如果您使用的是Eclipse，您必须已经安装了ADT插件（21.0.0版本或以上）。如果您还没有完成上述的准备工作，请在开始这次课程之前，按照以下链接中的指引流程来安装Android SDK：http://developer.android.com/sdk/installing/index.html

一）. 通过Eclipse创建一个项目工程

    1. 在“工具栏”中点击“新建”

    2. 在出现的窗口中，打开“Android”这一文件夹，选择“Android Application Project”，然后点击“Next”

    3. 填写窗口中出现的表单，其中：

• Application Name 是展现给用户的应用名称，在此例中，使用“My First App”。
• Project Name 是您项目目录的名字，同时也是在在Eclipse中显示的名字。
• Package Name 是您应用的包命名空间（和Java中的包名命名规则相同）。您的包名必须是在安卓系统中所有已安装的包中是唯一的。因此，一般最好是使用您的组织或发布实体的域名的一个逆序作为包名，在这个例子中，您可以使用比如：“com.example.myfirstapp”。不过要注意的是，使用"com.example"这一命名空间的应用是不能发布到Google Play上的。
• Minimum Required SDK 是您的应用所能支持的最低版本的Android系统，系统版本通过API Level来表示。为了尽可能支持更多的设备，您可以将它设置为可以允许的最低版本，这里所指的最低版本是允许您的应用展现其核心功能特性的版本，如果您应用的某个功能特性只能在一个更加新的Android系统版本上运行，同时这个功能特性对于应用的核心功能特性来说并不关键，您可以让这个功能特性只有在支持它的系统版本上运行（见Supporting Different Platform Versions）。在此例当中，我们让这个字段保持默认值。
• Target SDK 代表您的应用所测试过的最高版本的Android系统（同样用API Level表示）。当一个新的Android版本发布了以后，您应该在新版本上对您的应用进行测试，并且更新这个字段的值来匹配最新的API Level，这样就可以享受新版本系统所带来的新特性了。
• Compile With 代表您将使用何系统版本对应用进行编译，默认为您的SDK所具有的最新Android版本（4.1或更高，如果您没有这个版本，可以通过SDK Manager 下载）。您仍然可以让您的应用支持旧的系统版本，但是将构建目标设置为最新的系统版本可使您利用新的特性，并且最优化您的应用，使得在市面上的新设备中，您的应用可以具有更好的用户体验。
• Theme  定义您的系统将要应用的UI风格。您可以暂时先不去在意这一选项。
• 将上述字段设定完毕后，点击“Next”

　　　　　　 

• 图1. 在Eclipse中新建Android应用项目工程向导页面

    4. 在下一个窗口中可进一步配置项目工程，这里我们保持默认值并点击“Next”

    5. 在下一个窗口中，可以帮助您创建一个属于您的应用的应用图标。您可以通过不同的方式来自定义一个图标，SDK工具会为所有尺寸的屏幕创建图标。在您发布您的应用之前，您应该确保您的图标符         合在 Iconography 中定义的各项标准。点击“Next”

    6. 现在您可以选择一个Activity模板来开始构建您的应用了，在这个例子中，我们选择“BlankActivity”然后点击“Next”

    7. 保持所有关于Activity的细节为它的原始状态，然后点击“Finish”

    您的Android项目工程现在已经配置好了，在该工程中已经具有了一些默认的文件，现在您已经准备好开始构建应用，可以进入到下一个课程当中。

二）. 通过命令行工具创建一个项目工程

    如果您没有使用搭载了ADT插件的Eclipse集成开发环境，作为替代，您可以使用SDK工具在命令行下创建您的项目工程：

    1. 将当前工作目录切换至Adnroid SDK的tools/路径

    2. 执行：

　　android list targets

　　这条命令打印您在SDK中已经下载好的所有版本Android平台的清单。找到您期望对应用进行编译的目标平台。记下这个目标平台的ID，我们推荐您尽可能选择最高的版本。您也可以选择较老的版     　　本，但是选择最新的版本会让您的应     用在最新的设备上具有更好的表现。

　　如果您没有看到任何平台被列出，您需要通过SDK Manager 下载一些。参阅：Adding Platforms and Packages

    3. 执行：      

　　android create project --target <target-id> --name MyFirstApp \



　　--path <path-to-workspace>/MyFirstApp --activity MainActivity \



　　--package com.example.myfirstapp

    将<target-id>用一个清单中列出的目标平台ID来替代（见步骤2），然后将<path-to-workspace>替代为您期望存储该Android项目工程的路径。   

    您的Android项目工程现在已经配置好了，在该工程中已经具有了一些默认的文件，现在您已经准备好开始构建应用，可以进入到下一个课程当中。

 Tip:添加 platform-tools/ 和  tools/ 的路径至您的环境变量中的PATH键