注:本文翻译自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键