开发者指南

欢迎来到Android开发指南!本指南提供了开发Android程序的实用指导和有关平台主要特性的文档。指南挖掘了Android背后的理念,解析了构造应用程序的框架,并介绍了在平台上开发、测试和发布软件的工具。

开发指南包含了Android平台的大部分文档,但不包括框架API的参考资料。对于API的特性,请见参考。

本指南分为若干部分:

Android基础

对Android的最初介绍——它是什么,它提供了哪些内容,你的程序如何适于Android。

框架主题

讨论Android框架和API的具体部分。通过应用程序基础一文获取对框架的简单介绍。之后按需探索其他的主题——从设计用户界面并设置资源到存储数据及使用权限。

Android Market主题

与在Android Market中发布并销售应用程序的主题有关的文档,例如如何加强授权政策以及应用程序内付款。

开发

使用Android开发调试及测试工具的说明。

发布

关于如何准备部署你的应用程序以及如何在准备好之后发布它的一些说明。

基本练习

关于编写高效率高兼容性的应用的推荐技巧。

网络应用程序

关于如何创建无缝运行于Android设备上的网络应用程序以及创建嵌有基于网络的内容的Android应用程序的文档。

附录

参考信息和特性,以及常见问答、术语表和其他信息。

在下载了SDK之后,从阅读开发指南起步吧。如果想要通过查看代码来开始学习,Hello Wordl教程通过一个标准的“Hello World”程序向你介绍了Android应用程序的一些基础知识。应用程序基础文档是学习应用程序框架的一个不错的入门材料。

要获取更多帮助,可以考虑加入一个或多个Android讨论小组。前往开发者论坛页面以了解更多。

本作品采用知识共享 署名-非商业性使用-禁止演绎 3.0 Unported许可协议进行许可。

WordPress 3.1升级完成

今天把博客升级到了WordPress 3.1,有些不习惯呢。意外的收获是修复了一些之前始终没能解决的小问题。

搭建这个博客以来,主要写的都是Android方面的东西,其实本来是想多写点自己的想法的。时间不够用啊。不过日积月累下来,也多不少内容了。今后也会继续好好打理这个博客。

Android 3.0正式发布后的一点与技术无关的感想

今天Android SDK发布了新的版本,主要内容即是Android 3.0的Honeycomb。 官方网站的Dev Guide也作了很大幅度的调整。稍微看了一下,主要是增加了新的API Level 11中的内容,原有的部分也是比以前更有条理了。 不过,这也意味着自己之前的翻译不得不做比较大的调整。

新的SDK还增加了一个XVGA分辨率的皮肤,自己的笔电分辨率刚好到XVGA而已(虽然说可以缩小显示尺寸…)。由于各种因素,近期应该还不会涉足平板用的程序。

其实自己之前版本的要素还没有完全摸透,现在又增加了那么多新内容,还真是不得了……再有几天就要开学了,不得不更加抓紧时间才行。

自从接触Android开发后,就觉得是在和Google赛跑。新的内容推出的速度似乎是有些太快了。当然我这样的业余开发者有这种感觉也是很正常的吧。况且和那些牛人比起来,自己花在玩上的时间还是太多了。

没办法,慢慢来吧。只要不断前进就好。

Android中创建并使用上下文菜单(Context menu)

代码与范例:

说明:正如用户界面一文中所提到的,Android支持长按项目弹出上下文菜单。上下文菜单相当于桌面系统中的鼠标右键菜单,设计合理的上下文菜单可以提高程序的可用性。通常上下文菜单配合ListActivity使用。使用上下文菜单需要覆盖onCreateContextMenu和onContextItemSelected这两个方法。此外,必须要在活动的onCreate()方法中注册上下文菜单。使用以下语句即可:

Android用日常事项管理软件 Routine

一直以来对GTD相关的内容比较有兴趣,也试过各种各样的电子GTD工具,可是一直没有特别满意的。之前一直用的是Android上的Gtasks。这是一个不错的软件,但是含有广告、反应速度慢、有太多多余功能以及偶尔会出现条目丢失的Bug等问题还是让人觉得不尽人意。还试过Jorte,这款软件的优点是界面美观,不足之处则是反应速度略慢,设置过于繁琐对我而言无用的功能还是太多。由于这些原因,决定自己动手写一个简洁的GTD工具,也就是本文要介绍的Routine。

相比已有的数量众多的GTD工具,Routine有以下特点:

  • 稳定可靠:由于结构简单,而最大限度地确保了程序的稳定性。
  • 反应迅速:由于没有多余功能,因而Routine得以快速地启动、关闭。
  • 功能简洁:专注于GTD本身即可。
  • 界面美观:专门针对Xperia机型设定了背景,而非不少Android程序所使用的黑色背景。不过只有在Xperia机型上才会显示,以避免在原生Android系统中的不协调。
  • 没有广告:对于这种需要经常使用的程序如果加入广告还真是影响速度、增加网络流量还影响心情。所以Routine没有也不会有广告。
  • 多国语言支持:简体中文、繁体中文、英语、日语。其中英语和日语受自己水平所限难免不地道,敬请指正。

目前Routine可以在Android Market的效率类应用程序中找到,搜索Routine、ルーチン或者pub:BREEZE即可。如果需要一款简单好用的GTD工具,不妨试试看Routine吧。

Android Market页面:

http://market.android.com/details?id=org.breezesoft.routine

最后是一些Routine的程序截图:

创建菜单

菜单是程序重要的一部分,它提供给用户一个熟悉的接口以进入程序功能或是设置。Android提供了一个简单的框架以供为应用程序提供标准的菜单。

有三种类型的应用程序菜单:

选项菜单

当用户按下菜单键后出现的一个程序中主要的菜单项目的集合。如果程序运行在Android3.0或更新的版本时,可以将菜单项目直接置于操作条作为快捷方式,也就是“操作项目”。

上下文菜单

当用户长按一个注册了上下文菜单的视图时出现的浮动菜单项目列表。

子菜单

当用户按下一个包含嵌套菜单的菜单项目时出现的浮动菜单项目列表。

本文档将说明创建每一种菜单的方式,如何使用XML来定义菜单的内容以及程序中响应用户选择项目的回馈方法。

创建菜单资源

不应当在程序代码中实例化菜单,而要在XML菜单资源中定义一个菜单和它的所有项目,并在程序代码中解压(作为可编程对象载入)该菜单资源。通过菜单资源来定义菜单是推荐的做法,因为这样可以从程序代码中分离菜单内容。通过XML也能更容易地可视化菜单的结构和内容。

要创建菜单资源,要在工程的res/menu目录下创建XML文件并通过以下元素构建菜单:

<menu>

定义包含菜单项目的菜单。<menu>元素必须是文件的根节点以包含一个或多个<item><group>元素。

<item>

创建一个在菜单中表示单个项目的MenuItem。该元素可以包含潜逃<menu>元素以创建子菜单。

<group>

一种可选的<item>元素的不可见的容器。它可以分类菜单项目以共享如活动状态和可见性等属性。参见“菜单组”一节。

这里有一个名为game_menu.xml的菜单范例:

该范例定义了一个包含两个项目的菜单。每一个项目包含这些属性:

android:id

项目唯一的资源ID,让程序可以在用户选择时识别项目。

android:icon

作为项目图标的drawable资源的引用。

android:title

作为项目标题的字符串的引用。

还可以在<item>中包含更多的属性,其中一些可以定义项目如何出现在动作条中。关于XML语法和菜单资源的属性的更多信息,参阅“菜单资源引用”。

解压菜单资源

可以在程序代码中通过MenuInflater.inflate()解压菜单资源(将XML资源转换为可编程对象)。比如,下面的代码在onCreateOptionsMenu()中解压了前面定义的game_menu.xml,用以作为活动的选项菜单:

getMenuInflater()方法返回给活动一个MenuInflater。这个对象可以调用inflate()来解压一个菜单资源使之成为一个Menu对象。在本例中,game_menu.xml定义的菜单资源被解压为Menu后被传递至onCreateOptionsMenu()。(这一选项菜单的回馈方法将在下一节中详细讨论。)

创建选项菜单

选项菜单中应当包含有基本的活动行为和必要的导航项目(比如,一个用以打开程序设置的按钮)。选项菜单中的项目可以通过两种不同的途径访问:MENU键或者是动作条(仅用于运行Android 3.0或更高版本的设备)。

在使用Android 2.3或更低的系统的设备上,选项菜单出现于屏幕底部,如图1所示。当被打开后,选项菜单首先可见的部分是图标菜单。它包含了前六个菜单项目。如果选项菜单中添加了六个以上的项目,Android会将第六个和之后的项目放入溢出菜单,在用户点击“More”菜单项目时被打开。

Figure 1
图1. 浏览器中选项菜单的截图

在Android 3.0或更高版本中,选项菜单中的项目被置于位于活动顶部的动作条中,取代了传统的标题栏的位置。选项菜单中所有的项目默认是置于溢出菜单中的,用户可以点击动作条右部的菜单图标来打开。不过,也可以把一些菜单项目作为“动作项目”直接置于动作条以便快速选择,如图2所示。

 

图 2. Email程序中动作条的截图,有两个选项菜单中的动作项目,以及一个溢出菜单。

当Android系统第一次创建选项菜单时,会调用活动的onCreateOptionsMenu()方法。在活动中覆盖这个方法,加入要传递给这个方法的Menu,按照之前在“解压菜单资源”中所说的方式解压菜单资源。比如说:

也可以在代码中加入菜单,使用add()来添加项目至菜单。

注意:在Android 2.3 或更低的版本中,系统在用户第一次打开选项菜单时才调用onCreateOptionsMenu()来创建它,但是在Android 3.0及以后,系统在活动被创建时就会马上创建选项菜单以设置动作条。

响应用户动作

当用户从选项菜单(以及动作条中的动作项目)中选择了一个菜单项目,系统会调用活动的onOptionsItemSelected()方法。该方法传递用户选择的MenuItem。可以通过调用getItemId()来识别菜单项目,它会返回菜单项目的唯一ID(它是在菜单资源中通过android:id属性定义,或者使用add()方法给定的一个整数)。可以将此ID与已知的菜单项目配对以执行正确的动作。例如:

在这个例子中,getItemId()请求所选菜单项目的ID,switch语句则比较这些ID和XML资源中分配的菜单项目资源ID。当一个switch case成功配对菜单项目,它返回true以表示菜单选择已被处理。否则,如果父类可以处理项目的话默认语句将传递菜单项目至其父类。(如果是直接扩展于Activity类的话,父类会返回false,不过比起直接返回false,传递未被处理的菜单项目至其父类是一种比较好的做法)。

此外,Android 3.0增加了可以在XML菜单资源中通过使用android:onClick属性定义菜单项目单击行为的功能。因此不需要使用onOptionsItemSelected()。使用android:onClick属性,可以指定用户选择菜单项目时调用某一方法。活动之后会调用在android:onClick属性中指定的方法以接受一个单独额MenuItem参数——当系统调用该方法时,会传递所选择的菜单项目。

Tip:如果程序包含多个活动,并且一些活动提供了相同的选项菜单的话,可以考虑创建一个活动只使用onCreateOptionsMenu()和onOptionsItemSelected()方法。之后将这个类扩展用于共用该选项菜单的活动。这样一来,只需要管理一组处理菜单动作的代码即可,其他每一个后继类都会继承其菜单行为。

如果想要在某一个后继活动中增加菜单项目,就在该活动中覆盖onCreateOptionsMenu()。调用super.onCreateOptionsMenu(menu)以创建菜单,之后使用menu.add()增加新菜单项目。也可以覆盖父类的行为来设置单个的菜单项目。

在运行时改变菜单项目

一旦活动被创建,onCreateOptionsMenu()方法只会像前面描述的那样被调用一次。系统会在活动被销毁前保持和重用在该方法中定义的菜单。如果想在创建后的任意时间改变选项菜单,就必须覆盖onPrepareOptionsMenu()方法。它将传递当前存在的Menu对象。当希望根据程序的当前状态来删除、添加、禁用或启用菜单项目时,这种做法会很有用。

在Android 2.3或更低版本上, 系统会在每一次用户打开选项菜单时调用onPrepareOptionsMenu()。

在Android 3.0或更高版本,则需要在想要更新菜单时调用invalidateOptionsMenu(),因为菜单是始终打开的。系统之后会调用onPrepareOptionsMenu()来更新菜单项目。

注意:不能改变基于当前处于焦点下的视图的选项菜单的项目。在触摸模式下(即用户没有使用轨迹球或是指点杆),视图无法成为焦点,因此不应该将焦点作为改变选项菜单项目的基础。如果想要创建对视图上下文敏感的菜单项目,请使用上下文菜单。

如果开发平台是Android 3.0或更高,确保阅读过“使用动作条”一文。

创建上下文菜单

上下文菜单从理念上来说类似于在PC上用户“右键单击”时显示的菜单。应该提供给用户上下文菜单以执行对于用户界面上属于某一特定项目的操作。在Android上,上下文菜单会在用户“长按”(按下不放)某一项目时被显示。

可以为任意View创建上下文菜单,不过上下文菜单通常被用于ListView中的项目。当用户长按ListView中的一个项目并且该列表被注册提供一个上下文菜单时,该列表项目会改变背景色以告知用户上下文菜单是可用的——它用橙黄色转变为白色并打开上下文菜单。(通讯录程序展示了这一特性。)

为了让一个View提供上下文菜单,比如给该视图“注册”一个上下文菜单。调用registerForContextMenu()并传递想要添加上下文菜单的视图。当该视图收到长按操作时,它会显示上下文菜单。

要定义上下文菜单的外观和行为,需要覆盖活动的上下文菜单回馈方法,即onCreateContextMenu()和onContextItemSelected()。

注册一个ListView

如果活动使用ListView并且希望所有的列表项目都提供上下文菜单,就要通过传递该ListView至registerForContextMenu()来为所有的项目注册上下文菜单。比如,如果正在使用ListActvity,就像这样注册所有的列表项目:

registerForContextMenu(getListView());

举例来说,这里有一个使用了context_menu.xml菜单资源的的onCreateContextMenu():

MenuInflater用于从菜单资源中解压上下文菜单。(也可以使用add()来添加菜单项目。)回馈方法参数包括用户所选择的View和提供所选项目附加信息的ContextMenu.ContextMenuInfo对象。可以用这些参数来判定应当创建哪一个上下文菜单,不过在这个例子中,活动所使用的所有上下文菜单都是相同的。

之后当用户从上下文菜单中选择了一个项目时,系统将调用onContextItemSelected()。这里有一个例子来说明如何处理选中的项目:

这段代码的结构与创建选项菜单的例子中的相似,getItemId()询问了所选项目的ID,一个switch语句来匹配菜单资源中所定义的项目ID。和选项菜单的例子一样,默认语句调用了父类以备处理当前类无法处理的项目。

在本例中,所选的项目是ListView中的一个项目。为了实现对所选项目的操作,程序需要知道所选项目的列表ID(即在ListView中的位置)。为了取得此ID,程序调用了getMenuInfo(),来返回包含id域中所选项目列表ID的一个AdapterView.AdapterContextMenuInfo对象。本地方法editNote()deleteNote()方法将接受该列表ID来对指定列表ID的数据进行操作。

注意:上下文菜单中的项目不支持图标或快捷键。

创建子菜单

子菜单是一种用户在选择另一菜单中的项目时打开的菜单。可以向任何菜单(除了子菜单)添加子菜单。子菜单在程序有大量可以按主题来组织的功能时很有用,就好象是PC程序的菜单栏(文件、编辑、视图等)。

当创建菜单资源时,可以通过添加一个<menu>元素作为一个<item>的子元素来创建子菜单,例如:

当用户从子菜单中选择了一个项目时,父级菜单的项目被选择时的回馈方法会接受这一事件。例如,如果上级菜单是一个选项菜单,那么onOptionsItemSelected()方法会在子菜单项目被选择时被调用。

也可以用addSubMenu()来动态地想已存在的菜单添加SubMenu。它会返回新的SubMenu对象,可以通过add()来对其添加子菜单项目。

其他菜单特性

对于大多数菜单来说还可以应用其他一些菜单特性。

菜单组

菜单组是共享某些特性的菜单项目的集合。将它们分成组后,可以:

  • 通过setGroupVisible()显示或隐藏所有项目
  • 通过setGroupEnabled()启用或禁用所有的项目
  • 通过setGroupCheckable()来设定是否所有项目都是可标记的

可以通过在菜单资源内的<group>元素内嵌套<item>元素以创建菜单组或是通过add()方法来指定一个组ID。

这里是一个包含了组的菜单资源的例子:

组中的那些项目似乎和那不在组中的第一个项目看起来是一样的——所有三个菜单内的项目是同级关系。不过,可以通过引用组ID和前面提到的方法来调整组中的两个项目的特性。

可标记菜单项目

对独立选项设置复选框或是对互斥选项设置单选框的话,菜单可以作为一种有用的开启或关闭选项的接口。图3展示了具有可单选项目的子菜单。

图 3.一个具有可选中项目的子菜单的截图

注意:图标菜单(来自于选项菜单)中的菜单项目不能设置复选框或是单选框。如果希望让图标菜单中的项目可被选中,必须在每次状态改变时通过改变图标和/或文字来手动指定选中状态。

可以使用<item>元素中的android:checkable属性为单个菜单项目定义选中行为,或使用<group>元素中的android:checkableBehavior属性来为整个组设置行为。比如,这个菜单组中的所有项目都可以单选:

android:checkableBehavior属性接受下列值其中之一:

single

组中只有一个项目可被标记(单选框)

all

所有项目可被标记(复选框)

none

没有项目可被标记

可以使用<item>元素中的android:checked属性来给项目设定默认标记状态,并在代码中用setChecked()方法来改变它。

当一个可标记项目被选中时,系统将调用特定的项目选择方法(比如onOptionsItemSelected())。在这里必须设定复选框的状态,因为复选框或是单选框不会自动改变其状态。可以用isChecked()获取项目当前状态(在用户选中之前)之后用setChecked()来设定其选中状态。例如:

如果不这样设定选中状态,项目(复选框或是单选框)的可见状态则会在用户选中时才改变。当设置了状态后,活动会保存项目的选中状态,这样之后用户打开菜单时,所设定的选中状态将是可见的。

注意:可选中菜单项目仅用于单次活动,不会再程序被销毁后保存。如果程序包含希望保存的设置,应当使用“共享偏好(Shared Preferences)”来存储数据。

快捷键

如果用户的设备有物理键盘,那么可以通过<item>元素中的android:alphabeticShortcutandroid:numericShortcut属性添加键盘字母/数字快捷键以支持对选项菜单中项目的快速选择。也可以用setAlphabeticShortcut(char)和setNumericShortcut(char)方法。快捷键对大小写敏感。

比如,如果应用“s”字符作为“保存(save)”菜单项目的字母快捷键,那么当菜单打开(或是用户按住菜单键)并且用户按下“s”键时,菜单项目“保存”就被选中。

快捷键作为一种提示被显示在菜单项目里,位于菜单项目名称之下(不过图标菜单中则是只有在用户按住菜单键时才会显示)。

注意:菜单项目的快捷键只能用于有物理键盘的设备。快捷键不能被添加到上下文菜单中的项目。

动态添加菜单意图

有时会希望菜单项目通过一个Intent来启动一个活动(无论这个活动属于自身所在的程序还是其他的程序)。当确定想要使用的意图并且有一个用以初始化该意图的特定菜单项目时,可以在恰当的项目选中方法中(比如onOptionsItemSelected()回馈方法)通过startActivity()来执行该意图。

不过,如果不确定用户的设备中包含可以处理该意图的程序的话,由于意图可能不能启动一个活动,所以就要增加一个在被调用时会生成一个无功能的菜单项目的菜单项目。为了实现这一效果,Android允许当在设备上发现可以处理该意图的活动时再向菜单动态添加菜单项目。

为了增加基于可接受一个意图的活动的菜单项目:

  1. 定义一个类别为CATEGORY_ALTERNATIVE和/或CATEGORY_SELECTED_ALTERNATIVE的意图,以及其他所需的内容。
  2. 调用Menu.addIntentOptions()。Android之后会搜索可执行该意图的程序并将其添加至菜单。

如果没有安装满足该意图的程序,就不会添加任何的菜单项目。

注意:CATEGORY_SELECTED_ALTERNATIVE用于处以屏幕上当前选中的元素。因此,只应当在当在onCreateContextMenu()创建Menu时使用。

例如:

每一个被发现提供了匹配所定义的意图的意图过滤器的活动将被添加一个菜单项目。意图过滤器的android:label的值会被作为菜单项目的标题,程序的图标则作为菜单项目的图标。addIntentOptions()方法会返回所添加的菜单项目的数量。

注意:当调用addIntentOptions()时,它会覆盖所有的由第一个参数指定的菜单组的菜单项目。

允许活动被添加至其他菜单

可以使自己的活动提供为其他程序所用的服务,这样自己的程序就可以被其他活动包含在菜单中(即前述内容的角色互换)。

为了能被包含在其他程序菜单中,需要和通常一样定义一个意图过滤器,不过必须在意图过滤器类别中包含CATEGORY_ALTERNATIVE和/或CATEGORY_SELECTED_ALTERNATIVE的值。例如:

可以在“意图和意图过滤器”文档中阅读更多关于意图过滤器的书写。

参见Note Pad范例代码以了解一个使用该技术的范例程序。

本页部分内容根据Android Open Source Project创作并共享的内容修改,并在知识共享 署名2.5许可协议中所述条款的限制下使用。

今日MWC2011索尼爱立信发布Xperia Play等3款Xperia新机型

今天是MWC2011的第一天。和预定的一样,索尼爱立信公布了Xperia家族的新成员。本文是一篇简单的信息梳理:

Xperia PLAY

Xperia Play是第一款也是目前唯一的一款PlayStation Certified的Android智能手机。提供了完整的PlayStation实体按键以及两个触摸式摇杆。除此之外,强大的图形性能和丰富的游戏支持将会是其游戏体验的保证。

官方页面点这里

Xperia neo

Xperia neo是一款主打影像功能的Android智能手机。人体工学的外形之下有着Mobile Bravia Engine和Exmor R for Mobile传感器,同时具备HDMI高清视频输出。

官方页面点这里

Xperia pro

和往常一样,标记以pro字样的将是侧滑全键盘手机。得益于全键盘的搭载,Xperia pro在文字输入方面会有优秀的表现。而Mobile BE、Exmor R for Mobile和HDMI输出同样出现在Xperia pro上,确保了其全方面的性能。

官方网页点这里

所有3款机型都将预搭载Android 2.3。

可以发现,在之前的CES2011上公布的Xperia arc除了8.7mm的超薄机身和流线型外形之外比之今天发布的新机型并没有绝对的优势,因此称其为Xperia新旗舰也许并不合适了吧(笑)。期待今年的索尼爱立信能继续有好的表现。

注:本文中所使用的图片素材版权属于Sony Ericsson Mobile Communication AB

Android中使用OpenGL显示背景层透明度PNG图片

代码:

说明:使用这两句语句就可以在渲染时将PNG图片的背景透明化。注意PNG必须是32位的。如果不使用这两句,PNG图片则是显示黑色背景。

Android中OpenGL ES贴图无法显示问题的可能原因

最近在Android中使用OpenGL时遇到了这样的问题:一切代码没有问题,模拟器上也运行正常,但是在实机上就会出现贴图错误,纹理无法显示,只有灰白的底色。

对于这个问题找了很久的解决方法,都没有成功。最后发现其实是文件夹名称的问题。贴图文件原来是保存于drawable文件夹下的,并没有根据Dpi而建立多个文件夹,以为这样就会默认使用drawable文件夹内的资源。对于模拟器而言确实如此,但是对于实机就会出现问题。解决方法是建立drawable-nodpi文件夹,至少对我的情况来说问题就得到了解决。

另外看到的其他的可能原因还有贴图本身的问题,比如说文件尺寸过大、边长不是2的n次方等。我在自己的X10上测试了一下,边长确实有着前述的限制,不过即使是1024依旧可以正确显示,可见对文件大小的要求并不严苛。经测试1024×1024分辨率32位的PNG没有问题。