Android 5.0 API

API 级别:21

Android 5.0 (LOLLIPOP) 为用户和应用开发者提供了新功能。本文档介绍了最值得注意的新 API。

如果您有已发布的应用,请务必查看您应在应用中考虑的 Android 5.0 行为变更。即使您未使用新 API 或未以新功能为目标,这些行为变更也可能会影响您的应用在 Android 5.0 设备上的运行。

如需简要了解新平台功能,请参阅 Android Lollipop 亮点。

开始开发

如需开始构建 Android 5.0 应用,您必须先获取 Android SDK。然后使用 SDK 管理器下载 Android 5.0 SDK 平台和系统映像。

更新目标 API 级别

为了更好地针对搭载 Android 5.0 的设备优化应用,请将 targetSdkVersion 设置为 "21",在 Android 5.0 系统映像上安装应用,对其进行测试,然后发布包含此更改的更新版应用。

您可以使用 Android 5.0 API,同时通过在代码中添加条件来支持更低版本,这些条件会在执行您的 minSdkVersion 不支持的 API 之前检查系统 API 级别。如需详细了解如何保持向后兼容性,请参阅支持不同的平台版本。

如需详细了解 API 级别的工作原理,请参阅什么是 API 级别?

重要行为变更

如果您之前发布过 Android 应用,请注意,您的应用可能会受到 Android 5.0 中变更的影响。

如需了解完整信息,请参阅 Android 5.0 变更。

界面

Material Design 支持

Android 5.0 增加了对 Android 新 Material Design 样式的支持。您可以使用 Material Design 创建具有动态视觉效果且界面元素转换自然的应用。此支持服务包括:

  • Material 主题
  • 查看阴影
  • RecyclerView 微件
  • 可绘制动画和样式效果
  • Material Design 动画和 activity 过渡效果
  • 基于视图状态的视图属性动画
  • 可自定义的界面微件和应用栏,调色板由您掌控
  • 基于 XML 矢量图形的动画和非动画可绘制对象

如需详细了解如何向应用添加 Material Design 功能,请参阅 Material Design。

“最近使用的应用”屏幕中的并发文档和 activity

在之前的版本中,“最近使用的应用”屏幕只能为用户最近互动的每个应用显示一个任务。现在,您的应用可以根据需要打开更多任务,以便为文档提供更多并发 activity。此功能让用户能够从“最近使用的应用”屏幕在各个 activity 和文档之间快速切换,从而方便用户执行多任务,并在所有应用中提供一致的切换体验。 此类并发任务的示例可能包括网络浏览器应用中打开的标签页、效率提升应用中的文档、游戏中的并发比赛或即时通讯应用中的聊天。您的应用可以通过 ActivityManager.AppTask 类管理其任务。

如需插入逻辑中断,以便系统将您的 activity 视为新任务,请在使用 startActivity() 启动 activity 时使用 FLAG_ACTIVITY_NEW_DOCUMENT。您也可以通过在清单中将 <activity> 元素的 documentLaunchMode 属性设置为 "intoExisting" 或 "always" 来实现此行为。

为避免“最近用过”屏幕杂乱无章,您可以设置该屏幕中最多可显示的应用任务数。为此,请设置 <application> 属性 android:maxRecents。目前可指定的最大值为每位用户 50 个任务(低 RAM 设备为 25 个)。

“最近用过”屏幕中的任务可以设置为在重新启动后仍然保留。如需控制持久性行为,请使用 android:persistableMode 属性。您还可以通过调用 setTaskDescription() 方法,更改 activity 在“最近使用的应用”屏幕中的视觉属性,例如 activity 的颜色、标签和图标。

WebView 更新

Android 5.0 将 WebView 实现更新为 Chromium M37,从而增强了安全性和稳定性,并修复了 bug。在 Android 5.0 上运行的 WebView 的默认用户代理字符串已更新,其中包含版本号 37.0.0.0。

此版本引入了 PermissionRequest 类,该类允许您的应用通过 getUserMedia() 等 Web API 授予 WebView 权限,以访问受保护的资源(例如摄像头和麦克风)。您的应用必须具有这些资源的相应 Android 权限,才能向 WebView 授予权限。

借助新的 onShowFileChooser() 方法,您现在可以在 WebView 中使用输入表单字段,并启动文件选择器,以便从 Android 设备中选择图片和文件。

此外,此版本还支持 WebAudio、WebGL 和 WebRTC 开放标准。 如需详细了解此版本中包含的新功能,请参阅 WebView for Android。

屏幕截图和共享

借助 Android 5.0,您可以使用新的 android.media.projection API 为应用添加屏幕截图和屏幕共享功能。例如,如果您想在视频会议应用中启用屏幕共享,此功能就非常有用。

借助新的 createVirtualDisplay() 方法,您的应用可以将主屏幕(默认显示屏)的内容捕获到 Surface 对象中,然后通过网络发送该对象。该 API 仅允许捕获非安全屏幕内容,而不允许捕获系统音频。如需开始截屏,您的应用必须先使用通过 createScreenCaptureIntent() 方法获取的 Intent 启动截屏对话框,从而请求用户授予权限。

如需查看如何使用新 API 的示例,请参阅示例项目中的 MediaProjectionDemo 类。

通知

锁定屏幕通知

Android 5.0 中的锁屏界面能够显示通知。用户可以通过设置选择是否允许在安全锁定屏幕上显示敏感通知内容。

您的应用可以控制其通知在安全锁屏界面上显示时的详细程度。如需控制可见性级别,请调用 setVisibility() 并指定以下值之一:

当公开范围级别为 VISIBILITY_PRIVATE 时,您还可以提供通知内容的隐去版本,以隐藏个人详细信息。例如,短信应用可能会显示一条通知,其中显示“您有 3 条新短信”,但隐藏了短信内容和发件人。如需提供此备用通知,请先使用 Notification.Builder 创建替换通知。创建不公开通知对象时,通过 setPublicVersion() 方法将替换通知附加到该对象。

通知元数据

Android 5.0 使用与应用通知关联的元数据,以更智能的方式对通知进行排序。如需设置元数据,请在构建通知时调用 Notification.Builder 中的以下方法:

  • setCategory():告知系统在设备处于优先模式时如何处理应用通知(例如,通知是否代表来电、即时通讯或闹钟)。
  • setPriority():将通知标记为比普通通知更重要或更不重要。 如果通知还具有声音或振动,则优先级字段设置为 PRIORITY_MAX 或 PRIORITY_HIGH 的通知会显示在小型浮动窗口中。
  • addPerson():可让您添加一个或多个与通知相关的人员。 您的应用可以使用此功能向系统表明,系统应将来自指定人员的通知归为一组,或将来自这些人员的通知排在更重要的位置。

图形

支持 OpenGL ES 3.1

Android 5.0 添加了 Java 接口和对 OpenGL ES 3.1 的原生支持。OpenGL ES 3.1 提供的主要新功能包括:

  • 计算着色器
  • 单独的着色器对象
  • 间接绘制命令
  • 多重采样和模板纹理
  • 着色语言改进
  • 用于高级混合模式和调试的扩展
  • 与 OpenGL ES 2.0 和 3.0 的向后兼容性

Android 上的 OpenGL ES 3.1 Java 接口通过 GLES31 提供。使用 OpenGL ES 3.1 时,请务必在清单文件中使用 <uses-feature> 标记和 android:glEsVersion 属性声明它。例如:

<manifest>
    <uses-feature android:glEsVersion="0x00030001" />
    ...
</manifest>

如需详细了解如何使用 OpenGL ES(包括如何在运行时检查设备支持的 OpenGL ES 版本),请参阅 OpenGL ES API 指南。

Android 扩展包

除了 OpenGL ES 3.1 之外,此版本还提供了一个具有 Java 接口并原生支持高级图形功能的扩展包。Android 会将这些扩展程序视为单个软件包。(如果存在 ANDROID_extension_pack_es31a 扩展程序,您的应用可以假定该软件包中的所有扩展程序都存在,并使用单个 #extension 语句启用着色语言功能。)

该扩展包支持:

  • 着色器存储缓冲区、图片和原子操作所需的片段着色器支持(片段着色器支持在 OpenGL ES 3.1 中是可选的)。
  • 镶嵌和几何着色器
  • ASTC (LDR) 纹理压缩格式
  • 逐样本插值和着色
  • 帧缓冲区中每个颜色附件的不同混合模式

扩展包的 Java 接口随 GLES31Ext 一起提供。在应用清单中,您可以声明应用只能安装在支持扩展包的设备上。例如:

<manifest>
    <uses-feature android:name="android.hardware.opengles.aep"
        android:required="true" />
    ...
</manifest>

媒体

用于高级相机功能的 Camera API

Android 5.0 引入了新的 android.hardware.camera2 API,以便于进行精细的照片拍摄和图像处理。现在,您可以使用 getCameraIdList() 以编程方式访问系统可用的相机设备,并使用 openCamera() 连接到特定设备。如需开始拍摄图片,请创建一个 CameraCaptureSession 并指定 Surface 对象来发送拍摄的图片。CameraCaptureSession 可配置为拍摄单张照片或连拍多张照片。

如需在拍摄新图片时收到通知,请实现 CameraCaptureSession.CaptureCallback 监听器,并在拍摄请求中设置该监听器。现在,当系统完成图片拍摄请求后,您的 CameraCaptureSession.CaptureCallback 监听器会收到对 onCaptureCompleted() 的调用,从而为您提供 CaptureResult 中的图片拍摄元数据。

CameraCharacteristics 类可让您的应用检测设备上可用的相机功能。该对象的 INFO_SUPPORTED_HARDWARE_LEVEL 属性表示相机的功能级别。

如需了解如何使用更新后的 Camera API,请参阅此版本中的 Camera2Basic 和 Camera2Video 实现示例。

音频播放

此版本对 AudioTrack 进行了以下更改:

  • 您的应用现在可以提供浮点格式 (ENCODING_PCM_FLOAT) 的音频数据。这样可以实现更大的动态范围、更一致的精度和更大的动态余量。浮点运算在中间计算过程中尤其有用。 播放端点对音频数据使用整数格式,且位深度较低。 (在 Android 5.0 中,内部流水线的部分内容尚不支持浮点。)
  • 您的应用现在可以采用与 MediaCodec 提供的格式相同的格式,以 ByteBuffer 的形式提供音频数据。
  • WRITE_NON_BLOCKING 选项可以简化某些应用的缓冲和多线程处理。

媒体播放控制

使用新的通知和媒体 API,确保系统界面了解您的媒体播放情况,并可以提取和显示专辑封面。 现在,借助新的 MediaSession 和 MediaController 类,可以更轻松地在界面和服务中控制媒体播放。

新的 MediaSession 类取代了已废弃的 RemoteControlClient 类,并提供了一组用于处理传输控件和媒体按钮的回调方法。 如果您的应用提供媒体播放功能,并且在 Android TV 或 Wear 平台上运行,请使用 MediaSession 类通过相同的回调方法处理传输控件。

现在,您可以使用新的 MediaController 类构建自己的媒体控制器应用。此类提供了一种线程安全的方法,可用于从应用的界面进程监控和控制媒体播放。创建控制器时,请指定 MediaSession.Token 对象,以便您的应用可以与给定的 MediaSession 互动。通过使用 MediaController.TransportControls 方法,您可以发送 play()、stop()、skipToNext() 和 setRating() 等命令,以控制该会话中的媒体播放。借助控制器,您还可以注册 MediaController.Callback 对象,以监听会话中的元数据和状态更改。

此外,您还可以使用新的 Notification.MediaStyle 类创建富通知,以便通过媒体会话控制播放。

媒体浏览

Android 5.0 引入了通过新的 android.media.browse API 浏览其他应用的媒体内容库的功能。如需在应用中公开媒体内容,请扩展 MediaBrowserService 类。您的 MediaBrowserService 实现应提供对 MediaSession.Token 的访问权限,以便应用可以播放通过您的服务提供的媒体内容。

如需与媒体浏览器服务交互,请使用 MediaBrowser 类。在创建 MediaBrowser 实例时,为 MediaSession 指定组件名称。然后,您的应用可以使用该浏览器实例连接到关联的服务,并获取 MediaSession.Token 对象来播放通过该服务公开的内容。

存储

目录选择

Android 5.0 扩展了存储访问框架,让用户可以选择整个目录子树,从而使应用可以对其中包含的所有文档进行读写权限访问,而无需用户逐项确认。

如需选择目录子树,请构建并发送 OPEN_DOCUMENT_TREE intent。系统会显示支持子树选择的所有 DocumentsProvider 实例,让用户浏览和选择目录。返回的 URI 表示对所选子树的访问权限。然后,您可以将 buildChildDocumentsUriUsingTree() 和 buildDocumentUriUsingTree() 与 query() 结合使用,以探索子树。

借助新的 createDocument() 方法,您可以在子树下的任意位置创建新文档或目录。如需管理现有文档,请使用 renameDocument() 和 deleteDocument()。在发出这些调用之前,请先检查 COLUMN_FLAGS,以验证提供商是否支持这些调用。

如果您要实现 DocumentsProvider 并希望支持子树选择,请实现 isChildDocument() 并在 COLUMN_FLAGS 中添加 FLAG_SUPPORTS_IS_CHILD。

Android 5.0 还在共享存储空间中引入了新的软件包专属目录,您的应用可以在其中放置要包含在 MediaStore 中的媒体文件。新的 getExternalMediaDirs() 会返回所有共享存储设备上这些目录的路径。与 getExternalFilesDir() 类似,您的应用无需任何其他权限即可访问返回路径。平台会定期扫描这些目录中的新媒体,但您也可以使用 MediaScannerConnection 明确扫描新内容。

无线和连接

多个网络连接

Android 5.0 提供了新的多网络 API,可让您的应用动态扫描具有特定功能的可用网络,并与它们建立连接。如果您的应用需要专用网络(例如 SUPL、MMS 或运营商代扣网络),或者您希望使用特定类型的传输协议发送数据,此功能会非常有用。

如需从应用中动态选择并连接到网络,请按以下步骤操作:

  1. 创建 ConnectivityManager 网址。
  2. 使用 NetworkRequest.Builder 类创建 NetworkRequest 对象,并指定您的应用感兴趣的网络功能和传输类型。
  3. 如需扫描合适的网络,请调用 requestNetwork() 或 registerNetworkCallback(),并传入 NetworkRequest 对象和 ConnectivityManager.NetworkCallback 的实现。如果您想在检测到合适的网络后主动切换到该网络,请使用 requestNetwork() 方法;如果只想接收有关已扫描网络的通知而不主动切换,请改用 registerNetworkCallback() 方法。

当系统检测到合适的网络时,会连接到该网络并调用 onAvailable() 回调。您可以使用回调中的 Network 对象来获取有关网络的其他信息,或引导流量使用所选网络。

蓝牙低功耗

Android 4.3 引入了对低功耗蓝牙 (蓝牙 LE) 的平台支持,并提供中心角色。在 Android 5.0 中,Android 设备现在可以充当蓝牙 LE 外围设备。应用可以使用此功能向附近的设备表明自己的存在。例如,您可以构建应用,使设备能够充当计步器或健康监测器,并与其他蓝牙 LE 设备进行数据通信。

借助新的 android.bluetooth.le API,您的应用可以广播通告、扫描响应,并与附近的低功耗蓝牙设备建立连接。如需使用新的通告和扫描功能,请在清单中添加 BLUETOOTH_ADMIN 权限。当用户从 Play 商店更新或下载您的应用时,系统会要求他们向您的应用授予以下权限:“蓝牙连接信息:允许应用控制蓝牙,包括向附近的蓝牙设备广播或获取有关附近蓝牙设备的信息。”

如需开始进行蓝牙 LE 通告,以便其他设备可以发现您的应用,请调用 startAdvertising() 并传入 AdvertiseCallback 类的实现。回调对象会收到有关通告操作成功或失败的报告。

Android 5.0 引入了 ScanFilter 类,以便您的应用可以仅扫描其感兴趣的特定类型的设备。如需开始扫描低功耗蓝牙设备,请调用 startScan() 并传入过滤条件列表。在方法调用中,您还必须提供 ScanCallback 的实现,以便在发现蓝牙 LE 通告时进行报告。

NFC 增强功能

Android 5.0 增加了以下增强功能,以便更广泛、更灵活地使用 NFC:

  • Android Beam 现已在分享菜单中提供。
  • 您的应用可以通过调用 invokeBeam(),在用户设备上调用 Android Beam 来共享数据。这样,用户就无需手动将设备与另一部支持 NFC 的设备触碰来完成数据传输。
  • 您可以使用新的 createTextRecord() 方法创建包含 UTF-8 文本数据的 NDEF 记录。
  • 如果您正在开发支付应用,现在可以通过调用 registerAidsForService() 动态注册 NFC 应用 ID (AID)。您还可以使用 setPreferredService() 设置在特定 activity 处于前台时应使用的首选卡模拟服务。

Volta 项目

除了新功能之外,Android 5.0 还着重提升了电池续航时间。使用新的 API 和工具来了解和优化应用的功耗。

安排作业

Android 5.0 提供了一个新的 JobScheduler API,可让您通过定义作业来优化电池续航时间,以便系统在稍后时间或在指定条件下(例如设备充电时)异步运行。作业调度在以下情况下非常有用:

  • 应用具有可延迟执行的非面向用户的工作。
  • 应用有一些您希望在设备接通电源时执行的工作。
  • 应用有一项需要网络访问权限或 Wi-Fi 连接的任务。
  • 该应用有许多任务,您希望定期批量运行这些任务。

工作单元由 JobInfo 对象封装。此对象用于指定调度条件。

使用 JobInfo.Builder 类配置计划任务的运行方式。您可以安排任务在特定条件下运行,例如:

  • 在设备充电时启动
  • 在设备连接到不按流量计费的网络时启动
  • 在设备处于空闲状态时启动
  • 在特定截止日期之前完成或以最短延迟完成

例如,您可以添加如下代码,以便在不按流量计费的网络上运行任务:

Kotlin

val uploadTask: JobInfo = JobInfo.Builder(
        jobId,
        serviceComponent /* JobService component */
).run {
    setRequiredNetworkType(JobInfo.NETWORK_TYPE_UNMETERED)
    build()
}
val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(uploadTask)

Java

JobInfo uploadTask = new JobInfo.Builder(jobId,
                                         serviceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NETWORK_TYPE_UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);

如果设备具有稳定的电源(即已接通电源超过 2 分钟,且电池处于健康水平),系统将运行任何已准备好运行的计划作业,即使作业的截止时间尚未到期也是如此。

如需查看如何使用 JobScheduler API 的示例,请参阅此版本中的 JobSchedulerSample 实现示例。

用于电池用量的开发者工具

新的 dumpsys batterystats 命令会生成关于设备电池用量的有趣统计数据,这些数据按唯一身份用户 ID (UID) 进行整理。统计信息包括:

  • 电池相关事件的历史记录
  • 设备的全局统计信息
  • 每个 UID 和系统组件的大致用电量
  • 每个应用每个数据包的移动网络毫秒数
  • 系统 UID 汇总统计信息
  • 应用 UID 汇总统计信息

使用 --help 选项可了解用于定制输出的各种选项。例如,如需输出自设备上次充电以来指定应用包的电池用量统计信息,请运行以下命令:

$ adb shell dumpsys batterystats --charged <package-name>

您可以对 dumpsys 命令的输出使用 Battery Historian 工具,以生成日志中与电源相关的事件的 HTML 可视化。这些信息可让您更轻松地了解和诊断任何与电池相关的问题。

Android 在工作场所和教育领域的应用

托管配置

Android 5.0 提供了在企业环境中运行应用的新功能。如果用户已有个人账号,设备管理员可以启动受管理配置流程,向设备添加一个共存但独立的受管理个人资料。与受管理个人资料关联的应用会与非受管理应用一起显示在用户的启动器、最近用过界面和通知中。

如需启动受管理配置流程,请在 Intent 中发送 ACTION_PROVISION_MANAGED_PROFILE。如果调用成功,系统会触发 onProfileProvisioningComplete() 回调。 然后,您可以调用 setProfileEnabled() 来启用此受管理的个人资料。

默认情况下,受管资料中仅启用了一小部分应用。 您可以通过调用 enableSystemApp() 在受管理的个人资料中安装其他应用。

如果您正在开发启动器应用,则可以使用新的 LauncherApps 类来获取当前用户和任何关联的受管理个人资料的可启动 activity 列表。启动器可以通过在图标可绘制对象中附加工作标记,使受管理的应用在视觉上更加醒目。如需检索带标记的图标,请调用 getUserBadgedIcon()。

如需了解如何使用新功能,请参阅此版本中的 BasicManagedProfile 实现示例。

设备所有者

Android 5.0 引入了部署设备所有者应用的功能。设备所有者是一种特殊类型的设备管理员,具有在设备上创建和移除次要用户以及配置全局设置的额外功能。您的设备所有者应用可以使用 DevicePolicyManager 类中的方法来精细控制受管设备上的配置、安全性和应用。 一台设备一次只能有一个活跃的设备所有者。

如需部署和激活设备所有者,您必须在设备处于未配置状态时,执行从编程应用到设备的数据传输。此数据传输会发送与受管理配置中所述的配置 intent 相同的信息。

固定屏幕

Android 5.0 引入了新的固定屏幕 API,可让您暂时限制用户离开您的任务或被通知中断。例如,如果您正在开发一款教育应用,以支持 Android 上的高风险评估要求,或者开发一款单一用途或自助服务终端应用,则可以使用此功能。应用激活固定屏幕后,用户将无法查看通知、访问其他应用或返回主屏幕,直到应用退出该模式。

您可以通过以下两种方式启用固定屏幕功能:

  • 手动:用户可以在设置 > 安全 > 固定屏幕中启用固定屏幕功能,并通过轻触“最近使用的应用”屏幕中的绿色固定图标来选择要固定的任务。
  • 以编程方式:如需以编程方式激活固定屏幕,请从您的应用中调用 startLockTask()。如果发出请求的应用不是设备所有者,系统会提示用户进行确认。设备所有者应用可以调用 setLockTaskPackages() 方法,以便在无需用户确认的情况下启用应用固定功能。

任务锁定功能处于启用状态时,会出现以下情况:

  • 状态栏为空,用户通知和状态信息处于隐藏状态。
  • “主屏幕”和“最近使用的应用”按钮处于隐藏状态。
  • 其他应用无法启动新 activity。
  • 当前应用可以启动新 activity,只要这样做不会创建新任务。
  • 当设备所有者调用固定屏幕功能时,用户会一直锁定在您的应用中,直到应用调用 stopLockTask()。
  • 如果固定屏幕功能是由非设备所有者的其他应用或由用户直接激活,用户可以同时按住“返回”和“最近”按钮退出。

打印框架

将 PDF 渲染为位图

现在,您可以使用新的 PdfRenderer 类将 PDF 文档页面呈现为位图图像以进行打印。您必须指定一个可搜索(即内容可随机访问)的 ParcelFileDescriptor,系统会在其中写入可打印内容。您的应用可以使用 openPage() 获取要渲染的页面,然后调用 render() 将打开的 PdfRenderer.Page 转换为位图。如果您只想将文档的一部分转换为位图图片(例如,实现平铺渲染以放大文档),还可以设置其他参数。

如需查看如何使用新 API 的示例,请参阅 PdfRendererBasic 示例。

系统

应用使用情况统计信息

现在,您可以使用新的 android.app.usage API 访问 Android 设备上的应用使用记录。此 API 提供的使用情况信息比已废弃的 getRecentTasks() 方法更详细。 如需使用此 API,您必须先在清单中声明 "android.permission.PACKAGE_USAGE_STATS" 权限。 用户还必须通过设置 > 安全 > 具有使用情况访问权限的应用为该应用启用访问权限。

系统会按应用收集使用情况数据,并按每日、每周、每月和每年的时间间隔汇总数据。系统保留这些数据的最长期限如下:

  • 每日数据:7 天
  • 每周数据:4 周
  • 月度数据:6 个月
  • 年度数据:2 年

对于每个应用,系统会记录以下数据:

  • 上次使用应用的时间
  • 应用在相应时间间隔(按天、周、月或年)内在前台运行的总时长
  • 用于捕获组件(由软件包和 activity 名称标识)在一天中何时移至前台或后台的时间戳
  • 捕获设备配置更改(例如设备方向因旋转而更改)时的时间戳

测试和无障碍功能

测试和无障碍功能改进

Android 5.0 增加了以下测试和无障碍功能支持:

  • 新的 getWindowAnimationFrameStats() 和 getWindowContentFrameStats() 方法可捕获窗口动画和内容的帧统计信息。借助这些方法,您可以编写插桩测试,以评估应用是否以足够高的刷新频率渲染帧,从而提供流畅的用户体验。
  • 借助新的 executeShellCommand() 方法,您可以通过插桩测试执行 shell 命令。命令执行类似于从连接到设备的宿主机运行 adb shell,让您可以使用基于 shell 的工具,例如 dumpsys、am、content 和 pm。
  • 使用无障碍功能 API 的无障碍服务和测试工具(例如 UiAutomator)现在可以检索有关屏幕上视力正常的用户可以与之互动的窗口属性的详细信息。如需检索 AccessibilityWindowInfo 对象列表,请调用新的 getWindows() 方法。
  • 借助新的 AccessibilityNodeInfo.AccessibilityAction 类,您可以定义要对 AccessibilityNodeInfo 执行的标准或自定义操作。 新的 AccessibilityNodeInfo.AccessibilityAction 类取代了之前在 AccessibilityNodeInfo 中找到的操作相关 API。
  • Android 5.0 提供了对应用中文本转语音合成的更精细控制。借助新的 Voice 类,您的应用可以使用与特定语言区域、质量和延迟评级以及文本转语音引擎特定参数相关联的语音配置文件。

IME

更轻松地切换输入语言

从 Android 5.0 开始,用户可以在平台支持的所有输入法 (IME) 之间切换。执行指定的切换操作(通常是轻触软键盘上的地球图标)可循环切换所有此类 IME。这种行为变化是通过 shouldOfferSwitchingToNextInputMethod() 方法实现的。

此外,框架现在还会检查下一个 IME 是否包含切换机制(从而检查该 IME 是否支持切换到其后的 IME)。具有切换机制的 IME 不会循环到没有切换机制的 IME。此行为更改由 switchToNextInputMethod() 方法实现。

如需查看如何使用更新后的 IME 切换 API 的示例,请参阅此版本中更新后的软键盘实现示例。如需详细了解如何实现 IME 之间的切换,请参阅创建输入法。

清单声明

可声明的必需功能

<uses-feature> 元素现在支持以下值,因此您可以确保应用仅安装在提供应用所需功能的设备上。

用户权限

<uses-permission> 元素现在支持以下权限,用于声明应用访问某些 API 所需的权限。

  • BIND_DREAM_SERVICE:当目标 API 级别为 21 及更高级别时,Daydream 服务需要此权限,以确保只有系统可以绑定到该服务。