Android 11 图片选取统一方法详解

本文深入解析了在 Android 11 及更高版本（强制启用 Scoped Storage）下如何安全、合规且兼容地从系统图库选取图片——彻底摒弃已失效的 `READ_EXTERNAL_STORAGE` 权限，转而采用无需运行时授权的 `Intent.ACTION_PICK` + `MediaStore` URI 方案，通过 `ContentResolver` 安全读取 content:// URI，既规避了权限静默失败和 OEM 系统兼容性问题，又满足 Google Play 隐私政策要求，实现从 Android 8.0 到 14 的全版本无缝支持。

本文详解如何在 Android 11 及更高版本（Scoped Storage 强制启用）与 Android 10 及更低版本中，兼容性地从系统图库选取图片，无需读取外部存储权限，规避 `READ_EXTERNAL_STORAGE` 权限失效问题。

在 Android 11（API 级别 30）及以上，Google 彻底弃用 READ_EXTERNAL_STORAGE 对媒体文件的访问能力——即使你声明了该权限并成功获取，调用 ACTION_PICK 时仍可能因权限限制或目标 intent 不匹配而静默失败。你当前代码中使用 android:maxSdkVersion="29" 的写法，恰恰导致 Android 11+ 设备完全不申请该权限，进而使 selectImage() 在未授权状态下直接执行，最终 Intent.ACTION_PICK 因缺少必要上下文而无法启动图库（尤其在部分 OEM 定制系统中表现更明显）。

✅ 正确方案：放弃请求 READ_EXTERNAL_STORAGE，改用无需运行时权限的 Intent.ACTION_PICK + MediaStore URI 方案，并适配 Android 11+ 的作用域存储行为

✅ 推荐实现（全版本兼容）

1. 移除 maxSdkVersion 并精简权限声明（仅保留必要项）

<!-- AndroidManifest.xml -->
<!-- 删除 maxSdkVersion，但注意：Android 11+ 不再需要此权限用于 PICK 操作 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 如果仅用于图库选取，甚至可完全移除此行（推荐） -->

⚠️ 注意：READ_EXTERNAL_STORAGE 在 Android 11+ 对 ACTION_PICK 非必需；保留它反而可能触发不必要的权限弹窗或被 Google Play 拒绝（若未在隐私政策中说明用途）。

2. 简化点击逻辑（无需动态权限检查）

layoutMiscellaneous.findViewById(R.id.layoutAddImage).setOnClickListener(view -> {
    bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
    selectImage(); // 直接调用，无需先检查权限
});

3. 安全、稳定的图片选取方法

private void selectImage() {
    Intent intent = new Intent(Intent.ACTION_PICK);
    intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");

    // 关键：显式指定 Intent 类别，提升兼容性（尤其对 Android 12+ 和 Samsung/MIUI）
    intent.addCategory(Intent.CATEGORY_OPENABLE);

    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_CODE_SELECTED_IMAGE);
    } else {
        Toast.makeText(this, "未找到可用图库应用", Toast.LENGTH_SHORT).show();
    }
}

4. 正确处理返回结果（适配 Android 11+ 的 URI 安全性）

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_SELECTED_IMAGE && resultCode == RESULT_OK && data != null) {
        Uri selectedImageUri = data.getData();
        if (selectedImageUri != null) {
            try {
                // 推荐：使用 ContentResolver 安全读取（自动适配 Scoped Storage）
                InputStream inputStream = getContentResolver().openInputStream(selectedImageUri);
                Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
                // ✅ 此方式在 Android 11+ 下完全合法，无需任何权限
                // 后续可上传、压缩或显示 bitmap
            } catch (FileNotFoundException e) {
                Toast.makeText(this, "图片读取失败", Toast.LENGTH_SHORT).show();
            }
        }
    }
}

? 关键原理说明

• Intent.ACTION_PICK 是系统级契约行为，由图库 App（如 Google Photos、三星图库）响应，返回的是 content:// URI（非 file://），天然受 Android 10+ Scoped Storage 保护。
• content:// URI 通过 ContentResolver 访问时，系统自动授予临时读取权限（FLAG_GRANT_READ_URI_PERMISSION），开发者无需声明或请求 READ_EXTERNAL_STORAGE。
• maxSdkVersion="29" 是旧版适配遗留，现已过时；Android 11+ 应转向以 Intent 为中心的媒体访问范式。

? 最佳实践总结

• ✅ 永远不要为 ACTION_PICK 请求 READ_EXTERNAL_STORAGE（Android 10+ 无效，Android 11+ 可能违规）
• ✅ 使用 setDataAndType(..., "image/*") + addCategory(Intent.CATEGORY_OPENABLE) 提升兼容性
• ✅ 在 onActivityResult 中用 getContentResolver().openInputStream(uri) 安全读取，避免 File API
• ✅ 若需多图选择，改用 Intent.ACTION_GET_CONTENT（支持 Intent.EXTRA_ALLOW_MULTIPLE）

遵循以上方案，你的应用将无缝支持 Android 8.0 至 Android 14 的图库图片选取，同时满足 Google Play 的隐私合规要求。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。