API 级别:9
对于开发者,Android 2.3 (GINGERBREAD) 平台可作为 Android SDK 的可下载组件。可下载的平台包括 Android 库和系统映像,以及一组模拟器皮肤等。如需开始针对 Android 2.3 进行开发或测试,请使用 Android SDK 管理器将该平台下载到您的 SDK 中。
API 概览
以下部分从技术角度简要介绍了 2.3 中面向开发者的新变化,包括自上一版本以来框架 API 的新功能和变更。
基于 SIP 的 VoIP
该平台现在包含一个 SIP 协议栈和框架 API,可让开发者构建网络电话应用。借助该 API,应用可以提供语音通话功能,而无需管理会话、传输级通信或音频,这些都由平台的 SIP API 和服务透明地处理。
SIP API 位于 android.net.sip 软件包中。关键类是 SipManager,应用使用该类来设置和管理 SIP 配置文件,然后发起和接收语音通话。语音通话建立后,应用可以使通话静音、开启扬声器模式、发送 DTMF 音等。应用还可以使用 SipManager 创建通用 SIP 连接。
该平台的底层 SIP 堆栈和服务是否在设备上可用,由制造商和关联运营商自行决定。因此,应用应先使用 isApiSupported() 方法检查是否支持 SIP,然后再向用户提供通话功能。
如需使用 SIP API,应用必须在其清单文件中声明 <uses-permission
android:name="android.permission.INTERNET"> 和 <uses-permission
android:name="android.permission.USE_SIP">,从而向用户请求权限。
此外,开发者可以请求在 Google Play 上进行过滤,以便其应用不会向设备不包含平台 SIP 堆栈和服务的用户显示。如需请求过滤,请将 <uses-feature
android:name="android.software.sip"
android:required="true"> 和 <uses-feature
android:name="android.software.sip.voip"> 添加到应用清单中。
如需了解详情,请参阅 SIP 开发者指南。
近距离无线通信 (NFC)
Android 2.3 包含一个 NFC 堆栈和框架 API,可让开发者读取 NDEF 标签。当用户将支持 NFC 的设备触碰嵌入在贴纸、智能海报甚至其他设备中的标签元素时,系统就会发现这些标签。
该平台提供底层 NFC 服务,这些服务可与设备硬件配合使用,在标签进入感应范围时发现标签。发现标签后,平台会通过广播 intent 来通知应用,并将标签的 NDEF 消息作为 extra 附加到 intent。应用可以创建 intent 过滤器来识别和处理目标标签和消息。例如,在通过 intent 收到标签后,应用会提取 NDEF 消息、存储这些消息、提醒用户或以其他方式处理这些消息。
NFC API 位于 android.nfc 软件包中。关键类如下:
NfcAdapter,表示设备上的 NFC 硬件。NdefMessage,表示 NDEF 数据消息,即在设备和标签之间传输携带数据的“记录”的标准格式。应用可以从ACTION_TAG_DISCOVEREDintent 接收这些消息。NdefRecord,在NdefMessage中传递,用于描述要共享的数据类型并携带数据本身。
NFC 通信依赖于设备硬件中的无线技术,因此特定设备是否支持平台的 NFC 功能由其制造商决定。如需确定当前设备是否支持 NFC,应用可以调用 isEnabled() 来查询 NfcAdapter。不过,无论底层硬件是否支持,NFC API 始终存在。
如需使用 NFC API,应用必须在其清单文件中声明 <uses-permission
android:name="android.permission.NFC">,以向用户请求权限。
此外,开发者可以请求在 Google Play 上进行过滤,以便其应用不会被设备不支持 NFC 的用户发现。如需请求过滤,请将 <uses-feature android:name="android.hardware.nfc"
android:required="true"> 添加到应用的清单中。
如需查看使用 NFC API 的示例应用,请参阅 NFCDemo。
陀螺仪和其他传感器
Android 2.3 为几种新的传感器读数类型(陀螺仪、旋转矢量、线性加速度、重力和气压计)添加了平台和 API 支持。 开发者可以使用新的传感器读数来创建应用,以便快速、顺畅地响应设备位置和运动的精确变化。Sensor API 会向感兴趣的应用(无论是在应用框架上运行还是在原生代码中运行)报告陀螺仪和其他传感器的变化。
请注意,任何给定设备上可用的特定硬件传感器组因设备制造商而异。
开发者可以请求在 Google Play 上进行过滤,以便不向设备不提供陀螺仪传感器的用户显示其应用。为此,请将 <uses-feature
android:name="android.hardware.sensor.gyroscope"
android:required="true"> 添加到应用清单中。
如需了解 API 详情,请参阅 Sensor。
多摄像头支持
现在,应用可以使用设备上的任何可用摄像头来拍摄照片或视频。Camera 允许应用查询可用摄像头的数量以及每个摄像头的独特特性。
- 新的
Camera.CameraInfo类用于存储相机的位置特征(方向、前置或后置)。 Camera类中新增了getNumberOfCameras()和getCameraInfo()方法,可让应用查询可用的相机并打开所需的相机。- 借助新的
get()方法,应用可以检索特定相机的CamcorderProfile。 - 新的
getJpegEncodingQualityParameter()允许应用获取特定相机的静态图片拍摄质量级别。
如需查看用于访问前置摄像头的示例代码,请参阅 ApiDemos 示例应用中的 CameraPreview.java。
Camera API 还添加了:
- 相机的新参数,包括焦距、对焦模式和预览帧速率最大值/最小值。新增了用于获取相机参数的
getFocusDistances()、getPreviewFpsRange()和getSupportedPreviewFpsRange(),以及用于设置预览帧速率的setPreviewFpsRange()。
可混音的音效
该平台的媒体框架新增了对新的单曲或全局音效的支持,包括低音增强、耳机虚拟化、均衡和混响。
- 新的
android.media.audiofx软件包提供了用于访问音效的 API。 - 新的
AudioEffect是用于控制 Android 音频框架提供的音频效果的基类。 - 新的音频会话 ID,可让应用将一组音效与
AudioTrack或MediaPlayer的实例相关联。 - 新增了
AudioTrack类构造函数,可让您创建具有特定会话 ID 的AudioTrack。新增了attachAuxEffect()、getAudioSessionId()和setAuxEffectSendLevel()方法。 - 新增了
attachAuxEffect()、getAudioSessionId()、setAudioSessionId(int)和setAuxEffectSendLevel()方法以及支持类型。
如需查看音效的示例代码,请参阅 ApiDemos 示例应用中的 AudioFxDemo.java。
媒体框架还添加了以下内容:
- 新增了对 JPEG 文件 EXIF 元数据中海拔高度标记的支持。新增了
getAltitude()方法,用于检索 EXIF 高度标记的值。 - 新的
setOrientationHint()方法可让应用在视频拍摄期间告知MediaRecorder方向。
下载管理器
该平台包含一个新的 DownloadManager 系统服务,用于处理长时间运行的 HTTP 下载。应用可以请求将 URI 下载到特定目标文件。DownloadManager 将在后台执行下载,处理 HTTP 交互,并在下载失败后或在连接性发生变化和系统重启时重试下载。
- 应用可以通过调用
getSystemService(String)并传递DOWNLOAD_SERVICE来获取DownloadManager类的实例。通过此 API 请求下载的应用应为ACTION_NOTIFICATION_CLICKED注册广播接收器,以便在用户点击通知中或下载界面中正在进行的下载时进行适当处理。 DownloadManager.Request类可让应用提供请求新下载所需的所有信息,例如请求 URI 和下载目的地。请求 URI 是唯一的必需参数。请注意,默认下载目标位置是共享卷,如果系统需要回收空间供系统使用,则可以删除您的文件。如需永久存储下载内容,请在外部存储空间中指定下载目标位置(请参阅setDestinationUri(Uri))。DownloadManager.Query类提供了一些方法,可让应用查询和过滤活跃下载内容。
StrictMode
为了帮助开发者监控和提升其应用的性能,该平台提供了一个名为 StrictMode 的新系统工具。在应用中实现 StrictMode 后,它会捕获可能降低应用性能的意外磁盘或网络活动(例如在应用的主线程中发生的活动,即接收界面操作和播放动画的位置),并通知开发者。开发者可以评估 StrictMode 中提出的网络和磁盘使用问题,并在需要时进行更正,从而使主线程更具响应性,并防止向用户显示 ANR 对话框。
StrictMode是核心类,也是与系统和虚拟机的主要集成点。该类提供了便捷的方法来管理适用于实例的线程和虚拟机政策。StrictMode.ThreadPolicy和StrictMode.VmPolicy包含您定义并应用于线程和虚拟机实例的政策。
如需详细了解如何使用 StrictMode 优化应用,请参阅 android.os.StrictMode 处的类文档和示例代码。
界面框架
- 支持滚动回弹
- 在视图和微件中新增了对滚动回弹的支持。在 View 中,应用可以为给定视图启用/停用滚动回弹、设置滚动回弹模式、控制滚动回弹距离,以及处理滚动回弹的结果。
- 在微件中,应用可以控制滚动回弹特性,例如动画、回弹和滚动回弹距离。如需了解详情,请参阅
android.view.View和android.widget.OverScroller。 ViewConfiguration还提供了getScaledOverflingDistance()和getScaledOverscrollDistance()方法。- 为
<ListView>元素新增了overScrollMode、overScrollFooter和overScrollHeader属性,用于控制滚动回弹行为。
- 支持触摸过滤
- 新增了对触摸过滤的支持,使应用能够提高提供对敏感功能访问权限的 View 的安全性。例如,触摸过滤功能适用于确保用户操作(例如授予权限请求、进行购买或点击广告)的安全性。如需了解详情,请参阅 View 类文档。
- 为视图元素新增了
filterTouchesWhenObscured属性,用于声明当视图的窗口被另一个可见窗口遮挡时是否过滤触摸。如果设置为"true",则每当视图窗口上方出现消息框、对话框或其他窗口时,视图都不会接收轻触。如需了解详情,请参阅查看安全文档。
如需查看触摸过滤的示例代码,请参阅 ApiDemos 示例应用中的 SecureView.java。
- 改进了事件管理
- 输入事件的新基类
InputEvent。该类提供的方法可让应用确定事件的含义,例如通过查询事件源自的 InputDevice。KeyEvent和MotionEvent是InputEvent的子类。 - 输入设备的新基类
InputDevice。该类会存储有关特定输入设备功能的信息,并提供一些方法,让应用能够确定如何解读来自输入设备的事件。
- 输入事件的新基类
- 改进了动作事件
MotionEventAPI 经过扩展,包含“指针 ID”信息,可让应用在手指上下移动时跟踪各个手指。该类添加了各种方法,使应用能够高效处理动作事件。- 输入系统现在具有使用新指针 ID 信息生成动作事件的逻辑,可在新指针按下时合成标识符。系统会在动作事件期间分别跟踪多个指针 ID,并通过评估上一组指针和下一组指针之间的距离来确保指针的适当连续性。
- 文本选择控件
- 借助新的
setComposingRegion方法,应用可以将文本区域标记为正在撰写的文本,并保持当前样式。getSelectedText方法会将所选文本返回给应用。这些方法在BaseInputConnection、InputConnection和InputConnectionWrapper中提供。 <TextView>的新textSelectHandle、textSelectHandleLeft、textSelectHandleRight和textSelectHandleWindowStyle属性,用于引用将用于显示文本选择锚点的可绘制对象以及包含窗口的样式。
- 借助新的
- 活动记录控制选项
ActivityInfo添加了用于管理 activity 方向的新常量:SCREEN_ORIENTATION_FULL_SENSOR、SCREEN_ORIENTATION_REVERSE_LANDSCAPE、SCREEN_ORIENTATION_REVERSE_PORTRAIT、SCREEN_ORIENTATION_SENSOR_LANDSCAPE和SCREEN_ORIENTATION_SENSOR_PORTRAIT。ActivityManager.RunningAppProcessInfo中的importance字段新增了常量IMPORTANCE_PERCEPTIBLE。该值表示特定进程正在运行被视为用户可主动感知的内容。例如,执行后台音乐播放的应用。- 用于将 Activity 标记为永久性的 Activity.setPersistent(boolean) 方法现已弃用,并且实现为空操作。
- 通知文本和图标样式
超大屏幕
该平台现在支持超大屏幕尺寸,例如平板电脑设备上可能采用的尺寸。开发者可以通过向其清单文件中添加 <supports
screens ... android:xlargeScreens="true"> 元素,指明其应用旨在支持超大屏幕尺寸。应用可以使用新的资源限定符 xlarge 来标记特定于超大屏幕的资源。如需详细了解如何支持超大屏幕和其他屏幕尺寸,请参阅支持多种屏幕。
图形
- 在
android.opengl.GLES20类中添加了其余 OpenGL ES 2.0 方法glDrawElements()和glVertexAttribPointer()。 - 添加了对
YV12像素格式(一种平面 4:2:0 YCrCb 格式)的支持。
内容提供程序
- 用于设置闹钟或处理闹钟的新
AlarmClock提供程序类。该提供程序包含一个ACTION_SET_ALARMintent 操作和 extra,可用于启动 activity 以在闹钟应用中设置新闹钟。想要接收SET_ALARMintent 的应用应创建需要 SET_ALARM 权限的 activity。想要创建新闹钟的应用应使用Context.startActivity(),以便用户可以选择要使用的闹钟应用。 MediaStore支持新的 intent 操作PLAY_FROM_SEARCH,该操作可让应用搜索音乐媒体,并在可能的情况下自动播放搜索结果中的内容。例如,应用可以触发此 intent,作为语音识别命令的结果来听音乐。MediaStore还添加了一个新的MEDIA_IGNORE_FILENAME标志,用于告知媒体扫描器忽略包含目录及其子目录中的媒体。 开发者可以使用此文件来避免图片出现在图库中,并防止应用声音和音乐出现在音乐应用中。Settings提供程序添加了新的 Activity 操作APPLICATION_DETAILS_SETTINGS和MANAGE_ALL_APPLICATIONS_SETTINGS,可让应用显示特定应用的详细信息屏幕或显示“管理应用”屏幕。ContactsContract提供程序会添加ContactsContract.CommonDataKinds.SipAddress数据类型,用于存储联系人的 SIP(互联网电话)地址。
位置
LocationManager现在会根据WorkSource(一个用于标识应用的系统管理类)跟踪导致唤醒锁定或 Wi-Fi 锁定的应用请求。LocationManager会跟踪请求定期更新的所有客户端,并在设置其最短更新时间时,以WorkSource参数的形式告知其提供程序。网络位置信息提供程序使用WorkSource跟踪由应用发起的唤醒和 Wi-Fi 锁定,并将其添加到“管理应用”中报告的应用电池用量中。LocationManager添加了几个新方法,可让 Activity 注册以根据指定条件接收定期或一次性位置信息更新(见下文)。- 借助新的
Criteria类,应用可以指定一组用于选择位置信息提供程序的条件。例如,可以根据准确性、耗电量、报告海拔、速度和方位的能力以及货币成本对提供程序进行排序。
存储
- Android 2.3 添加了支持 OBB(不透明二进制 blob)文件的新
StorageManager。虽然 Android 2.3 中提供了对 OBB 的平台支持,但用于创建和管理 OBB 文件的开发者工具要到 2011 年初才会推出。 - Android 2.3 平台增加了对不含 SD 卡的设备的官方支持(不过,当没有实体 SD 卡时,它会提供虚拟 SD 卡分区)。便捷方法
isExternalStorageRemovable()可让应用确定是否存在实体 SD 卡。
软件包管理器
- 用于声明硬件和软件功能的新常量。请参阅下文新功能常量部分中的列表。
PackageInfo添加了新的firstInstallTime和lastUpdateTime字段,用于存储软件包安装和上次更新的时间。- 新增了
getProviderInfo()方法,用于检索有关特定 content provider 类的所有已知信息。
电话
TelephonyManager添加了常量NETWORK_TYPE_EVDO_B,用于指定 CDMA EVDO Rev B 网络类型。- 新增了
getPsc()方法,用于返回 UMTS 网络上服务小区的主扰码。
原生访问 activity 生命周期、窗口
Android 2.3 向使用原生代码的应用公开了一组广泛的 API。此类应用关注的框架类包括:
NativeActivity是一种新型 Activity 类,其生命周期回调直接在原生代码中实现。NativeActivity及其底层原生代码在系统中的运行方式与其他 activity 相同,具体而言,它们在 Android 应用的系统进程中运行,并在应用的主界面线程上执行,而且它们会收到与其他 activity 相同的生命周期回调。- 新的
InputQueue类和回调接口可让原生代码管理事件排队。 - 新的
SurfaceHolder.Callback2接口可让原生代码管理SurfaceHolder。 Window中新增了takeInputQueue和takeSurface()方法,可让原生代码管理事件和 Surface。
如需详细了解如何使用原生代码或下载 NDK,请参阅 Android NDK 页面。
Dalvik 运行时
dalvik.system移除了之前已废弃的多个类。- Dalvik 核心库:
- 新集合:
ArrayDeque、NavigableMap、ConcurrentSkipListMap、LinkedBlockingDeque - 新增了
Arrays实用程序:binarySearch()、copyOf()、copyOfRange()等。 CookieManager,HttpURLConnection。- 更完整的网络 API:
InterfaceAddress、NetworkInterface和IDN File读写控件String.isEmpty()Normalizer和Normalizer.Form- 改进了
javax.net.ssl服务器端套接字。
- 新集合:
新的清单元素和属性
<supports-screens>元素的新xlargeScreens属性,用于指示应用是否支持超大屏幕这种设备类型。如需了解详情,请参阅支持多种屏幕。<activity>元素的android:screenOrientation属性的新值:"reverseLandscape"- Activity 希望屏幕方向为横向,但与正常横向方向相反。"reversePortrait"- Activity 希望屏幕采用纵向方向,但与正常纵向方向相反。"sensorLandscape"- Activity 希望屏幕采用横向方向,但可以使用传感器来更改屏幕朝向。"sensorPortrait"- Activity 希望屏幕处于纵向方向,但可以使用传感器来更改屏幕朝向。"fullSensor"- 屏幕方向由物理方向传感器决定:显示内容会随用户手持设备的方向而旋转。这允许使用 4 种可能的旋转方向中的任何一种,无论设备在正常情况下使用哪种方向(例如,一些设备正常情况下不使用 180 度旋转)。
新权限
com.android.permission.SET_ALARM- 允许应用广播 Intent,以便为用户设置闹钟。处理SET_ALARMintent 操作的 activity 应需要此权限。android.permission.USE_SIP- 允许应用使用SIP API拨打或接听网络电话。android.permission.NFC- 允许应用使用NFC API读取 NFC 标签。
新功能常量
该平台添加了多项新的硬件功能,开发者可以在其应用清单中声明这些功能是其应用所必需的。这样,开发者就可以控制其应用在 Google Play 上发布时的过滤方式。
android.hardware.audio.low_latency- 应用在设备上使用低延迟音频管道,并且对声音输入或输出的延迟或滞后敏感。android.hardware.camera.front- 应用使用设备的前置摄像头。android.hardware.nfc- 应用使用设备中的 NFC 无线电功能。android.hardware.sensor.barometer- 应用使用设备的气压计。android.hardware.sensor.gyroscope- 应用使用设备的陀螺仪传感器。android.software.sip- 应用使用设备上的 SIP API。android.software.sip.voip- 应用在设备上使用基于 SIP 的 VoIP 服务。android.hardware.touchscreen.multitouch.jazzhand- 应用使用设备屏幕上的高级多点多点触控功能,从而完全独立地跟踪五个或更多点。
如需全面了解如何声明功能并将其用于过滤,请参阅 <uses-feature> 的文档。
API 差异报告
如需详细了解 Android 2.3(API 级别 9)中的所有 API 变更,请参阅 API 差异报告。
API 级别
Android 2.3 平台提供了一个更新版本的框架 API。Android 2.3 API 分配有一个整数标识符 9,该标识符存储在系统本身中。此标识符称为“API 级别”,可让系统在安装应用之前正确确定应用是否与系统兼容。
如需在应用中使用 Android 2.3 中引入的 API,您需要针对 Android 2.3 SDK 平台中提供的 Android 库编译应用。根据您的需求,您可能还需要向应用清单中的 <uses-sdk> 元素添加 android:minSdkVersion="9" 属性。如果您的应用设计为仅在 Android 2.3 及更高版本上运行,则声明该属性可防止应用安装在较低版本的平台上。
如需了解详情,请参阅什么是 API 级别?