创建首个 Android 项目

Android 项目包括构成你的 Android 应用的源代码的所有文件。 利用 Android SDK 工具可以简单的创建 默认项目目录和文件来开始一个新的 Android 项目。

本节课展示了如何使用 Eclipse （包含 ADT 插件）或在命令行通过 SDK 工具来创建一个新项目。

注意： 你应该已经安装了 Android SDK；如果你是用 Eclipse，应该也 安装了（21.0.0 或更高版本的）ADT 插件。 如果还没有，再开始本节课程之前，请根据向导 安装 Android SDK。

使用 Eclipse 创建项目

---

1. 点击工具栏中的新建项目 按钮。
2. 在出现的窗口中展开Android文件夹。选择Android Application Project， 并点击Next继续。
   

   图1 - Eclipse 的新建 Android 应用项目向导。

3. 按如下说明填写表单：
   • Application Name 是呈现给用户的应用名称。该项目名为“My First App”。

   • Project Name 是你的项目目录名，即在 Eclipse 中看到的名称。
   • Package Name 是你的应用包的命名空间（使用与 Java 编程语言相同的命名规则）。 你的包名在安装到 Android 系统的应用程序中必须唯一。 因此，通常使用你的组织或发布者的反向域名作为包名比较好。 对于该项目，你可以使用“com.example.myfirstapp”这样的包名。
   • Minimum Required SDK 是你的应用支持的 Android 的最低版本对应的API 级别。 为了支持尽量多的设备，你应该将该值设置为提供你的应用的核心特性所需要的可能的最低版本。 如果你的应用中的一些特性只在新一些的版本可用，并且他对于应用的核心特性不很重要， 你可以只在运行可以支持他的版本时开启该特性（将在 支持平台的不同版本中讨论)。 对于本项目，使用默认值即可。
   • Target SDK 是你测试了你的应用程序的 Android 最高版本（当然也是填写 API 级别）。

     当有 Android 的新版本可用时，为了利用新的平台特性，你应该在新版本中测试你的应用程序， 并将该值更新为最新的 API 级别。

   • Compile With 是你用于编译应用的平台版本。 该值默认为可用 Android SDK 的最新版。 （他应该是 Android 4.2 或更高版本；如果你没有该版本，应该使用 SDK 管理器安装它）。 你仍然可以构建你的应用以支持旧版本，但应该设置该值为最新版，这样可以允许你启用新特性， 并优化你的应用，使它在最新设备上有更好的体验。
   • Theme 指定你的应用的 Android UI 的风格。 你可以不管他。

   按下Next按钮。

4. 下一画面用于项目配置，保持默认选择，按下Next按钮。
5. 下一画面可以帮助你创建你的应用的启动器图标。

   你可以通过几种方式定义图标，工具会为所有屏幕分辨率生成图标。 在你正式发布应用之前， 请确认你的图标符合Iconography 设计向导中的规格定义。

   按下Next按钮。

6. 现在你可以选择一个用于构建你的应用的活动模版。

   本项目选择BlankActivity并按下Next按钮。

7. 保持活动细节设置的默认值，按下Finish按钮。

你的 Android 项目使用一些默认文件设置好了，你已经做好了开始构建应用的准备。 继续下一课。

通过命令行工具创建项目

---

如果你没有使用带有 ADT 插件的 Eclipse，你可以在命令行使用 SDK 工具来创建你的项目：

1. 将目录切换到 Android SDK 的tools/目录下。
2. 执行：

   android list targets

   这会列出你已经下载的可用的 Android SDK 平台组件。 找出你要用于编译应用的平台。 将目标 id 记录下来。 我们建议你选择尽可能高的版本。 你仍然可以构建你的应用以支持旧版本， 但应该设置该值为最新版，这样可以允许你启用新特性，并优化你的应用，使它在最新设备上有更好的体验。

   如果你没有看到任何目标列出，你需要使用 Android SDK 管理工具安装一些。 参见 添加平台组件和软件包。

3. 执行：

   android create project --target <目标id> --name MyFirstApp 
   --path <工作空间路径>/MyFirstApp --activity MainActivity 
   --package com.example.myfirstapp
   

   用之前（上一步）记录的目标 id 替换<目标id>，用你要保存 Android 项目的 目录来替换<工作空间路径>。

你的 Android 项目使用一些默认文件设置好了，你已经做好了开始构建应用的准备。 继续下一课。

提示：将platform-tools/和tools/ 目录添加到环境变量PATH中。