如何将Android应用升级到34版本并解决联系人权限问题？

针对你升级到API34后遇到的联系人权限无法授予的问题，结合Android 14的权限改动和你的代码，给出以下分析和解决方案：

1. API34对权限处理的关键改动 #

• "不再询问"触发逻辑更严格：若用户第一次拒绝权限请求，第二次请求前未向用户解释权限用途（rationale），系统会允许用户直接勾选"不再询问"，后续请求会直接返回拒绝，且不再弹出权限弹窗。
• WRITE_CONTACTS需与READ_CONTACTS关联请求：Android 14中，写入联系人的操作依赖读取联系人基础信息，因此WRITE_CONTACTS权限需和READ_CONTACTS同时申请，仅声明未请求会导致权限逻辑异常。
• 旧权限API的兼容性弱化：虽然requestPermissions和onRequestPermissionsResult仍可运行，但Android官方已推荐使用Activity Result API替代，旧API在部分场景下存在生命周期适配问题。

2. Android 14中请求联系人权限的新方法与最佳实践 #

推荐使用Activity Result API替代旧回调 #

这是官方推荐的权限请求方式，避免旧回调的生命周期隐患，逻辑更清晰：

// 初始化权限请求器，放在Activity/Fragment的onCreate中
private final ActivityResultLauncher<String[]> requestContactPermissionLauncher =
        registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(),
                result -> {
                    Boolean readGranted = result.getOrDefault(Manifest.permission.READ_CONTACTS, false);
                    if (readGranted) {
                        // 权限已授予，执行联系人相关操作
                    } else {
                        // 权限被拒绝，分情况处理
                        if (!shouldShowRequestPermissionRationale(Manifest.permission.READ_CONTACTS)) {
                            // 用户勾选了"不再询问"，引导到应用设置页手动开启权限
                            Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
                            Uri uri = Uri.fromParts("package", getPackageName(), null);
                            intent.setData(uri);
                            startActivity(intent);
                        }
                    }
                });

// 发起权限请求的方法
private void requestContactPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {
        // 检查是否需要向用户解释权限用途
        if (shouldShowRequestPermissionRationale(Manifest.permission.READ_CONTACTS)) {
            // 弹出弹窗说明权限必要性，提升用户授予意愿
            new AlertDialog.Builder(this)
                    .setTitle("需要联系人权限")
                    .setMessage("为了帮你快速选择联系人，需要获取你的联系人访问权限")
                    .setPositiveButton("知道了", (dialog, which) -> {
                        requestContactPermissionLauncher.launch(new String[]{
                                Manifest.permission.READ_CONTACTS,
                                Manifest.permission.WRITE_CONTACTS
                        });
                    })
                    .setNegativeButton("取消", null)
                    .show();
        } else {
            // 直接发起权限请求
            requestContactPermissionLauncher.launch(new String[]{
                    Manifest.permission.READ_CONTACTS,
                    Manifest.permission.WRITE_CONTACTS
            });
        }
    } else {
        // 权限已授予，直接执行操作
    }
}

最佳实践要点 #

• 同时请求READ_CONTACTS和WRITE_CONTACTS：避免分两次请求打扰用户，符合Android 14的权限关联逻辑。
• 必须处理"不再询问"场景：用户勾选该选项后，无法再通过弹窗请求权限，需引导到设置页开启。
• 权限申请前先说明用途：降低用户的抵触心理，提升权限授予率。

3. 你可能忽略的潜在问题 #

• 未处理权限rationale：你的旧代码中没有在二次请求前显示权限说明，导致用户容易拒绝并触发"不再询问"，后续请求直接失败。
• 运行时请求权限不全：Manifest中声明了WRITE_CONTACTS但运行时未请求，可能导致系统权限逻辑异常。
• 测试设备的权限状态：检查测试设备的应用权限设置，是否之前已手动拒绝权限并勾选"不再询问"，此时需先去设置页开启权限再测试。
• AndroidX依赖版本：确保项目中androidx.core:core-ktx或androidx.appcompat:appcompat的版本足够新，以兼容API34的权限逻辑。

内容的提问来源于stack exchange，提问作者Aarif Ali