Android官方开发教程中文版(一).docx

《Android官方开发教程中文版(一).docx》由会员分享，可在线阅读，更多相关《Android官方开发教程中文版(一).docx（27页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Android官方开发教程中文版维信科技创建你的第一个App创建你的第一个App欢迎加入Android应用开发。本课程将教你如何创建你的首个Android应用（维信科技提供）。你将学习到如何创建Android项目和运行它的可调试版本。你还会学习到Android应用设计的基本原理，包括如何创建简单用户界面和处理用户输入。在你开始本课程之前，你要确信你的开发环境已经设置好，你需要：1 下载Android SDK。2 为Eclipse安装ADT插件（如果你的IDE是Eclipse）。3 使用SDK Manager下载最新的SDK工具和平台。如果你还没有完成这些任务，那么开始下载Android SDK

2、并完成随后的安装步骤。一旦你完成安装，也就做好了开始本课程的准备工作。本课程采用教程的格式，通过逐步构建一个小型的Android应用，教你了解一些关于Android开发的基本概念，因此，你应该遵循教程中的每一个步骤。创建Android项目一个Android项目包含Android应用的所有文件以及源代码。Android SDK工具可以很轻松地使用默认的目录和文件开始一个新的Android项目。本课程将演示如何使用Eclipse（含ADT插件）或SDK工具从命令行创建新项目（维信科技提供）。注意：你应该已经安装了Android SDK，并且如果你使用的是Eclipse，那么你也应该安装了ADT插件

3、（版本21.0.0或更高），如果你还没有完成这些，在开始本课程之前请按照前面的指南安装Android SDK。使用Eclipse创建项目1 在工具样上点击New 。2 在出现的窗口中，打开Android文件夹，选择Android Application Project，点击Next。3 填写以下内容：l Application Name：用户看到的应用名称，在本项目中，使用“My First App”。l Project Name：项目目录的名称，并且在Eclipse中也能看到的名称。l Package Name：应用的包名（遵循Java程序语言中包的命名规则）。你的包名在所有安装到Andro

4、id系统的包中必须是唯一的，因此，包名最好是你的组织或出版商的域名反转。在本项目中，你可以使用类似“com.example.myfirstapp”的包名。无论如何，你不能使用“com.example”的包命在谷歌发布你的应用。l Minimum Required SDK：你的应用支持的Android系统的最低版本和它使用的API级别。为了支持尽可能多的设备，你应该将它设置为所允许的最低版本以允许你的应用提供所有核心功能。如果你的应用中某个功能只能在新版本的Android系统中运行，并且它不是核心功能的关键部分，你可以启用仅在支持的版本上运行该功能(我们将在“支持不同平台版本”中进一步讨论)。本

5、项目中使用默认值。l Target SDK：表示用来测试你的应用的Android系统的最高版本和API级别。当新的Android系统可用时，你应该在新版本上测试你的应用并更新这个值以匹配最新的API级别，从而利用新的平台特性。l Compile With：用以编译你的应用的平台版本。默认情况下，这会设置为你的SDK中可用的最新版本的Android系统（应该是Android4.1或更高版本，如果你没这样一个可用版本，你必须用SDK Manager安装一个）。你仍然可以创建支持旧版本的应用，但把构建目标设置为最新版本可以允许你启用新功能并且在最新设备上优化你的应用以便为用户提供更好的用户体验。l

6、Theme：你的应用使用的Android界面风格。你可以保持默认值。图一 Eclipse的创建新Android项目的向导点击Next。4 在配置项目的下一个屏幕中，使用默认选项，点击Next。5 下一个屏幕可以帮助你为你的应用创建一个执行图标。你可以用多种方式自定义一个图标，用工具为不同屏幕分辨率生成图标。在发布你的应用之前，你应该确保你的图标符合设计指南定义的规范。点击Next。6 现在你可以选择一个Activity模板来创建你的应用。本项目中，选择BlankActivity并且点击Next。7 为Activity保留默认状态，点击Finish。你的Android项目现在设置了默认文件，准备

7、开始创建应用吧（维信科技提供）。使用命令行工具创建Android项目如果你没有使用带ADT插件的Eclipse，你也可以从命令行使用SDK工具来创建Android项目。1 改变当前路径到Android SDK的tools目录下。2 执行：android list targets这将列出你的SDK已经下载的Android平台，找到你想编译应用的平台，注意目标ID。我们建议你选择所允许的最高版本，虽然你可以构建支持旧版本的应用，但设定为最新版本可以为最新设备优化你的应用。如果你没有看到任何目标列表，你需要使用SDK Manager安装一些平台。3 执行：android create project

8、 -target -name MyFirstApp -path /MyFirstApp -activity MainActivity -package com.example.myfirstapp用上面得到的目标ID替换，用你想保存Android项目的本地路径替换。运行你的App如果你按照上一节课创建了Android项目，它包含了一个默认的“Hello World”源文件，（维信科技提供）允许你立即运行该应用。如何运行你的应用依赖两件事：你是否有一个真实的Android设备；你是否在使用Eclipse。本节将演示如何在一个真实的Android设备或Android模拟器上安装和运行你的应用，以及

9、分别在两种情况下运行：Eclipse和命令行工具。在运行你的应用之前，我们应该了解一些有关Android项目的目录和文件。AndroidManifest.xml清单文件描述了应用的基本特征并定义了它的每个组件，随着课程的深入，你将了解这个文件中的各种定义（维信科技提供）。清单文件中最重要的元素之一是元素，它用android:minSdkVersiont和android:targetSdkVersion两个属性定义了你的应用兼容不同的Android版本。在你的首个App中，它看起来类似这样： .你应该把android:targetSdkVersion设置的尽可能高并在相应的平台上测试你的应用。更

10、多信息请参见“支持不同平台版本”。src/应用的主要源文件的存放目录。默认情况下，它包含一个当通过应用图标启动应用时要运行的Activity类。res/包含了几个和应用资源相关的子目录，有这么几个：drawable-hdpi/存放为高分辨率屏幕设计的可绘制对象（如位图）。其它以drawable开头的目录存放为其它分辨率设计的资源。layout/存放定义应用的用户界面的文件。values/存放包含其它资源集合的各种XML文件，如字符串和颜色的定义。当你构建和运行默认Android应用时，默认的Activity类会启动并加载布局文件显示“Hello World”，结果虽然平平淡淡，但重要的是，在你

11、开发之前了解了如何运行你的应用（维信科技提供）。在真实设备上运行如果你有一部真实的Android设备，下面将告诉你如何安装和运行你的应用。1 用USB连线连接你的设备和开发机器，如果你在Windows下开发，你可能需要为你的设备安装合适的USB驱动程序。要获得安装驱动程序的帮助，请参看OEM USB Drivers文档。2 在你的设备上启用USB debuggingl 大多数设备运行Android3.2或更旧的版本，你可以在SettingsApplicationsDevelopment下找到这个选项。l 在Android4.0或更新版本中，这个选项在SettingsDeveloper opti

12、ons中。注意：在Android4.2或更新版本中，Developer options默认是隐藏的，要让它可见，进入SettingsAbout phone并且轻触Build number七次，返回上一级屏幕就可以找到Developer options。从Eclipse中运行：1 打开的你项目中的一个文件，并在工具栏上点击运行。2 在Run as窗口中，选择Android Application然后点击OK。Eclipse将把应用安装到你连接的设备上并启动它。你也可以从命令行运行你的应用1 把路径改变到你的Android项目的根目录中，执行：ant debug2 确保你的Android SDK

13、platform-tools/目录在你的PATH环境变量中，执行：adb install bin/MyFirstApp-debug.apk3 在你的设备上找到MyFirstActivity并打开它。这就是如何构建和在设备上运行你的应用，要进入开发，让我们继续下一节课。在模拟器上运行无论你是使用Eclipse还是命令行，要在模拟器上运行你的应用，首先要创建一个Android虚拟设备（AVD）。一个AVD是Android模拟器的设备配置，允许你模拟不能的设备。要创建AVD：1 执行Android虚拟设备管理工具a. 在Eclipse中，点击工具栏的Android Virtual Device Ma

14、nager。b. 在命令行中，把路径改变到/tools/并且执行：androiv avd2 在Android虚拟设备管理工具中，点击New。3 填写AVD的详细信息，给它一个名字，目标平台，SD卡的大小以及皮肤（默认为HVGA）。4 点击Create AVD。5 在Android虚拟设备管理工具中选择新的AVD，点击Start。6 模拟器启动之后，解锁模拟器的屏幕。从Eclipse中运行：1 打开的你项目中的一个文件，并在工具栏上点击运行。2 在Run as窗口中，选择Android Application然后点击OK。Eclipse将把应用安装到模拟器上并启动它。你也可以从命令行运行你的应用

15、4 把路径改变到你的Android项目的根目录中，执行：ant debug5 确保你的Android SDK platform-tools/目录在你的PATH环境变量中，执行：adb install bin/MyFirstApp-debug.apk6 在模拟器中找到MyFirstActivity并打开它。这就是如何构建和在设备上运行你的应用，要进入开发，让我们继续下一节课。创建简单用户界面Android应用的图形用户界面是由View和ViewGroup对象组成的层次结构创建的（维信科技提供）。View对象通常是一个UI部件如button或text field，ViewGroup对象是一个不可见

16、的视图容器，它定义了子视图如何布局，如grid或vertical list。Android提供了一个XML词汇表，对应View和ViewGroup的子类，你可以在XML中使用UI元素的层次结构定义自己的用户界面。图解ViewGroup对象如何在布局中组织分支以及包含其它View对象在这节课中，你将创建一个包含button和text field的XML布局。在随后的课程中，你将响应按纽按下时，把text field中的内容发送到另一个Activity。创建线性布局从res/layout/目录中打开activity_main.xml文件。注意：在Eclipse中，你打开一个布局文件时，首先看到的是

17、图形布局编辑器。这是一个使用“所见即所得”工具帮助你创建布局的编辑器。在这节课中，你要直接处理XML，因此点击屏幕下方的activity_main.xml标签打开XML编辑器。你在创建项目时选择的BlankActivity模板包含了一个带相对布局的根视图和TextView的子视图的activity_main.xml文件。首先，删除元素并把元素改为，然后添加android:orientation属性并把它的值设为“horizontal”，结果看来如下所示：LinearLayout是一个视图组（ViewGroup的子类），它按照android:orientation指定的值在垂直或水平方向上排列子

18、视图。LinearLayout的每一个子视图按照它在XML中的顺序出现在屏幕上（维信科技提供）。另外两个属性，android:layout_width和android:layout_height用来为所有视图指定大小。因为LinearLayout是布局的根视图，它将填充整个屏幕区域，应用的高度和宽度被设定为“match_parent”，这个值表示视图将会扩展它的宽度和高度以匹配父视图的宽度和高度。要了解有关布局属性的更多信息，请参见布局指南。添加Text Field要创建一个用户可编辑的文本域，在中插入一个元素。像每个View对象一样，你必须定义某些XML属性以指定EditText对象的属性。

19、下面是如何在内部声明EditText对象： 有关这些属性：android:id它为视图提供一个唯一标识符，以便我们在代码中引用它，例如读取或操作视图对象（我们将下一节课中了解这些）。符号用来从XML文件中引用任何资源对象，它后面是资源类型（本例中是id类型），斜杠，然后是资源名称（本例是edit_message）。资源类型前面的加号（+）只有在你首次定义资源ID时才需要它，当应用编译时，SDK工具会在项目的gen/R.java文件中使用ID名称创建一个新的资源ID以引用EditText元素，一旦通过这种方式声明了资源ID，其它对这个ID的引用都不再需要加号。只有在指定新资源ID时才需要加号，引

20、用具体的资源，如字符串或布局，则不需要加号，详情请见关于资源对象。关于资源对象资源对象使用一个唯一整数和应用的资源关联起来，比如位图、布局文件或字符串。每一个资源都在项目的gen/R.java文件中定义了一个对应的资源对象。你可以使用类R中的对象名引用资源，例如当你需要为android:hint属性指定一个字符串值时。你也可以通过android:id属性创建一个资源ID来和一个视图关联起来，这可以使你在代码中引用这个视图（维信科技提供）。每次编译应用时，SDK工具都会生成R.java文件，永远不要手动修改这份文件。要获取更多信息，请参考“提供资源”指南。android:layout_width

21、和android:layout_height没有使用特定大小的高度和宽度，而是用“wrap_content”做为宽高的值，意味着视图大小会自动匹配内容。如果用“match_parent”代替，那么EditText元素将会填充整个屏幕，因为它需要匹配父容器LinearLayout的大小。android:hint当文本域的内容为空时显示的默认字符串。使用“string/edit_message”来引用一个在单独的文件中定义的字符串资源，而不是直接使用硬编码的字符串。因为这是引用具体的资源（不是定义标识符），所以不需要加号。由于我们还没有定义字符串，你将会看到一个编译错误。我们会在下一节通过定义字符

22、串来修正它。注意：这个字符串资源和元素ID同名：edit_message，因为引用资源受资源类型（如id或string）限制，所以使用相同名称不会产生冲突。添加字符串资源当你需要在用户界面中添加文本时，你应该为每个字符串指定一个资源。字符串资源允许你在一个地方管理所有的UI文本，方便我们查找和更新文本。外部化字符串还能在你本地化应用以支持不同的语言时，为你提供可替换的字符串。默认情况下，你的Android项目包含了一个字符串资源文件：res/values/strings.xml（维信科技提供）。我们在文件中添加一个新字符串edit_message，把它的值设为“Enter a message”

23、(你可以删除”Hello World”字符串)。在这份文件中，我们再为后面要添加的按纽加一个字符串“Send”，取名为“button_send”。最终的string.xml如下所示： My First App Enter a message Send Settings MainActivity要获得本地化应用以支持其它语言的相关信息，参看支持不同设备课程。添加Button现在在布局中添加一个，紧随在元素之后。 因为高宽值设置为“wrap_content”，按纽的大小将会自动匹配按纽文本。这个按纽不需要android:id属性，因为代码中没有引用它（维信科技提供）。让输入框填充整个屏幕宽度当前的

24、布局把EditText和Button都设计为自动匹配内容大小，如下图所示：这对按纽没问题，但对文本域就有点不太合适。因为用户可能会输入比较长的内容，最好能让文本域填充屏幕上剩余的空间。你可以通过使用android:layout_weight来指定LinearLayout中的weight属性做到这一点。weight的值是一个数字，它指定了视图使用屏幕剩余空间的数量，这个数量是相对于其它同级视图使用的数量。这有点象饮料配方：2份伏特加，1份咖啡甜酒，意思是一份饮料中，伏特加占了三分之二。例如，你指定一个视图的weight是2，另一个视图的weight是1，总和是3，那么第一个视图将填充剩余空间的三

25、分之二，第二个视图填充余下的部分。如果再添加第三个视图并且weight的值为1，那么第一个视图（weight值为2的那个）将获得剩余空间的一半，另外两个视图每个获得1/4（维信科技提供）。任何视图weight的默认值都是0，所以如果你只为一个视图的weight值指定大于0的数，那么这个视图将填充屏幕上去掉其它视图所占空间后的剩余空间。因此，要让EditText填充屏幕上的剩余空间，我们只需把它的weight值设为1并且不去修改Button的weight值。当指定了weight的值之后，为了提高布局性能，你应该把EditText的width值改为零（0dp）。把宽度设为0dp有助于改善布局性能，

26、因为设为”wrap_content”，系统需要计算所需宽度，而设定了weight的值后，这种计算是没有意义的，系统最终要根据其它视图的宽度来计算剩余空间的宽度。下图为重新分配了weight值之后的效果：以下是完成后的布局文件： 当你创建项目时，SDK工具就把这个布局应用到默认的Activity类了，因此你可以运行应用察看结果：1 在Eclipse中，从工具栏中点击Run 。2 在命令行中，把路径改变到Android项目的根目标中并执行：ant debugadb install bin/MyFirstApp-debug.apk继续下一节课，学习如何响应按纽按下，从文本域从读取内容，启动另一个Ac

27、tivity等更多内容。启动另一个Activity完成了上一节课的内容后，你已经有了一个可以显示包含文本域和按纽的单个Activity的应用（维信科技提供）。在这节课中，你将向MainActivity中添加一些代码，使用户点击“发送“按纽时启动一个新的Activity。响应“发送”按纽要响应按纽的点击事件，打开activity_main.xml布局文件，并向元素添加android:onClick属性。android:onClick属性的值”sendMessage”是当用户点击按纽时，系统调用的Activity类中的方法名称（维信科技提供）。打开MainActivity类(在项目的src/目录下

28、)，添加相应的方法：/* Called when the user clicks the Send button */public void sendMessage(View view) / Do something in response to button这需要你导入View类：import android.view.View;提示：在Eclipse中，按Ctrl + Shift + O导入缺少的类(在Mac中按Cmd + Shift + O)。要让系统匹配在android:onClick属性中指定的方法名，方法签名必须如下所示，具体地说，方法必须：1 是public的2 没有返回值3 仅

29、有一个View类型的参数（表示被点击的View对象）下一步，我们要完成这个方法以读取文本域的内容并把它传递到另一个Activity中（维信科技提供）。创建IntentIntent是一个提供运行时绑定两个独立组件（例如两个Activity）的对象。Intent表示应用“想要做点什么”，你可以用它来完成各种任务，但最常用的是用来启动另一个Activity。在sendMessage()方法中，创建一个Intent对象启动Activity被称为DisplayMessageActivity。Intent intent = new Intent(this, DisplayMessageActivity.c

30、lass);这里使用的构造函数接受两个参数：l 第一个参数是一个Context对象（这里使用了this，因为Activity类是Context类的子类）。l 系统要传递给Intent对象的应用组件的类（本例中，DisplayMessageActivity引用的Activity将被启动）。注意：如果你使用Eclipse这样的IDE，DisplayMessageActivity将引发一个错误，因为类还不存在。目前先忽略这个错误，我们马上就会创建这个类。Intent对象不仅可以启动另一个Activity，还能将数据打包传送到Activity。对sendMessage()方法中，使用findViewB

31、yId()获取EditText元素并把它的文本值添加到Intent对象中。Intent intent = new Intent(this, DisplayMessageActivity.class);EditText editText = (EditText) findViewById(R.id.edit_message);String message = editText.getText().toString();intent.putExtra(EXTRA_MESSAGE, message);注意：你现在要导入android.content.Intent和android.widget.Edi

32、tText这两个类，还要定义EXTRA_MESSAGE常数。Intent可以使用键值对的方式携带各种数据类型的，这个数据集合被称为“extras”，putExtra()方法的第一个参数是键，第二个参数是值。为了在下一个Activity中查询extra集合的数据，你应该定义一个公用的常数来表示extra中的键，因此我们在MainActivity类的顶部增加一个EXTRA_MESSAGE的声明。public class MainActivity extends Activity public final static String EXTRA_MESSAGE = com.example.myfir

33、stapp.MESSAGE; .使用应用的包名做前缀来定义你的Intent对象的extra键是一个好的习惯，这可以确保在你的应用要和其它应用交互时，这个键是唯一的（维信科技提供）。启动第二个Activity要启动一个Activity，调用startActivity()方法并把Intent对象传递给它。系统将接受到调用并启动Intent对象中指定的Activity的实例。用这些新代码完成sendMessage()方法，现在它看上去应该是这样：public void sendMessage(View view) Intent intent = new Intent(this, DisplayMes

34、sageActivity.class);EditText editText = (EditText) findViewById(R.id.edit_message);String message = editText.getText().toString();intent.putExtra(EXTRA_MESSAGE, message);startActivity(intent);现在你需要创建DisplayMessageActivity类了。创建第二个Activity用Eclipse创建新的Activity：1 点击工具栏上的New 。2 在接下来的窗口中，打开Android文件夹，选择An

35、droid Activity，点击Next。3 选择BlankActivity，点击Next。4 填写Activity详细信息：Project：MyFirstAppActivity Name：DisplayMessageActivityLayout Name：activity_display_messageTitle：My MessageHierarchial Parent：com.example.myfirstapp.MainActivityNavigation Type：None点击Finish。Eclipse中的新Activity向导如果你正在使用其它IDE和命令行工具，到项目的src/

36、目录中创建一个新文件命名为DisplayMessageActivity.java。打开DisplayMessageActivity.java文件，如果你是用Eclipse创建的这个Activity：l 类已经包含了onCreate()方法的实现l 这里还包含了一个onCreateOptionsMenu()方法的实现，但是在这个应用中不需要它，你可以删除它。l 这里还包含了一个onOptionsItemSelected()方法的实现，它用来处理操作栏中“Up”的行为，保留它。因为ActionBar API仅在HONEYCOMB（API级别11）或更高版本中支持，你需要在getActionBar(

37、)方法外面添加一个条件语句来检查当前平台版本（维信科技提供）。附带地，你还必须在onCreate()方法前添加SuppressLint(“NewApi”)标记，以避免Lint错误。DisplayMessageActivity类看起来如下所示：public class DisplayMessageActivity extends Activity SuppressLint(NewApi) Override protected void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState); setConten

38、tView(R.layout.activity_display_message); / Make sure were running on Honeycomb or higher to use ActionBar APIs if (Build.VERSION.SDK_INT = Build.VERSION_CODES.HONEYCOMB) / Show the Up button in the action bar. getActionBar().setDisplayHomeAsUpEnabled(true); Override public boolean onOptionsItemSele

39、cted(MenuItem item) switch (item.getItemId() case android.R.id.home: NavUtils.navigateUpFromSameTask(this); return true; return super.onOptionsItemSelected(item); 如果你使用了Eclipse以外的IDE，用上面的代码更新你的DisplayMessageActivity类。Activity的任何子类都必须实现onCreate()方法。当创建Activity新实例时由系统调用这个方法。你必须这个方法中用setContentView()声明

40、Activity布局，并对Activity组件进行初始化。注意：如果你使用Eclipse之外的IDE，你的项目中不会包含setContentView()方法所需的activity_display_message布局文件，这没关系，稍后你将更新onCreate()方法，不会用到那个布局文件。添加标题字符串如果你使用的是Eclipse，你可以跳到下一小节，因为Eclipse已经自动为新Activity提供了标题字符串。如果你使用的是Eclipse之外的IDE，在strings.xml文件中为新Activity添加标题字符串。 . string name=title_activity_display_m