创建你的第一个APP sdk 【~/docs/training/basics/firstapp/index.html】

欢迎开始Android 应用开发。

这篇文章将教会你如何创建你的第一个android APP，你将学到如何创建一个Android 工程，如何调试app；你同样将会学到有关Android APP的一些基础设计；包括：如何创建一个简单的用户界面以及如何处理用户的输入。

在你阅读这篇文章之前，请确保你的开发环境已经配置成功了；你应该满足如下条件：

下载Android SDK
安装Eclipse的ADT插件(如果你用Eclipse开发)
使用SDK Manager下载最新的SDK工具

注意：请确保你安装的ADT是比较新的，也就是说最好用最新的ADT；同时也请更新你的SDK到最新版本；因为可能在这篇文章中讲到的一些属性不适用与之前的版本。

如果上面的步骤你没有完成，请点击这里下载Android SDK并一步步的按照上面的步骤进行配置。在你完成了配置之后，就可以从这篇文章开始看起。

这一系列教程将按照逐步深入的方式教会你有关Android APP开发的一些基础概念和规则，所以，从之后你开发APP的角度来说，这一系列文章相当重要。

创建一个Android工程

一个Android APP的所有代码都在你所创建的这个Android APP中。使用Android SDK工具可以让你很方便的创建一个Android工程。这部分教程展示了如何使用Eclipse(安装了ADT插件)或者使用命令行来创建Android工程。

注意：在此之前，应该首先配置好Android 开发环境 ......

在工具栏点击 “New”

在出现的窗口中打开 “Android”文件夹，选择“Android Application Project”，点击 “Next”

填写相关信息

“Application Name” ：展现给用户的APP名称，对于当前例子中的这个应用，我们使用“My First App”
"Project Name": 在Eclipse中显示的名字
“Package Name”：你的应用的包命名空间（这部分知识跟java编程语言相同）；你的package name应该是唯一的，所以，通常的做法是使用你的机构或者公共的开头。这里我们使用"com.example.myfirstapp"。但是你不能将命名空间为“com.example”的应用发布到Google Pay上。
"Minimum Required SDK" :当前APP所能运行的系统的最低要求，这个使用API level来进行表示。为了支持你的APP可以在更多的设备上运行，你应该尽可能的将你的APP的核心功能适配低级别的API level，建议不要讲你的app中的其中一个功能只适用于最新的版本。
“Target SDK”：表明了这个APP所能运行的最新的Android 版本，也就是你测试使用的环境。如果Google 发布了新的Android版本，并且你的APP要运行再更新的版本上，你应该在新版本上进行测试，并且更新这个值，以适配最新的特性。
“Compile With”: 指明了编译该APP所使用的环境。默认情况下，这个值都是被设置成了你安装的SDK的最新版本。当然，你也可以使用旧的SDK环境来编译，但是，使用最新的版本进行编译，可以让你的APP使用上最新的Android特性以及更好的体验。
"Theme":指明 APP 界面的风格，通常情况直接下一步
在下面的界面中，对当前这个项目进行配置，通常都是默认情况
在下面的的界面，将帮助你定制你的APP。例如你APP的名称、图标等。但是在你进行APP发布自谦，你应该确保你的图标遵循iconography 规则。
现在，你可以选择一个Activity的模板来创建你的APP的Activity啦。然后点击完成。

使用命令行创建

如果你不使用Eclipse，你可以使用下面的步骤来替代Eclipse进行创建Android项目

进入Android SDK的tools 目录

运行命令

android list targets

这条命令，列出了所下载的得到的一些可用的设备情况。这里所说的可用是指可以编译成为的。请注意列出来target id信息，在后面会用到；如果在这条命令执行完成滞后，没有任何输出，请确认你的Android SDK是否安装成功。

执行命令

android create project --target <target-id> --name MyFirstApp \
--path <path-to-workspace>/MyFirstApp --activity MainActivity \
--package com.example.myfirstapp

将<target id>替换为上一条命令所显示的；将<path-to-workspace>替换成为保存你Android工程的目录。

小建议：可以将"platform-tools/"和"tools"目录添加到你环境变量中去。