如何在 Android 11+（API 30+）及更低版本中统一选取图库图片-java教程-PHP中文网

如何在 Android 11+（API 30+）及更低版本中统一选取图库图片

本文详解如何在 Android 全版本（含 Android 11/12/13/14）中安全、兼容地从系统图库选取图片，解决因 maxSdkVersion="29" 导致高版本权限失效、ACTION_PICK 调用失败的问题，并提供适配 Scoped Storage 的最佳实践方案。

本文详解如何在 android 全版本（含 android 11/12/13/14）中安全、兼容地从系统图库选取图片，解决因 `maxsdkversion="29"` 导致高版本权限失效、`action_pick` 调用失败的问题，并提供适配 scoped storage 的最佳实践方案。

在 Android 11（API 30）及以上版本中，Google 强化了存储访问限制，废弃了以 READ_EXTERNAL_STORAGE 为前提的广义外部存储读取能力——即使你声明了该权限，系统也不会授予对其他应用媒体文件的访问权。此时，Intent.ACTION_PICK 仍可正常工作（因其属于系统级媒体选择器，不依赖运行时存储权限），但前提是不能通过 android:maxSdkVersion="29" 锁死权限范围。

✅ 正确的权限声明方式（Manifest）

请立即移除 maxSdkVersion 属性：

<!-- ❌ 错误：仅适用于 API ≤ 29 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxsdkversion="29"></uses-permission><!-- ✅ 正确：声明权限（低版本需要），高版本自动忽略但不报错 --><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>

⚠️ 注意：自 Android 6.0（API 23）起，READ_EXTERNAL_STORAGE 已为危险权限，需动态申请；而自 Android 10（API 29）起，默认启用分区存储（Scoped Storage），Android 11+ 更彻底移除了该权限对媒体库的实际效力。因此，它仅对 Android 9 及以下设备生效，高版本下纯属“占位声明”，但必须保留以保证旧设备兼容性。

✅ 兼容全版本的图库选取实现

无需为不同 SDK 版本编写两套逻辑。以下代码在 Android 5.0（API 21）至 Android 14（API 34）均稳定可用：

private static final int REQUEST_CODE_SELECTED_IMAGE = 1001;

findViewById(R.id.layoutAddImage).setOnClickListener(v -> {
    bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);

    // ✅ Android 11+ 不再需要 READ_EXTERNAL_STORAGE 来启动 ACTION_PICK
    // 但仍建议检查权限（兼顾 Android 9 及以下）
    if (Build.VERSION.SDK_INT  0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            selectImage();
        } else {
            Toast.makeText(this, R.string.permissao_recusada, Toast.LENGTH_SHORT).show();
        }
    }
}

@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 imageUri = data.getData();
        if (imageUri != null) {
            // ✅ 安全获取图片路径（推荐使用 ContentResolver 加载流）
            try (InputStream inputStream = getContentResolver().openInputStream(imageUri)) {
                Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
                // TODO: 使用 bitmap 或保存到应用私有目录
            } catch (IOException e) {
                Log.e("ImagePick", "Failed to load image", e);
                Toast.makeText(this, "图片加载失败", Toast.LENGTH_SHORT).show();
            }
        }
    }
}

? 关键要点总结

ACTION_PICK 是跨版本首选方案：它调用系统图库 UI，由用户自主选择图片，天然绕过 Scoped Storage 限制，无需任何运行时存储权限（Android 11+）。
不要滥用 maxSdkVersion：它会阻止高版本系统解析权限，导致编译或安装时静默失效，是兼容性常见陷阱。
权限检查应按需分层：
- Build.VERSION.SDK_INT
- Build.VERSION.SDK_INT >= Build.VERSION_CODES.R（Android 11+）→ 完全跳过权限申请，直接调用 ACTION_PICK。
URI 处理务必使用 ContentResolver：避免尝试将 content:// URI 转为 file:// 路径（高版本禁止且不可靠），始终通过 openInputStream() 或 loadThumbnail() 安全读取。