作者 / 软件工程师 Peter Visontay 和 Bessie Jiang
贡献者 / 软件工程师 Inara Ramji、交互设计师 Rodrigo Farell、产品经理 James Kelly、项目经理 Henry Chin
大多数用户会在智能手机上花费大量时间。无论是工作、玩游戏，还是与朋友联系，人们总会使用应用并将其作为数字化生活的主要途径。应用通常需要请求某些权限才能正常运行，但在任何给定的设备都有数十个应用的情况下，要让之前授予的权限保持最新状态可能很困难，特别是在您长时间未使用某个应用时。
我们在 Android 11 中引入了 权限自动重置功能。这项功能有助于保护用户的隐私: 如果用户几个月未使用某应用，该功能就会自动重置此应用的 运行时权限，即请求时向用户显示提示的权限。2021 年 12 月起，我们会将这项功能扩展到数十亿台设备。该功能将自动在运行 Android 6.0 (API 级别 23) 或更高版本的使用 Google Play 服务 的设备上启用。
系统将默认为面向 Android 11 (API 级别 30) 或更高版本的应用启用该功能。不过，用户可以为面向 API 级别 23 到 29 的应用手动启用权限自动重置功能。
那么，这对开发者来说意味着什么呢？
例外
一些应用和权限将自动免于撤消，如企业使用的活动设备管理员应用，以及由企业政策固定的权限。
请求用户停用自动重置
如有需要，开发者可以请求用户阻止系统重置其应用的权限。适用于用户期望应用主要在后台运行，甚至无需与其互动的情况。您可以查看 主要用例。
比较当前行为与新行为
必要的代码更改
如果一个应用面向 API 30 及更高版本，并请求用户停用权限自动重置，那么开发者需要做一些简单的代码更改。如果应用不停用自动重置，则无需进行代码更改。
注: 此 API 仅适用于 targetSDK 为 API 30 或更高版本的应用，因为仅这些应用具有权限自动重置。如果应用的 targetSDK 为 API 29 或更低版本，则开发者无需进行任何更改。
下表汇总了新的跨平台 API (与 Android 11 中发布的 API 相比):
| 操作 | Android 11 API(适用于 Android 11 及更高版本的设备) | 新的跨平台 API(适用于 Android 6.0 及更高版本的设备，包含 Android 11 及更高版本的设备) |
|---|---|---|
| 检查设备是否启用了权限自动重置功能 | 检查是否 Build.VERSION.SDK_INT >= Build.VERSION_CODES.R
|
调用 androidx.core.content.PackageManagerCompat.getUnusedAppRestrictionsStatus()
|
| 检查您的应用是否停用自动重置 | 调用 PackageManager.isAutoRevokeWhitelisted() | 调用 androidx.core.content.PackageManagerCompat.getUnusedAppRestrictionsStatus()
|
| 请求用户为您的应用停用自动重置 | 发送带操作的 intent Intent.ACTION_AUTO_REVOKE_PERMISSIONS | 发送利用 androidx.core.content.IntentCompat.createManageUnusedAppRestrictionsIntent() 创建的 intent |
这个跨平台 API 属于 Jetpack Core 库，将于 Jetpack Core v1.7.0 中推出，现已发布 Beta 版。
一个需要用户禁用自动停用自动重置的逻辑示例:
val future: ListenableFuture<Int> =
PackageManagerCompat.getUnusedAppRestrictionsStatus(context)
future.addListener(
{ onResult(future.get()) },
ContextCompat.getMainExecutor(context)
)
fun onResult(appRestrictionsStatus: Int) {
when (appRestrictionsStatus) {
// Status could not be fetched. Check logs for details.
ERROR -> { }
// Restrictions do not apply to your app on this device.
FEATURE_NOT_AVAILABLE -> { }
// Restrictions have been disabled by the user for your app.
DISABLED -> { }
// If the user doesn't start your app for months, its permissions
// will be revoked and/or it will be hibernated.
// See the API_* constants for details.
API_30_BACKPORT, API_30, API_31 ->
handleRestrictions(appRestrictionsStatus)
}
}
fun handleRestrictions(appRestrictionsStatus: Int) {
// If your app works primarily in the background, you can ask the user
// to disable these restrictions. Check if you have already asked the
// user to disable these restrictions. If not, you can show a message to
// the user explaining why permission auto-reset and Hibernation should be
// disabled. Tell them that they will now be redirected to a page where
// they can disable these features.
Intent intent = IntentCompat.createManageUnusedAppRestrictionsIntent
(context, packageName)
// Must use startActivityForResult(), not startActivity(), even if
// you don't use the result code returned in onActivityResult().
startActivityForResult(intent, REQUEST_CODE)
}
以上逻辑适用于 Android 6.0 到 Android 10，以及 Android 11 和更高版本的设备。只需使用新 API 即可，您无需再调用 Android 11 的自动重置 API。
与 Android 12 中应用休眠功能的兼容
新 API 同样与 Android 12 (API 级别 31) 中引入的应用休眠功能 兼容。休眠是适用于未使用应用的一种新限制。该功能不适用于 Android 12 之前的操作系统版本。
如果权限自动重置和应用休眠都应用于一个应用，则 getUnusedAppRestrictionsStatus() API 将返回 API_31。
发布时间表
- 2021 年 9 月 15 日 - 跨平台自动重置 API 现已进入测试阶段 (Jetpack Core 1.7.0 Beta 版库)，所以开发者现在就可以开始使用这些 API。即使在不支持权限自动重置的设备上，使用这些 API 也是安全的 (API 在这些设备上会返回 FEATURE_NOT_AVAILABLE)。
- 2021 年 10 月 - 跨平台自动重置 API 可作为稳定的 API 使用 (Jetpack Core 1.7.0)。
- 2021 年 12 月 - 权限自动重置功能将开始在由 Google Play 服务提供支持并运行 Android 6.0 到 Android 10 之间版本的设备上逐步推广。在这些设备上，用户可以前往自动重置设置页面，针对特定应用启用/停用自动重置。系统将在设备启用该功能几周后开始自动重置未使用应用的权限。
- 2022 年第 1 季度 - 权限自动重置功能将覆盖所有运行 Android 6.0 到 Android 10 之间版本的设备。
欢迎您持续关注我们，随时获取最新资讯。
欢迎您 点击这里 向我们提交反馈，或分享您喜欢的内容、发现的问题。您的反馈对我们非常重要，感谢您的支持！
