Android 11 更新内容(开发必读)

功能和 API 概览

Android 11 面向开发者引入了一些出色的新功能和 API。以下几部分内容可帮助您了解适用于您的应用的功能并开始使用相关 API。

有关新增、修改和移除的 API 的详细列表，请参阅 API 差异报告。如需详细了解新的 API，请访问 Android API 参考文档 — 新 API 会突出显示以方便查看。此外，如需了解平台变更可能会在哪些方面影响您的应用，请务必查看会影响以 Android R 为目标平台的应用和所有应用的 Android 11 行为变更，以及隐私权变更。

新体验

屏幕

更好地支持瀑布屏

Android 11 提供了一些 API 以支持瀑布屏，这是一种无边框的全面屏。这种显示屏被视为刘海屏的变体。现有的 DisplayCutout.getSafeInset…() 方法现在会返回能够避开瀑布区域以及刘海的安全边衬区。如需在瀑布区域中呈现您的应用内容，请执行以下操作：

• 调用 DisplayCutout.getWaterfallInsets() 以获取瀑布边衬区的精确尺寸。

• 将窗口布局属性 layoutInDisplayCutoutMode 设为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS，以允许窗口延伸到屏幕各个边缘上的刘海和瀑布区域。您必须确保刘海或瀑布区域中没有重要的内容。

注意：如果您未将上述窗口布局属性设为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS，Android 会在黑边模式下显示窗口，从而避开缺口和瀑布区域。

合页角度传感器和可折叠设备

使用 Android 11，可以通过以下方法使运行在采用合页式屏幕配置的设备上的应用能够确定合页角度：提供具有 TYPE_HINGE_ANGLE 的新传感器，以及新的 SensorEvent，后者可以监控合页角度，并提供设备的两部分之间的角度测量值。您可以使用这些原始测量值在用户操作设备时执行精细的动画显示。

尽管对于某些类型的应用（例如启动器和壁纸）而言，知道确切的合页角度会很有用，但大多数应用都应该使用 Jetpack 窗口管理器库，通过调用 DeviceState.getPosture() 检索设备状态。

或者，您的应用也可以调用 registerDeviceStateChangeCallback()，以在 DeviceState 更改时收到通知，并在状态发生变化时做出响应。

由于目前市场上已经有且未来还会出现更多不同的窗口和设备配置，因此对设备状态做出响应更加安全可靠。

会话

Android 11 对会话的处理方式进行了多项改进。会话是满足以下条件的通信：

• 具有实时性。
• 可为双向或多向通信，但不能是单向的性质。
• 在两人或更多人（不能是聊天机器人）之间进行。

现在，这些会话显示于各自的区域中，这些会话的通知会突出显示并具有额外的功能：

• 如果用户长按会话通知，系统会为用户提供多个选项：
  • 将会话提升为气泡（如果应用支持气泡）。
  • 为此会话创建快捷方式并将其添加到主屏幕。
  • 将此会话的通知设为静音或暂停通知。
  • 将此会话标记为非常重要。
• 通知的设计采用新版本的 MessagingStyle，突出了用于代表用户的头像，同时还显示了进行会话的应用的图标。

要确定某个会话以便对其进行这种特殊处理，应用需要向该会话发布快捷方式，这可以通过调用现有的 ShortcutManager 方法 setDynamicShortcuts() 或 addDynamicShortcuts() 来完成。此快捷方式必须长期存在并附有个人数据，用于标识会话中的对方参与者。我们还建议您为快捷方式设置 LocusId，并使用该 LocusId 注释应用内 Activity 和 Fragment。这样做有助于系统根据应用的使用情况对对话进行准确排名。

如果某个对话已不存在，应用可以使用 ShortcutManager.removeLongLivedShortcuts() 来删除相应快捷方式；这样做会让系统删除与该对话关联的所有数据。

当应用发送与会话相关的通知时，您必须使用 MessagingStyle 并包含会话快捷方式的链接。这样做可让系统为您的通知提供特殊的对话处理。

根据用户行为，系统可能会将某些对话指定为特别重要并进行缓存，让它们看起来更加显眼。您的应用不能影响对话是否会得到这种优先处理，但您可以通过调用新方法 ShortcutManager.getShortcuts() 并传递 FLAG_MATCH_CACHED 来找出当前缓存了哪些对话。

改进了会话

Android 11 对会话的处理方式进行了多项改进。会话是两人或更多人之间的实时双向通信。这些会话具有特殊的重要性，并且用户在如何与其进行交互方面有多个新的选项可以选择。

如需详细了解会话以及您的应用如何支持会话，请参阅会话。

聊天气泡

借助气泡，用户可以从设备上的任何位置轻松进行多任务处理。气泡的设计目的是成为 SYSTEM_ALERT_WINDOW 的替代方案。

注意：“气泡”功能内置在开发者预览版中，仅供开发者使用，该功能不应该用于生产。默认情况下，气泡处于禁用状态。开发者可在开发者选项设置中启用该功能。

[图片上传失败...(image-c66076-1590046907721)]

气泡内置于通知系统中。它们悬浮在其他应用内容之上，并会跟随用户移动到任何位置。气泡可以展开以显示应用功能和信息，并可在不使用时收起。

当设备处于锁定状态或“显示屏始终开启”功能启用时，气泡的显示方式和常规通知相同。

气泡是一种可以选择停用的功能。在应用显示第一个气泡时，系统会弹出权限对话框，提供两个选项：

• 屏蔽来自您应用的所有气泡 - 系统不会屏蔽通知，但永远不会以气泡形式显示通知
• 允许来自您应用的所有气泡 - 通过 BubbleMetaData 发送的所有通知都会以气泡形式显示

Bubble API

气泡通过 Notification API 创建，因此您可以正常发送通知。如果您想让通知以气泡形式显示，则需要附加一些额外数据。

气泡的展开视图从您选择的 Activity 中创建，因此该 Activity 需要经过配置才能以气泡形式妥善显示。此 Activity 必须是大小可调的嵌入式 Activity，并且始终在文档界面模式中启动。如果这些要求中的任何一项无法得到满足，该 Activity 都将以通知形式显示。

以下代码演示如何实现简单的气泡：

如果您的应用显示多个相同类型的气泡（例如与不同联系人的多个聊天对话），则该 Activity 必须能够启动多个实例。将 documentLaunchMode 设置为“always”。

如要发送气泡，请按以下步骤操作：

• 按照一般步骤创建通知。
• 调用 Notification.BubbleMetadata.Builder 以创建 BubbleMetadata 对象。
• 使用 setBubbleMetadata 将元数据添加到通知。

// Create bubble intent
Intent target = new Intent(mContext, BubbleActivity.class);
PendingIntent bubbleIntent =
    PendingIntent.getActivity(mContext, 0, target, 0 /* flags */);

// Create bubble metadata
Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder()
        .setDesiredHeight(600)
        .setIcon(Icon.createWithResource(context, R.drawable.icon))
        .setIntent(bubbleIntent)
        .build();

// Create notification
Person chatBot = new Person.Builder()
        .setBot(true)
        .setName("BubbleBot")
        .setImportant(true)
        .build();

Notification.Builder builder =
    new Notification.Builder(mContext, CHANNEL_ID)
        .setContentIntent(contentIntent)
        .setSmallIcon(smallIcon)
        .setBubbleMetadata(bubbleData)
        .addPerson(chatBot);

注意：首次发送显示气泡的通知时，您必须使用具有 IMPORTANCE_MIN 或更高级别的通知渠道。

如果发送气泡时您的应用位于前台，则系统会忽略重要性并始终显示您的气泡（除非用户屏蔽了来自您应用的气泡或通知）。

创建展开的气泡

您可将气泡配置为自动以展开状态显示。我们建议您，仅在用户执行会显示气泡的操作（例如点按按钮以开始新聊天）时使用此功能。在这种情况下，您也有必要禁止显示在创建气泡时发送的初始通知。

您可以使用以下方法设置启用这些行为的标记：setAutoExpandBubble() 和 setSuppressInitialNotification()。

Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder()
        .setDesiredHeight(600)
        .setIntent(bubbleIntent)
        .setAutoExpandBubble(true)
        .setSuppressInitialNotification(true)
        .build();

气泡内容生命周期

当气泡展开时，内容 Activity 会经历常规进程生命周期，从而使应用成为前台进程（如果应用尚未在前台运行）。

当气泡被收起或关闭时，系统会销毁该 Activity。这可能导致系统缓存进程，并在之后将其终止，具体取决于应用是否有正在运行的其他前台组件。

显示气泡的时机

为减少干扰用户的次数，气泡仅在满足以下一个或多个条件时显示：

• 通知使用 MessagingStyle，并添加了 Person。
• 通知来自对 Service.startForeground 的调用，拥有 CATEGORY_CALL 类别，并添加了 Person。
• 发送通知时，应用在前台运行。

如果上述条件均不满足，则仅显示通知。

最佳实践

• 气泡会占用屏幕空间，并遮挡其他应用内容。您应仅在非常有必要（例如持续通信）或用户明确要求将某些内容显示为气泡时，才以气泡形式发送通知。
• 请注意，用户可以禁用气泡。在这种情况下，气泡通知以正常通知形式显示。同时，您应始终确保您的气泡通知以正常通知形式显示。
• 从气泡启动的进程（例如）会在气泡容器中显示。也就是说气泡可以拥有任务堆栈。如果您的气泡中有许多功能或导航，情况就会变得很复杂。我们建议您尽量让功能保持轻量具体。

在快速回复中使用富媒体

从 Android 11 开始，用户可以在快速回复中插入图片和其他富媒体内容。如需支持此功能，应用需要向 RemoteInput 通知添加信息，指定可以处理的 MIME 类型。应用可以通过调用 RemoteInput.Builder.setAllowDataType() 执行此操作。此外，应用还必须检查收到的任何 RemoteInput 广播，以查看广播是否包含其中任何一种类型的内容；应用可使用 RemoteInput.getDataResultsFromIntent() 执行此操作。

通知的设计由系统模板决定，您的应用只需定义模板各部分的内容。通知的某些详细信息仅在展开视图中显示。

1. 小图标：此为必要图标，通过 [setSmallIcon()] 设置。
2. 应用名称：此由系统提供。
3. 时间戳：此由系统提供，不过您可以通过 [setWhen()] 进行替换，或使用 [setShowWhen(false)] 将其隐藏。
4. 大图标：此为可选图标（通常仅用于联系人照片；请勿将其用于应用图标），通过 [setLargeIcon()] 设置。
5. 标题：此为可选内容，通过 [setContentTitle()] 设置。
6. 文本：此为可选内容，通过 [setContentText()] 设置。

如需详细了解如何使用上述及更多功能创建通知，请参阅创建通知。

与内容捕获服务共享数据

从 Android 11 开始，应用可以与设备的内容捕获服务共享数据。借助此功能，设备可以更轻松地提供情境智能，例如显示用户环境中正在播放的歌曲的名称，或者在用户靠近车站或机场时显示相关的旅行信息。

如需将应用中的数据共享给内容捕获服务，请对 ContentCaptureManager 的实例调用 shareData() 方法。如果系统接受数据共享请求，应用会收到将与内容捕获服务共享的只写文件描述符。

5G 图标显示

在 Android 11（API 级别“R”）及更高版本中，具有 android.Manifest.permission.READ_PHONE_STATE 权限的应用可以通过 PhoneStateListener.onDisplayInfoChanged() 请求更新电话显示信息，其中包括用于营销和品牌塑造的无线接入技术信息。

这款新 API 提供了适用于不同运营商的各种 5G 图标显示解决方案。支持的技术包括：

• LTE
• 采用载波聚合技术的 LTE (LTE+)
• 高级专业版 LTE (5Ge)
• NR (5G)
• 毫米波移动网络频段上的 NR (5G+)

隐私权

Android 11 引入了大量变更和限制，目的是加强用户隐私保护。如需了解详情，请参阅隐私权页面。

重大隐私权变更

下表汇总了 Android 11 中与隐私权相关的主要变更。

| | 隐私权变更 | 受影响的应用 | 缓解策略 |
| | 分区存储强制执行
以 Android 11 为目标平台的应用始终会受分区存储行为的影响 | 以 Android 11 为目标平台的应用，以及以 Android 10 为目标平台且未将 requestLegacyExternalStorage 设为 true 以停用分区存储的应用 | 更新您的应用以使用分区存储
详细了解分区存储变更 |
| | 一次性权限
通过一次性权限，用户可以向位置、麦克风和摄像头授予临时访问权限 | 以任何版本为目标平台且请求位置信息、麦克风或摄像头权限的应用 | 在尝试访问受某项权限保护的数据之前，检查您的应用是否具有该权限
遵循权限方面的最佳做法 |
| | 后台位置信息访问权限
Android 11 更改了应用向用户请求后台位置信息权限的方式 | 目标平台为 Android 11 且需要随时访问位置信息的应用 | 通过对权限请求方法的多次单独调用，逐步请求前台（粗略或精确）和后台位置权限。在每次请求之前，使用全屏视图向用户说明授予该权限所能得到的益处
详细了解后台位置信息访问权限 |
| | 软件包可见性
Android 11 更改了应用查询同一设备上的其他已安装应用及与之交互的方式 | 以 Android 11 为目标平台且与设备上的其他已安装应用交互的应用 | 将 元素添加到应用的清单
详细了解软件包可见性 |
| | 前台服务类型
Android 11 更改了前台服务访问摄像头和麦克风数据的方式 | 以 Android 11 为目标平台且在前台服务中访问摄像头或麦克风的应用 | 分别在访问摄像头数据和麦克风数据的服务中声明 camera 和 microphone 前台服务类型
详细了解新的前台服务类型 |

安全

生物识别身份验证机制更新

为了帮助您控制应用数据的安全级别，Android 11 对生物识别身份验证机制进行了多项改进。

身份验证类型

Android 11 引入了 BiometricManager.Authenticators 接口，该接口定义了 BiometricManager 类支持的身份验证类型：

BIOMETRIC_STRONG

使用满足兼容性定义页面上定义的强强度级别要求的硬件元素进行身份验证。

BIOMETRIC_WEAK

使用满足兼容性定义页面上定义的弱强度级别要求的硬件元素进行身份验证。

DEVICE_CREDENTIAL

使用屏幕锁定凭据（即用户的 PIN 码、解锁图案或密码）进行身份验证。

如需定义您的应用接受的生物识别身份验证类型，请向 setAllowedAuthenticators() 方法传递一个身份验证类型或按位类型组合。例如，如果您的应用接受“强”硬件元素或屏幕锁定凭据，请传入 BIOMETRIC_STRONG | DEVICE_CREDENTIAL。

如需检查是否有必要的身份验证元素，请将同一按位类型组合传入 canAuthenticate() 方法。如有必要，请调用 ACTION_BIOMETRIC_ENROLL intent 操作。在 intent extra 中，提供您的应用可接受的一组身份验证器。该 intent 会提示用户为您的应用接受的身份验证器注册凭据。

注意：为了注册身份验证器，用户需要创建 PIN 码、解锁图案或密码。如果用户还没有 PIN 码、解锁图案或密码，生物识别注册流程会提示他们创建一个。

在用户进行身份验证后，您可以通过调用 getAuthenticationType() 检查用户是使用设备凭据还是生物识别凭据进行的身份验证。

对“每次使用时进行身份验证”密钥的额外支持

Android 11 在 BiometricPrompt 类中提供了对“每次使用时进行身份验证”密钥的更多支持。此类密钥要求每次您的应用需要访问受该密钥保护的数据时，用户都必须提供生物识别凭据、设备凭据或上述任一凭据。“每次使用时进行身份验证”密钥对高价值的事务（如支付大笔款项或更新个人的健康档案）很有用。

如需将 BiometricPrompt 对象与“每次使用时进行身份验证”密钥相关联，请添加类似以下的代码：

KeyGenParameterSpec authPerOpKeyGenParameterSpec  =  new KeyGenParameterSpec.Builder("myKeystoreAlias", key-purpose)
    // Accept either a biometric credential or a device credential.
    // To accept only one type of credential, include only that type as the
    // 2nd argument.
    .setUserAuthenticationParameters(0 /* duration */,
            KeyProperties.AUTH_BIOMETRIC_STRONG |
            KeyProperties.AUTH_DEVICE_CREDENTIAL)
    .build();

已弃用的方法

Android 11 弃用了以下方法：

• setDeviceCredentialAllowed() 方法。
• setUserAuthenticationValidityDurationSeconds() 方法。
• 不带任何参数的 canAuthenticate() 过载版本。

安全共享大型数据集

在某些情况下，例如涉及机器学习或媒体播放时，您的应用可能需要与其他应用使用同一个大型数据集。在较早的 Android 版本中，您的应用与其他应用需要各自单独下载该数据集。

为帮助减少网络中和磁盘上的数据冗余，Android 11 允许使用共享数据 blob 在设备上缓存这些大型数据集。如需详细了解如何共享数据集，请参阅有关共享大型数据集的深度指南。

性能和质量

无线调试

Android 11 支持通过 Android 调试桥 (adb) 从工作站以无线方式部署和调试应用。例如，您可以将可调试的应用部署到多台远程设备，而无需通过 USB 实际连接您的设备，从而避免常见的 USB 连接问题（例如驱动程序安装方面的问题）。

如需使用无线调试，您需要使用配对码将您的设备与工作站配对。您的工作站和设备必须连接到同一无线网络。如需连接到您的设备，请按以下步骤操作：

1. 在您的工作站上，更新到最新版本的 SDK 平台工具。
2. 在设备上启用开发者选项。
3. 启用无线调试选项。
4. 在询问要在此网络上允许无线调试吗？的对话框中，点击允许。
5. 选择使用配对码配对设备。记下设备上显示的配对码、IP 地址和端口号（参见图片）。
6. 在工作站上，打开一个终端并导航到 android_sdk。
7. 运行 adb pair ipaddr port。使用第 5 步中的 IP 地址和端口号。
8. 当系统提示时，输入您在第 5 步中获得的配对码。系统会显示一条消息，表明您的设备已成功配对。

 Enter pairing code: 482924
 Successfully paired to 192.168.1.130:37099 [guid=adb-235XY]

9. （仅适用于 Linux 或 Microsoft Windows）运行 adb connect ipaddr :port。使用无线调试下的 IP 地址和端口（参见下图）。

ADB 增量 APK 安装

在设备上安装大型（2GB 以上）APK 可能需要很长的时间，即使应用只是稍作更改也是如此。ADB（Android 调试桥）增量 APK 安装可以安装足够的 APK 以启动应用，同时在后台流式传输剩余数据，从而加速这一过程。如果设备支持该功能，并且您安装了最新的 SDK 平台工具，adb install 将自动使用此功能。如果不支持，系统会自动使用默认安装方法。

运行以下 adb 命令以使用该功能。如果设备不支持增量安装，该命令将会失败并输出详细的解释。

adb install --incremental

在运行 ADB 增量 APK 安装之前，您必须先为 APK 签名并创建一个 APK 签名方案 v4 文件。必须将 v4 签名文件放在 APK 旁边，才能使此功能正常运行。

使用原生内存分配器进行错误检测

GWP-ASan 是一种原生内存分配器功能，可帮助查找释放后使用和堆缓冲区溢出错误。您可以全局启用此功能，也可以为应用的特定子进程启用此功能。如需了解详情，请参阅 GWP-Asan 指南。

Neural Networks API 1.3

Android 11 扩展并改进了 Neural Networks API (NNAPI)。

新运算方式

NNAPI 1.3 引入了新的运算数类型 TENSOR_QUANT8_ASYMM_SIGNED，以支持 TensorFlow Lite 的新量化方案。

此外，NNAPI 1.3 还引入了以下新运算：

• QUANTIZED_LSTM
• IF
• WHILE
• ELU
• HARD_SWISH
• FILL
• RANK

新的机器学习控件

NNAPI 1.3 引入了新控件以帮助机器学习流畅运行：

• QoS API：新的 Quality of Service API 使用以下新函数，支持在 NNAPI 中进行优先排序和任务截止时间设定：

  • ANeuralNetworksDevice_wait()
  • ANeuralNetworksCompilation_setPriority()
  • ANeuralNetworksCompilation_setTimeout()
  • ANeuralNetworksExecution_setTimeout()

• 内存域输入/输出：NNAPI 1.3 支持将内存域作为执行的输入和输出。这样可以移除不同系统组件之间不必要的相同数据，从而提高 Android 神经网络的运行时性能。此功能添加了一组用于与 ANeuralNetworksMemoryDesc 和 ANeuralNetworkMemory 对象结合使用的新 NDK API，包括以下函数：

  • ANeuralNetworksMemoryDesc_create()
  • ANeuralNetworksMemoryDesc_free()
  • ANeuralNetworksMemoryDesc_addInputRole()
  • ANeuralNetworksMemoryDesc_addOutputRole()
  • ANeuralNetworksMemoryDesc_setDimensions()
  • ANeuralNetworksMemoryDesc_finish()
  • ANeuralNetworksMemory_createFromDesc()
  • ANeuralNetworksMemory_copy()

  如需了解详情，请参阅神经网络内存域示例。

• Dependency API 和同步栅栏支持：NNAPI 1.3 支持使用依赖项实现异步计算，这样可以大大减少调用小型链式模型时产生的开销。此功能添加了以下新函数：

  • ANeuralNetworksEvent_createFromSyncFenceFd()
  • ANeuralNetworksEvent_getSyncFenceFd()
  • ANeuralNetworksExecution_startComputeWithDependencies()

• 控制流：NNAPI 1.3 支持使用新的图表运算 ANEURALNETWORKS_IF 和 ANEURALNETWORKS_WHILE 实现常规控制流，这些运算使用新的 ANEURALNETWORKS_MODEL 运算数类型接受其他模型作为参数。此外，此功能还添加了以下新函数：

  • ANeuralNetworksModel_setOperandValueFromModel()
  • ANeuralNetworks_getDefaultLoopTimeout()
  • ANeuralNetworks_getMaximumLoopTimeout()
  • ANeuralNetworksExecution_setLoopTimeout()

NDK Thermal API

当设备过热时，它们可能会限制 CPU 和/或 GPU，而这可能会以意想不到的方式影响应用。如果应用或游戏包含复杂图形，大量计算或持续网络活动，它们就更容易遇到问题。

在 Android 11 中使用 NDK Thermal API 监控设备上的温度变化，然后采取相应措施以降低耗电量和设备温度。该 API 类似于Java Thermal API；您可以使用它接收任何热状态更改的通知或直接轮询当前状态。

文本和输入

改进了 IME 转换

Android 11 引入了新的 API 以改进输入法 (IME) 的转换，例如屏幕键盘。这些 API 可让您更轻松地调整应用内容，与 IME 的出现和消失以及状态和导航栏等其他元素保持同步。

如需在聚焦至任何 EditText 时显示 IME，请调用 view.getInsetsController().[show(Type.ime())](https://developer.android.com/reference/android/view/WindowInsetsController#show(int))（您可以在与聚焦的 EditText 相同层次结构中的任何视图上调用此方法，无需专门在 EditText 上调用它）。如需隐藏 IME，请调用 view.getInsetsController().[hide(Type.ime())](https://developer.android.com/reference/android/view/WindowInsetsController#hide(int))。您可以通过调用 view.getRootWindowInsets().[isVisible(Type.ime())](https://developer.android.com/reference/android/view/WindowInsets#isVisible(int)) 检查 IME 当前是否可见。

如需同步应用的视图与 IME 的显示和消失，请通过提供 WindowInsetsAnimation.Callback 到 View.setWindowInsetsAnimationCallback() 在视图上设置监听器（您可以在任何视图上设置该监听器，它不一定必须为 EditText）。IME 会调用监听器的 onPrepare() 方法，之后会在转换开始时调用 onStart()。然后，它会在每次转换的过程中调用 onProgress()。转换完成后，IME 会调用 onEnd()。在转换过程中，您随时可以调用 WindowInsetsAnimation.getFraction() 以了解转换的进度。

有关如何使用这些 API 的示例，请参阅新的 WindowInsetsAnimation 代码示例。

控制 IME 动画

您还可以控制 IME 动画或其他系统栏（如导航栏）的动画。如需执行此操作，请先调用 setOnApplyWindowInsetsListener()，为窗口边衬区更改设置新的监听器：

 mRoot.setOnApplyWindowInsetsListener(new View.OnApplyWindowInsetsListener() {
   @Override
   public WindowInsets onApplyWindowInsets(View v, WindowInsets insets) {
       Insets barsIME = insets.getInsets(Type.systemBars() | Type.ime());
       mRootView.setPadding(barsIme.left, barsIme.top, barsIme.right,barsIme.bottom);
      // We return the new WindowInsets.CONSUMED to stop the insets being
      // dispatched any further into the view hierarchy. This replaces the
      // deprecated WindowInsets.consumeSystemWindowInsets() and related
      // functions.
       return WindowInsets.CONSUMED;
   }
});  

如需移动 IME 或其他系统栏，请调用控制器的 controlWindowInsetsAnimation() 方法：

 mRoot.getWindowInsetsController().controlWindowInsetsAnimation(
       Type.ime(), 1000, new LinearInterpolator(), cancellationSignal,
       new WindowInsetsAnimationControlListener() {
           @Override
           public void onReady(
                   @NonNull WindowInsetsAnimationController controller,
                   int types
                   ) {
                   // update IME inset
                   controller.setInsetsAndAlpha(Insets.of(0, 0, 0, inset),
                           1f /* alpha */, 0.1 /* fraction progress */);
           }
           @Override
           public void onCancelled() {}
       }); 

ICU 库更新

Android 11 更新了 android.icu 软件包，以使用 ICU 库版本 66，而 Android 10 中使用的是版本 63。新版库包含更新的 CLDR 语言区域数据以及众多对于 Android 中的国际化支持的增强功能。

新版库包含以下主要变更：

• 许多格式化 API 现在都支持可扩展 FormattedValue 的新返回对象类型。
• LocaleMatcher API 在以下方面得到增强：提供了构建器类，支持 java.util.Locale 类型，并且结果类可提供有关匹配的额外数据。
• 现在支持 Unicode 13。

媒体

分配 MediaCodec 缓冲区

Android 11 包含一个新的 MediaCodec API，可让应用在分配输入和输出缓冲区时获得更多控制。这样可以让您的应用更高效地管理内存。

新类：

• MediaCodec.LinearBlock
• MediaCodec.OutputFrame
• MediaCodec.QueueRequest

新方法：

• MediaCodec.getQueueRequest()
• MediaCodec.getOutputFrame()
• MediaCodec.LinearBlock.isCodecCopyFreeCompatible()

此外，MediaCodec.Callback() 中两种方法的行为也发生了变化：

onInputBufferAvailable()

如果配置为使用 Block Model API，应用应通过索引使用 MediaCodec.getQueueRequest，并将 LinearBlock/HardwareBuffer 附加到插槽，而不是通过索引调用 MediaCodec.getInputBuffer() 和 MediaCodec.queueInputBuffer()。

onOutputBufferAvailable()

应用可以通过索引使用 MediaCodec.getOutputFrame() 获取包含更多信息的 OutputFrame 对象和 LinearBlock/HardwareBuffer 缓冲区，而不是通过索引调用 MediaCodec.getOutputBuffer()。

MediaCodec 低延时解码

Android 11 增强了 MediaCodec，针对游戏和其他实时应用支持低延时解码。您可以将 FEATURE_LowLatency 传递到 MediaCodecInfo.CodecCapabilities.isFeatureSupported()，检查编解码器是否支持低延时解码。

如需启用或停用低延时解码，请执行以下任一操作：

• 使用 MediaCodec.configure() 将新键 KEY_LOW_LATENCY 设置为 0 或 1。
• 使用 MediaCodec.setParameters() 将新参数键 PARAMETER_KEY_LOW_LATENCY 设置为 0 或 1。

注意：支持低延时解码可能需要额外的资源，例如更高的功耗。仅在必要时使用低延时解码。

已弃用 OpenSL ES

从 NDK r21b Beta 版 2 开始，已弃用 OpenSL ES API。您应改用 Oboe。

平台仍支持现有应用的 OpenSL ES。然而，使用 minSdkVersion 为 30 或更高版本的 OpenSL ES 时，系统会显示构建警告。

新的 AAudio 函数 AAudioStream_release()

函数 AAudioStream_close() 会同时释放和关闭音频流。这可能很危险。如果其他进程在音频流关闭后尝试对其进行访问，该进程将会崩溃。

新函数 AAudioStream_release() 会释放音频流，但不会将其关闭。这样会释放其资源并使音频流处于已知状态。该对象将一直存在，直到您调用 AAudioStream_close()。

MediaParser API

MediaParser 是用于媒体提取的新型低级别 API。它比 MediaExtractor 更灵活，并提供对媒体提取功能的额外控制。

网络连接

Wi-Fi Passpoint 增强功能

通过 Passpoint，应用可以自动静默地执行身份验证并连接到安全的 Wi-Fi 热点。以 API 级别“R”及更高级别为目标平台的应用可以使用 Passpoint 的以下附加功能。

失效日期强制执行和通知

对个人资料强制执行失效日期可让框架避免使用过期凭据自动连接到接入点，该操作必定会失败。这样可以阻止无线连接，并节省电量和后端带宽。当用户的个人资料位于范围内但已过期时，该功能会向用户显示通知。

FQDN 匹配

允许使用 PerProviderSubscription (PPS) 管理对象 (MO) 中的 Extension/Android 节点，配置独立于接入网络查询协议 (ANQP) 完全限定域名 (FQDN) 的命名 AAA 域。

自签名的私人 CA

对于 Passpoint R1 个人资料，Android 接受采用私人自签名 CA 进行连接身份验证。

允许使用具有相同 FQDN 的多个个人资料

允许安装具有相同 FQDN 的多个 Passpoint 个人资料。FQDN 不用作个人资料的键。需要 FQDN 的现有 Passpoint API（如 remove）会将请求应用于具有相同 FQDN 的所有匹配的个人资料。

允许安装没有根 CA 证书的个人资料

允许使用没有根 CA 证书的个人资料。在这种情况下，系统会根据安装在信任库中的公共根 CA 证书验证 AAA 服务器证书。

改进了家庭网络服务提供商和漫游服务提供商的匹配

系统会匹配家庭网络或漫游网络，而不考虑所通告的身份验证方法。此外，还增加了对 OtherHomePartners 和 HomeOIList 列表的家庭网络匹配功能的支持。

Wi-Fi Suggestion API 扩展

Android 11 扩展了 Wi-Fi Suggestion API，以提高应用的网络管理能力，包括：

• 连接管理应用可以通过允许断开连接请求管理自己的网络。
• Passpoint 网络集成到 Suggestion API 中，可以推荐给用户。
• 通过 Analytics API，您可以获取有关网络质量的信息。

CallScreeningService 更新

从 Android 11 开始，CallScreeningService 可以针对来电请求有关 STIR/SHAKEN 验证状态 (verstat) 的信息。此信息将包含在来电的通话详情中。

如果 CallScreeningService 持有 READ_CONTACTS 权限，当收到用户联系人号码的来电或拨打用户联系人号码时，应用会收到通知。

GNSS 天线支持

Android 11 引入了 GnssAntennaInfo 类，让您的应用能够更多地利用全球导航卫星系统 (GNSS) 提供的厘米精度定位。用户向您的应用授予 ACCESS_FINE_LOCATION 权限之后，您的应用可以访问与 GNSS 天线相关的以下详细信息：

• 相位中心偏移 (PCO) 坐标
• 相位中心变化 (PCV) 校正
• 信号增益校正

如需确定设备是否可以向您的应用提供 GNSS 天线信息，请调用 hasGnssAntennaInfo()。

隐私注意事项

• GNSS 天线只能识别设备型号，而不能识别具体设备。
• 如需使用 GnssAntennaInfo 类，必须具备 ACCESS_FINE_LOCATION 权限。

图形

NDK 图像解码器

NDK ImageDecoder API 提供了一种标准 API，供 Android C/C++ 应用直接解码图像。应用开发者不再需要使用框架 API（通过 JNI）或捆绑第三方图像解码库。有关详情，请参阅图像解码器开发者指南。

Frame rate API

Android 11 提供了一个 API，可让应用告知系统其预期帧速率，从而减少支持多个刷新率的设备上的抖动。有关如何使用此 API 的信息，请参阅帧速率指南。

请求并检查低延时支持

特定的显示屏可以执行图形后期处理，例如某些外部显示屏和电视。此类后期处理改善了图形质量，但可能会增加延时。支持 HDMI 2.1 的新款显示屏具有自动低延时模式（ALLM，也称为游戏模式），该模式可以通过关闭后期处理以最大限度地缩短延时。如需详细了解 ALLM，请参阅 HDMI 2.1 规范。

窗口可以请求使用自动低延时模式（如果可用）。ALLM 对于游戏和视频会议等应用特别有用，因为对于这些应用而言，低延时的重要性要高于拥有最佳的图形质量。

如需开启或关闭最低限度的后期处理，请调用 Window.setPreferMinimalPostProcessing()，或将窗口的 preferMinimalPostProcessing 属性设置为 true。并非所有的显示屏都支持最低限度的后期处理；如需了解某个显示屏是否支持该功能，可调用新方法 Display.isMinimalPostProcessingSupported()。

注意：如果用户停用最低限度的后期处理，或者显示屏不支持低延时模式，那么调用 Window.setPreferMinimalPostProcessing() 不会有任何作用。

高性能图形调试层注入

应用现在可以将外部图形层（GLES、Vulkan）加载到原生应用代码中，可以在不产生性能开销的前提下，提供与可调试应用相同的功能。在使用 GAPID 等工具对应用进行性能剖析时，此功能尤为重要。如需对应用进行性能剖析，只需要在应用清单文件中添加以下元数据元素，而无需让应用变成可调试应用：

适用于 OpenGL ES 的 ANGLE

您可以使用 ANGLE 运行非核心应用以评估性能，并确定特定应用是否应使用 ANGLE，而不是原生 OpenGL ES 驱动程序。有关说明，请参阅使用适用于 OpenGL ES 的 ANGLE。

图片和相机

在主动拍摄期间关闭通知提示音和振动

从 Android 11 开始，在主动使用相机时，您的应用可以使用 setCameraAudioRestriction() 以仅关闭振动、同时关闭声音和振动或都不关闭。

Android 模拟器中的相机支持扩展

Android 11 改进了Android 模拟器相机功能。添加的功能包括：

• RAW 捕获
• YUV 重新处理
• 3 级设备
• 逻辑摄像头支持

更好地支持包含多个帧的 HEIF 图片

从 Android 11 开始，如果您调用 ImageDecoder.decodeDrawable() 并传递包含帧序列的 HEIF 图片（如动画或连拍照片），则该方法会返回包含整个图片序列的 AnimatedImageDrawable。在较低版本的 Android 系统中，该方法会返回仅包含单个帧的 BitmapDrawable。

如果 HEIF 图片包含的多个帧不在一个序列中，您可以通过调用 MediaMetadataRetriever.getImageAtIndex() 检索各个帧。

无障碍功能

面向无障碍服务开发者的更新

如果您创建自定义无障碍服务，可以在 Android 11 中使用以下功能：

• 在无障碍服务的面向用户的解释中，除了纯文本之外，现在还允许使用 HTML 和图片。这种灵活性可让您更轻松地向最终用户解释您的服务有何功能以及对他们有何帮助。
• 如需使用比 contentDescription 在语义上更有意义的界面元素的状态说明，请调用 getStateDescription() 方法。
• 如需请求触摸事件绕过系统的触摸浏览器，请调用 setTouchExplorationPassthroughRegion()。同样，如需请求手势绕过系统的手势检测器，请调用 setGestureDetectionPassthroughRegion()。
• 您可以请求 IME 操作（如“输入”和“下一个”），以及不启用 FLAG_SECURE 标记的窗口的屏幕截图。

其他功能

应用进程退出原因

Android 11 引入了 ActivityManager.getHistoricalProcessExitReasons() 方法，用于报告近期任何进程终止的原因。应用可以使用此方法收集崩溃诊断信息，例如进程终止是由于 ANR、内存问题还是其他原因所致。此外，您还可以使用新的 setProcessStateSummary() 方法存储自定义状态信息，以便日后进行分析。

getHistoricalProcessExitReasons() 方法会返回 ApplicationExitInfo 类的实例，该类包含与应用进程终止相关的信息。通过对此类的实例调用 getReason()，您可以确定应用进程终止的原因。例如，REASON_CRASH 的返回值表示应用中发生了未处理的异常。如果应用需要确保退出事件的唯一性，可以保留特定于应用的标识符，例如基于 getTimestamp() 方法的时间戳的哈希值。

资源加载器

欢迎您提供相关反馈！请填写这份简短的调查问卷，将您使用此功能的情况告知我们。特别是，请将受此功能影响的用例告知我们。

Android 11 引入了一个新 API，允许应用动态扩展资源的搜索和加载方式。新的 API 类 ResourcesLoader 和 ResourcesProvider 主要负责提供新功能。两者协同作用，可以提供额外的资源，或修改现有资源的值。

ResourcesLoader 对象是向应用的 Resources 实例提供 ResourcesProvider 对象的容器，而 ResourcesProvider 对象提供从 APK 和资源表加载资源数据的方法。

此 API 的一个主要用例是自定义资源加载。您可以将新 API 类 DirectoryAssetsProvider 的实例与 ResourcesProvider 配对，以重定向基于文件的资源的解析，这样就只需搜索特定目录，而无需搜索应用 APK。您可以通过 AssetManager API 类中的 open() 系列方法访问这些资源，就像访问 APK 中绑定的资源一样。

APK 签名方案 v4

Android 11 添加了对 APK 签名方案 v4 的支持。此方案会在单独的文件 (apk-name.apk.idsig) 中生成一种新的签名，但在其他方面与 v2 和 v3 类似。没有对 APK 进行任何更改。此方案支持 ADB 增量 APK 安装，这样会加快 APK 安装速度。

动态 intent 过滤器

如需接收 intent，应用必须通过在其清单中定义 intent 过滤器，在编译时声明它能够接收哪些类型的数据。在 Android 10 及更低版本中，应用无法在运行时更改其 intent 过滤器。这对于虚拟化应用（如虚拟机和远程桌面）而言是一个问题，因为这些应用无法确切得知用户将在它们内部安装什么软件。

Android 11 引入了 MIME 组，这是一个新的清单元素，可让应用在 intent 过滤器中声明一组动态的 MIME 类型，并在运行时以编程方式对其进行修改。如需使用 MIME 组，请使用新的 android:mimeGroup 属性在应用清单中添加一个数据元素：

android:mimeGroup 属性的值是任意字符串 ID，用于在运行时标识 MIME 组。您可以通过将某个 MIME 组的 ID 传递给 PackageManager API 类中的以下新方法，访问和更新该 MIME 组的内容：

• getMimeGroup()
• setMimeGroup()
• clearMimeGroup()

如果您以编程方式将 MIME 类型添加到 MIME 组，其运作方式与清单中明确声明的静态 MIME 类型完全相同。

注意：mimeGroup 字符串是基于每个软件包定义的。在同一软件包中，您可以在多个 intent 过滤器或组件中使用相同的 mimeGroup 字符串以声明它们之间共享的 MIME 组。不同的软件包不能共享 MIME 组，但它们可以使用相同的 mimeGroup 字符串，而不相互干扰。

自动填充增强功能

Android 11 改进了自动填充服务。

AssistStructure.ViewNode 中的提示标识符

对自动填充服务来说，根据视图的属性计算视图的签名哈希值通常很有用。在计算签名哈希值时，视图提示是一个非常值得参考的属性，但提示字符串可能会随着手机的语言区域而发生变化。为了解决此问题，Android 11 使用新的 getHintIdEntry() 方法扩展了 AssistStructure.ViewNode，该方法会返回视图提示文本的资源标识符。此方法提供一个与语言区域无关的值，可用于计算签名哈希值。

提供了数据集的事件

为了帮助自动填充服务提高建议内容的质量，Android 11 提供了一种方法以识别自动填充服务提供了数据集但用户未选择任何数据集的情况。在 Android 11 中，FillEventHistory 会报告一种新的 TYPE_DATASETS_SHOWN 事件类型。每当自动填充服务向用户提供一个或多个数据集时，FillEventHistory 就会记录此类型的事件。自动填充服务可以将这些事件与现有的 TYPE_DATASET_SELECTED 事件结合使用来确定用户是否选择了任何提供的自动填充选项。