一个安卓项目(Android Project)包含构成你的安卓应用(App)代码的所有文件。Android SDK中提供的工具将创建一系列默认的项目目录和文件,使开始一个项目非常简单。
这节课将教授使用Eclipse(通过安卓开发工具(ADT)插件)以及通过命令行使用SDK工具创建新项目(Project)。
请注意:你应该已经安装了Android SDK,并且,如果你使用Eclipse,你应该也安装Eclipse的安卓开发工具插件(ADT Plugin)(版本21.0.0或更新)。如果你还没有,请按照此指南安装Android SDK。
使用Eclipse创建项目
点击工具栏上的“新建”(New)按钮。
在所显示的窗口中,打开“Android”目录,选择“Android Application Project”,然后点击“Next”。
在显示的表单对话框中填入:
“Application Name”(应用名称)是用户所看到的App名称。对于此项目,我们使用“My First App”(我的第一个应用)作为名称。
“Project Name”(项目名称)是项目在文件系统中目录的名称以及在Eclipse中显示的名字。
“Package Name”(包名称)是你的应用的包名称(遵从Java编程语言中对于package的规则)。你的package名字必须和其他已经安装于Android系统中的其他引用保持不同(Unique)。由于此原因,一般最好使用你的组织或者公开实体的域名反向作为package名字的开始(译者注:比如,如果你的网站名字是,superweb.com,那么你可以用com.superweb作为package的开始。此规范同样适用于其他Java相关开发)。对于此项目,我们可以使用类似于“com.example.myfirstapp”作为package名字。但是,你不可以在Google Play发布使用“com.example”作为命名空间的应用。
“Minimum Required SDK”(SDK最低版本要求)是设置你的应用支持的Android最低版本,使用API level(API级别)来标识。为了支持尽可能多的设备,你应该设置此项为允许你的应用可以提供核心功能的最低的Android系统版本。如果你的应用的某一非主要功能只能存在于更新的Android系统,你可以设置只在支持它的系统中运行时开发此功能(就像在“Supporting Different Platform Versions”中介绍的一样)。对于此项目,我们保留默认值。
“Target SDK”(目标SDK)标识你的应用所测试过的Android版本(同样使用API level来表示)。当新的Android系统发布后,你应该在新的版本下测试你的应用并且更新此设置以适应最新的API level,就此才能充分发挥新的平台的优势。
“Compile With”(编译平台)标识你的应用所使用的编译平台版本。此设置默认为你的SDK中存在的最新的Android系统。(此设置应该至少为Android 4.1或者更新版本;如果你没有相关版本,你必须使用SDK Manager安装一个)。你也可以构建你的应用去支持更旧的版本,但是设置构建目标为最新版本将允许你启用新的功能并且优化你的应用以在最新的设备上提供更好的用户体验。
“Theme”(主题)此设置为你的应用指明Android用户界面风格(Android UI style)。目前,我们可以不去留意此设置。
点击“Next”。
在下一个设置项目的屏幕(screen),保留缺省值,点击Next。
下一个屏幕将帮助我们为我们的App创建一个启动图标。
你可以用很多方法自定义一个图标,此工具会帮助你针对不同的屏幕分辨率生成图标。在发布你的应用之前,你应该保证你的图标满足在Iconography设计指南中定义的规范。
点击Next。
现在,你可以选择一个activity模板(activity template,译者注:不知道怎么翻译activity,这是一个Android开发中的专有名词,就不翻译了。)来开始建造你的App。
对于此项目,选择“BlankActivity”,然后点击“Next”。
对于activity的所有详细信息和状态保留缺省值,然后点击“Finish”。
现在,你的Android项目(Android Project)已经设置完成,并且包含一些缺省创建的文件。你已经准备好开始建造应用了。继续到下一节课。
使用命令行工具创建项目
如果你不使用集成ADT Plugin的Eclipse IDE,你也可以使用SDK工具集通过命令行的方式常见项目:
切换目录到Android SDK下的“tools/”路径。
运行:
android list targets
此命令输出你的SDK中已经下载过的有效Android平台(platforms)。找到你想用来编译你的应用的平台。记下此目标平台的id(这个id一般是一个数字,或者是“android-xx”,xx是两位数字,代表API level)。我们建议你尽可能选择最高版本。你也可以选择建造你的应用支持旧版本,但是使用最新版本构造(build)应用将可以使之针对最新设备得到优化。
如果你没有看到任何目标平台,你需要使用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
用目标平台中的id项(从上一步中得到)替换<target-id>,同时,使用你希望存放此Android项目的目录替换<path-to-workspace>(译者注:此处提供的路径是实际项目目录的父目录,项目的目录是MyFirstApp)。
现在,你的Android项目(Android Project)已经设置完成,并且包含一些缺省创建的文件。你已经准备好开始建造应用了。继续到下一节课。
建议:将platform-tools/和tools/目录加入PATH环境变量。
此文章整体或部分翻译自Android Open Source Project的文档。依照Creative Commons 2.5 Attribution License使用并分享。此文章(译文,中文)原始链接为“[安卓教学] 创建你的第一个安卓应用 - 第一课 - 创建一个安卓项目(Project)”。原文(英文)链接为“Creating an Android Project“。
< 上一课 | 课程介绍 | 下一课 > |