一个Android项目包含了Android app代码在内的所有文件。Android SDK工具提供默认的项目目录和文件让创建一个项目变得很简单。
这篇课程会向大家展示,如何通过Eclipse(包含ADT插件)或者通过在命令行使用SDK工具来创建一个新项目。
提示: 你必须得先安装好Android SDK,如果你使用的是Eclipse,那么你还必须安装了ADT 插件(22.6.2版本或更高)。如果你没有这些,可以通过Android SDK安装向导安装好,然后再回到这片课程。
通过Eclipse创建项目
- 点击工具栏上的 New 。
- 在弹出的窗口上打开 Android 文件夹,选择 Android Application Project, 然后点击 Next.
- 补全出现的窗口中的表单:
- Application Name 是要展现给用户看的app的名称。在这个项目中,使用"My First App"作为项目名称。
- Project Name 是你的项目的目录以及项目在Eclipse中的名称。
- Package Name 是你的项目的包命名空间(遵循与java编程同样的包命名规则)。你的包名必须在Android系统所有包名中是唯一的。因此你最好的选择是使用你所在组织或者发行商的域名的反转作为包名。在本项目中,你可以使用类似"com.example.myfirstapp"的包名。然而你不能再Google Play上发布以“com.example”开头的包名的应用。
- Minimum Required SDK 是你的app所支持的最低Android系统版本,指明使用的 API level。为了支持尽可能多的设备,你应在将其设置为能提供你的应用核心功能的最低可用的版本。如果你的应用中的某些特性必须使用高版本的API并且这些特性对应用的核心功能不是那么重要,那么你可以指定让这些特性仅当运行在支持它们的版本的系统上运行(就像我们在 Supporting Different Platform Versions 中讨论的那样)。本项目就使用默认版本。
- Target SDK 表示你用来测试你的应用的Android系统的最高版本(同样使用 API level )。
一旦有新版本的Android系统,你应该要在新版本上测试你的应用,并且将Taget SDK更新为新版本的值,这样才能使用新版平台的特性。
- Compile With 表示你将要使用那个版本来编译你的应用。默认情况下,它被设置为你的SDK中最高的Android系统版本(它必须是Android4.1或者更高;如果你还没有这个版本,你必须通过 SDK Manager 来安装)。你同样可以支持老版本的系统,但是要把target设置为最新版来保证优化你的应用,让它能够在最新版的设备上有很棒的用户体验。
- Theme 指定你的应用的UI风格。这里你可以留空。
点击Next.
- 在这个界面上来配置项目,这里全部默认,然后点击 Next。
- 这个界面能够帮助你创建应用的icon。
你可以通过多种方式自定义一个icon,并且这个工具能够帮助你为所有的屏幕分辨率的设备生成icon。You can customize an icon in several ways and the tool generates an icon for all screen densities. 在你发布应用前,确保你的icon满足图象学设计指南中的规范( Iconography )。
点击Next.
- 现在你可以选择一个activity模板来开始创建你的应用。
在这个项目中,选择 BlankActivity 然后点击 Next。
- 保持所有的activity的详细信息在默认状态,然后点击 Finish。
你的项目现在就是一个基本的 "Hello World" 应用,并且包含了一些默认文件。运行你的应用,请继续看下一课。
通过命令行工具创建项目
如果你没有使用包含ADT插件的Eclipse IDE,作为代替,你可以通过在命令行使用SDK工具来创建你的项目:
- 在命令行中改变你的目录到
tools/
下。 - 执行:
android list targets
这将会列出你已经下载的所有可用的Android SDK平台版本。找到一个你希望用来编译你的应用的版本。记住target id。我们推荐你使用尽可能高的版本。你同样可以支持老版本的系统,但是要把target设置为最新版来保证优化你的应用,让它能够在最新版的设备上有很棒的用户体验。
如果没有列出任何targets,你需要通过Android SDK Manager工具来下载一些。查看 Adding Platforms and Packages。
- 执行:
android create project --target <target-id> --name MyFirstApp \ --path <path-to-workspace>/MyFirstApp --activity MainActivity \ --package com.example.myfirstapp
将
<target-id>
替换为上一步记住的id,同样的替换<path-to-workspace>
为你想要保存你的Android项目的位置。
你的项目现在就是一个基本的 "Hello World" 应用,并且包含了一些默认文件。运行你的应用,请继续看下一课(next lesson)。
贴士: 将platform-tools/
和tools/
目录添加到 PATH
环境变量中。