Android 11背景位置权限getBackgroundPermissionOptionLabel使用方法咨询

该方法是Android 11（API 30）新增的PackageManager类方法，作用是返回系统设置页面中后台位置权限选项的本地化文本标签，解决不同系统语言、厂商定制场景下，引导用户开启权限的文案和系统实际选项名不匹配的问题。

使用前提 #

该方法仅支持Android 11（API 30）及以上系统调用，低于该版本的系统无法使用，需要提前做版本适配判断

具体使用步骤 #

• 首先校验当前设备的系统API级别是否符合要求
• 通过应用上下文获取PackageManager实例
• 直接调用方法即可拿到对应文本，返回值为CharSequence类型，可直接用于提示文案拼接

代码示例 #

// Java 示例
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    PackageManager pm = getApplicationContext().getPackageManager();
    CharSequence optionLabel = pm.getBackgroundPermissionOptionLabel();
    // 拼接引导文案，比如用在Dialog提示中
    String guideTip = "如需正常使用后台定位功能，请在权限设置中选择「" + optionLabel + "」";
    // 后续可执行跳转应用权限设置页的逻辑
}

// Kotlin 示例
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    val pm = applicationContext.packageManager
    val optionLabel = pm.backgroundPermissionOptionLabel
    val guideTip = "如需正常使用后台定位功能，请在权限设置中选择「${optionLabel}」"
    // 后续逻辑
}

注意事项 #

• 方法返回的文本会自动跟随系统语言、厂商定制规则调整，无需额外做多语言适配
• 调用该方法不需要申请任何额外权限，只要应用上下文有效即可正常返回结果
• 必须添加API级别判断逻辑，否则在低于API 30的设备上运行会抛出方法找不到的崩溃

内容的提问来源于stack exchange，提问作者The Crispy Toasty