API 级别:17
Android 4.2 (JELLY_BEAN_MR1) 是 Jelly Bean 版本的更新,为用户和应用开发者提供了新功能。本文档简要介绍了对开发者而言最重要且最实用的新 API。
作为应用开发者,您应尽快从 SDK 管理器下载 Android 4.2 系统映像和 SDK 平台。如果您没有搭载 Android 4.2 的设备来测试应用,请使用 Android 4.2 系统映像在 Android 模拟器上测试应用。然后,针对 Android 4.2 平台构建应用,开始使用最新的 API。
为了更好地针对搭载 Android 4.2 的设备优化应用,您应将 targetSdkVersion 设置为 "17",将其安装在 Android 4.2 系统映像上,进行测试,然后发布包含此更改的更新。
您可以在 Android 4.2 中使用 API,同时通过在代码中添加条件来支持旧版本,这些条件会在执行 minSdkVersion 不支持的 API 之前检查系统 API 级别。如需详细了解如何保持向后兼容性,请参阅创建向后兼容界面。
如需详细了解 API 级别的工作原理,请参阅什么是 API 级别?
重要行为变更
如果您之前发布过 Android 应用,请注意以下可能影响应用行为的变更:
- 默认情况下,系统不再导出 content provider。也就是说,
android:exported属性的默认值现在为"false"。如果其他应用必须能够访问您的 content provider,您现在必须明确设置android:exported="true"。只有当您将
android:targetSdkVersion或android:minSdkVersion设置为 17 或更高版本时,此变更才会生效。否则,即使在 Android 4.2 及更高版本上运行,默认值仍为"true"。 - 与之前的 Android 版本相比,如果您的应用请求
ACCESS_COARSE_LOCATION权限,但不请求ACCESS_FINE_LOCATION权限,则用户位置信息结果可能不太准确。当您的应用请求获取粗略位置信息(而非精确位置信息)权限时,为了满足用户的隐私期望,系统不会提供比城市街区更精确的用户位置信息估算值。
Settings.System定义的部分设备设置现在处于只读状态。如果您的应用尝试将更改写入Settings.System中已移至Settings.Global的设置,则在 Android 4.2 及更高版本上运行时,写入操作将静默失败。即使您的
android:targetSdkVersion和android:minSdkVersion值低于 17,当应用在 Android 4.2 及更高版本上运行时,也无法修改已移至Settings.Global的设置。- 如果您的应用使用
WebView,Android 4.2 会添加一个额外的安全层,以便您更安全地将 JavaScript 绑定到 Android 代码。如果您将targetSdkVersion设置为 17 或更高,则现在必须向您希望 JavaScript 能够使用的任何方法添加@JavascriptInterface注解(该方法也必须是公开的)。如果您不提供该注解,则在 Android 4.2 或更高版本上运行时,WebView中的网页将无法访问该方法。如果您将targetSdkVersion设置为 16 或更低,则不需要该注解,但我们建议您更新目标版本并添加该注解,以提高安全性。
Daydream
Daydream 是 Android 设备的一种全新互动屏保模式。当设备插入基座或在插入充电器时处于闲置状态(而不是关闭屏幕)时,它会自动激活。Daydream 一次显示一个屏保,这可能是一个纯视觉、被动的显示,在轻触时会关闭,也可能是交互式的,并响应全套输入事件。屏保在应用的进程中运行,并且可以完全访问 Android UI 工具包(包括视图、布局和动画),因此它们比动态壁纸或应用微件更灵活、更强大。
您可以通过实现 DreamService 的子类来为 Daydream 创建互动屏保。DreamService API 的设计与 Activity 类似。如需为您的互动屏保指定界面,请在您拥有窗口后的任何时间点(例如从 onAttachedToWindow() 回调中),将布局资源 ID 或 View 传递给 setContentView()。
DreamService 类在基本 Service API 之上提供了其他重要的生命周期回调方法,例如 onDreamingStarted()、onDreamingStopped() 和 onDetachedFromWindow()。您无法从应用中启动 DreamService,它由系统自动启动。
如果您的互动屏保是交互式的,您可以从互动屏保启动 activity,将用户引导至应用的完整界面,以便用户查看更多详细信息或进行控制。您可以使用 finish() 结束屏保,以便用户可以看到新的 Activity。
如需让系统能够使用您的 Daydream,请在清单文件中使用 <service> 元素声明您的 DreamService。然后,您必须添加一个具有 "android.service.dreams.DreamService" 操作的 intent 过滤器。例如:
<service android:name=".MyDream" android:exported="true" android:icon="@drawable/dream_icon" android:label="@string/dream_label" > <intent-filter> <action android:name="android.service.dreams.DreamService" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </service>
DreamService 中还有一些其他有用的方法需要注意:
setInteractive(boolean)控制屏保是接收输入事件,还是在用户输入时立即退出。如果屏保是交互式的,用户可以使用返回或主屏幕按钮退出屏保,您也可以调用finish()来停止屏保。- 如果您希望实现完全沉浸式显示,可以调用
setFullscreen()来隐藏状态栏。 - 在 Daydream 启动之前,显示屏会变暗,以向用户发出闲置超时即将到来的信号。调用
setScreenBright(true)可让您将显示屏设置为正常亮度。
如需了解详情,请参阅 DreamService 文档。
辅助显示屏
Android 现在允许您的应用在通过有线连接或 Wi-Fi 连接到用户设备的其他屏幕上显示独特的内容。
如需为辅助显示屏创建独特的内容,请扩展 Presentation 类并实现 onCreate() 回调。在 onCreate() 中,通过调用 setContentView() 为辅助显示屏指定界面。作为 Dialog 类的扩展,Presentation 类提供了一个区域,供应用在副显示屏上显示独特的界面。
如需检测可用于显示 Presentation 的辅助显示屏,请使用 DisplayManager 或 MediaRouter API。虽然 DisplayManager API 允许您枚举可能同时连接的多个显示屏,但您通常应改用 MediaRouter 来快速访问系统的默认显示屏以进行演示。
如需获取演示文稿的默认屏幕,请调用 MediaRouter.getSelectedRoute() 并向其传递 ROUTE_TYPE_LIVE_VIDEO。这将返回一个 MediaRouter.RouteInfo 对象,该对象描述系统当前为视频演示选择的路线。如果 MediaRouter.RouteInfo 不为 null,请调用 getPresentationDisplay() 以获取表示已连接显示屏的 Display。
然后,您可以通过将 Display 对象传递给 Presentation 类的构造函数来显示演示文稿。您的演示文稿现在将显示在辅助显示屏上。
如需在运行时检测何时连接了新显示屏,请创建一个 MediaRouter.SimpleCallback 实例,并在其中实现 onRoutePresentationDisplayChanged() 回调方法,系统会在连接新的演示显示屏时调用该方法。然后,将 连同 ROUTE_TYPE_LIVE_VIDEO 路由类型一起传递给 MediaRouter.addCallback(),以注册该 MediaRouter.SimpleCallback。当您收到对 onRoutePresentationDisplayChanged() 的调用时,只需调用 MediaRouter.getSelectedRoute() 即可,如上所述。
如需进一步优化 Presentation 中辅助屏幕的界面,您可以在已应用于应用或 activity 的 <style> 中指定 android:presentationTheme 属性,从而应用不同的主题。
请注意,连接到用户设备的屏幕通常具有更大的屏幕尺寸,并且可能具有不同的屏幕密度。由于屏幕特性可能有所不同,因此您应提供专门针对此类较大显示屏进行优化的资源。如果您需要从 Presentation 请求其他资源,请调用 getContext().getResources() 以获取与显示屏对应的 Resources 对象。这样,系统便会从您的应用中提供最适合辅助显示屏的屏幕尺寸和密度的资源。
如需了解详情和一些代码示例,请参阅 Presentation 类文档。
锁屏微件
Android 现在允许用户将应用 widget 添加到锁定的屏幕。如需使应用 widget 可在锁定的屏幕上使用,请将 android:widgetCategory 属性添加到指定 AppWidgetProviderInfo 的 XML 文件中。此属性支持两个值:home_screen 和 keyguard。默认情况下,该属性设置为 home_screen,以便用户可以将您的应用 widget 添加到主屏幕。如果您希望应用微件也可在锁定的屏幕上使用,请添加 keyguard 值:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
...
android:widgetCategory="keyguard|home_screen">
</appwidget-provider>您还应使用 android:initialKeyguardLayout 属性为锁屏状态下的应用 widget 指定初始布局。此方法的工作方式与 android:initialLayout 相同,因为它提供了一个可以立即显示的布局,直到应用 widget 初始化并能够更新布局。
如需详细了解如何为锁定的屏幕构建应用 widget,包括如何在锁定的屏幕上正确调整应用 widget 的大小,请参阅应用 widget 指南。
多用户
Android 现在允许在平板电脑等可共享设备上设置多个用户空间。设备上的每个用户都有一组专属的账号、应用、系统设置、文件以及任何其他与用户相关联的数据。
作为应用开发者,您无需执行任何其他操作,即可让应用在单个设备上与多用户正常搭配使用。无论设备上可能存在多少用户,您的应用为特定用户保存的数据都会与您的应用为其他用户保存的数据分开。系统会跟踪哪些用户数据属于运行应用的那个用户进程,并仅向您的应用提供对该用户数据的访问权限,而不允许访问其他用户的数据。
在多用户环境中保存数据
每当您的应用保存用户偏好设置、创建数据库或将文件写入用户的内部或外部存储空间时,只有在以该用户身份运行时才能访问这些数据。
为确保您的应用在多用户环境中正常运行,请勿使用硬编码路径引用内部应用目录或外部存储位置,而应始终使用适当的 API:
- 如需访问内部存储空间,请使用
getFilesDir()、getCacheDir()或openFileOutput()。 - 如需访问外部存储空间,请使用
getExternalFilesDir()或getExternalStoragePublicDirectory()。
无论您使用这些 API 中的哪一个来保存给定用户的数据,在以其他用户身份运行时,都无法访问这些数据。从应用的角度来看,每个用户都在完全独立的设备上运行。
在多用户环境中识别用户
如果您的应用想要识别唯一身份用户(例如为了收集分析数据或创建其他账号关联),您应遵循识别唯一安装的推荐做法。通过在应用首次启动时创建新的 UUID,您可以确保获得一个唯一 ID 来跟踪每个用户,无论有多少用户在单个设备上安装您的应用。或者,您也可以保存从服务器提取的本地令牌,或使用 Google Cloud Messaging 提供的注册 ID。
请注意,如果您的应用请求其中一个硬件设备标识符(例如 WiFi MAC 地址或 SERIAL 号码),它们将为每个用户提供相同的值,因为这些标识符与硬件(而非用户)相关联。更不用说这些标识符带来的其他问题,如识别应用安装博文中所述。
新全局设置
系统设置已更新,通过添加 Settings.Global 来支持多用户。此设置集合与 Settings.Secure 设置类似,因为它们是只读的,但会全局应用于设备上的所有用户空间。
一些现有设置已从 Settings.System 或 Settings.Secure 移至此处。如果您的应用目前正在更改之前在 Settings.System 中定义的设置(例如 AIRPLANE_MODE_ON),那么您应该预料到,如果这些设置已移至 Settings.Global,则在搭载 Android 4.2 或更高版本的设备上,这样做将不再有效。您仍可以读取 Settings.Global 中的设置,但由于系统不再认为这些设置可供应用安全更改,因此尝试更改这些设置会失败,并且在 Android 4.2 或更高版本上运行应用时,系统会向系统日志写入警告。
RTL 布局支持
Android 现在提供了多个 API,可让您构建能够正常转换布局方向的界面,以支持使用从右到左 (RTL) 界面和阅读方向的语言(例如阿拉伯语和希伯来语)。
如需开始在应用中支持 RTL 布局,请在清单文件中将 android:supportsRtl 属性添加到 <application> 元素,并将其设置为 "true"。启用此属性后,系统会启用各种 RTL API,以便以 RTL 布局显示您的应用。例如,操作栏将在右侧显示图标和标题,在左侧显示操作按钮,并且您使用框架提供的 View 类创建的所有布局也将反转。
如果您需要进一步优化应用在 RTL 布局中的显示效果,可以从以下两个基本层面进行优化:
- 将面向左侧和右侧的布局属性转换为面向开始和结束的布局属性。
例如,使用
android:layout_marginStart代替android:layout_marginLeft,使用android:layout_marginEnd代替android:layout_marginRight。RelativeLayout类还提供了相应的布局属性来替换左侧/右侧位置,例如android:layout_alignParentStart替换android:layout_alignParentLeft,android:layout_toStartOf替换android:layout_toLeftOf。 - 或者,为了针对 RTL 布局提供全面优化,您可以使用
ldrtl资源限定符(ldrtl代表 layout-direction-right-to-left)提供完全独立的布局文件。例如,您可以将默认布局文件保存在res/layout/中,并将经过 RTL 优化的布局保存在res/layout-ldrtl/中。ldrtl限定符非常适合可绘制资源,以便您提供方向与阅读方向一致的图形。
整个框架中还提供了各种其他 API 来支持 RTL 布局,例如 View 类中的 API,以便您为自定义视图实现适当的行为;以及 Configuration 中的 API,用于查询当前布局方向。
注意:如果您使用的是 SQlite,并且表或列名称为“仅数字”,请注意:如果您的设备已设置为阿拉伯语语言区域,则使用 String.format(String, Object...) 可能会导致错误,因为数字已转换为其阿拉伯语等效项。您必须使用 String.format(Locale,String,Object...),以确保数字保留为 ASCII。此外,请使用 String.format("%d", int)(而非 String.valueOf(int))来设置数字格式。
嵌套 Fragment
现在,您可以在 fragment 内嵌入 fragment。这在各种情况下都非常有用,例如,您希望将动态且可重复使用的界面组件放入本身也是动态且可重复使用的界面组件中。例如,如果您使用 ViewPager 创建可左右滑动并占用大部分屏幕空间的 fragment,现在可以将 fragment 插入到每个 fragment 页面中。
如需嵌套 fragment,只需对要添加 fragment 的 Fragment 调用 getChildFragmentManager() 即可。这会返回一个 FragmentManager,您可以像通常从顶级 activity 中所做的那样,使用它来创建 fragment 事务。例如,以下代码展示了如何从现有 Fragment 类中添加 fragment:
Kotlin
val videoFragment = VideoPlayerFragment() childFragmentManager.beginTransaction().apply { add(R.id.video_fragment, videoFragment) commit() }
Java
Fragment videoFragment = new VideoPlayerFragment(); FragmentTransaction transaction = getChildFragmentManager().beginTransaction(); transaction.add(R.id.video_fragment, videoFragment).commit();
在嵌套 fragment 中,您可以通过调用 getParentFragment() 获取对父 fragment 的引用。
Android 支持库现在也支持嵌套 fragment,因此您可以在 Android 1.6 及更高版本上实现嵌套 fragment 设计。
注意:如果布局包含 <fragment>,则无法将该布局扩充到 fragment 中。仅当以动态方式添加到 fragment 时,系统才支持嵌套 fragment。
Renderscript
Renderscript 计算功能已通过以下功能得到增强:
- 脚本内建函数
您可以使用 RenderScript 的内置脚本内建函数,这些函数可为您实现常见操作,例如:
BlendsBlurColor matrix3x3 convolve5x5 convolvePer-channel lookup tableConverting an Android YUV buffer to RGB
如需使用脚本内建函数,请调用每个内建函数的静态
create()方法来创建脚本实例。然后,您调用每个脚本内建函数的可用set()方法,以设置任何必要的输入和选项。最后,调用forEach()方法来执行脚本。- 脚本组
-
ScriptGroup允许您将相关的 RenderScript 脚本链接在一起,并通过一次调用执行这些脚本。使用
ScriptGroup.Builder通过调用addKernel()将所有脚本添加到该组。添加完所有脚本后,通过调用addConnection()创建脚本之间的连接。 添加完连接后,调用create()以创建脚本组。在执行脚本组之前,请指定输入Allocation和要使用setInput(Script.KernelID, Allocation)方法运行的初始脚本,并提供要将结果写入到的输出Allocation以及要使用setOutput()运行的最终脚本。最后,调用execute()以运行脚本组。 - Filterscript
-
Filterscript 对现有 Renderscript API 定义了限制,使生成的代码能够在更多种类的处理器(CPU、GPU 和 DSP)上运行。如需创建 Filterscript 文件,请创建
.fs文件(而非.rs文件),并指定#pragma rs_fp_relaxed以告知 Renderscript 运行时您的脚本不需要严格的 IEEE 754-2008 浮点精度。 此精度允许对非规范化数和向零舍入进行刷新。此外,您的 Filterscript 脚本不得使用 32 位内置类型,并且必须使用__attribute__((kernel))属性指定自定义根函数,因为 Filterscript 不支持root()函数的默认签名定义的指针。
注意:虽然平台中提供了 Filterscript 支持,但开发者支持将在 SDK 工具版本 21.0.1 中提供。
如需详细了解 Android 4.2 中的所有 API 变更,请参阅 API 差异报告。