使用uni.chooseImage是否需要动态申请权限适配不同的android版本

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

针对你的问题，“使用 uni.chooseimage 是否需要动态申请权限适配不同的 android 版本”，答案是需要，并且要根据 android 版本进行适配。

这主要取决于 android 系统的权限机制变化和你的应用目标版本。以下是详细分析和建议方案：

1. 核心结论：需要动态申请，且权限要求因 android 版本而异

• android 13 (api 33) 及以上版本：系统引入了更细粒度的媒体权限。访问图片不再使用 read_external_storage，而是需要使用 read_media_images。如果要在 android 13 及以上设备上正常使用 uni.chooseimage 选择图片，你必须在 manifest.json 中声明此权限，并在运行时动态申请。
• android 12 (api 32) 及以下版本：通常需要 read_external_storage 权限。如果应用未声明或未获得此权限，调用 uni.chooseimage 选择相册时，可能无法读取任何图片，或直接报错。

2. 如何适配与配置

你需要从静态声明和动态申请两方面入手。

第一步：在 manifest.json 中静态声明权限

你需要根据 android 版本声明不同的权限。在 manifest.json 的源码视图中进行配置。根据你的 hbuilderx 版本，配置位置略有不同：

• hbuilderx 4.71 及以上版本：在 app-android -> distribute -> permissions 节点下配置。
• hbuilderx 4.71 以下版本：在 app -> distribute -> android -> permissions 节点下配置。

建议的配置示例如下（以 hbuilderx 4.71+ 为例）：

// manifest.json 源码视图  
{  
  "app-android": {  
    "distribute": {  
      "permissions": [  
        "<uses-permission android:name=\"android.permission.READ_EXTERNAL_STORAGE\"/>",  
        "<uses-permission android:name=\"android.permission.READ_MEDIA_IMAGES\"/>",  
        "<uses-permission android:name=\"android.permission.CAMERA\"/>"  
      ]  
    }  
  }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

• read_external_storage：用于兼容 android 12 及以下版本。
• read_media_images：专门用于 android 13 及以上版本的图片选择。
• camera：如果用户需要拍照，则必须声明。

第二步：在代码中动态申请权限

在调用 uni.chooseimage 之前，你需要先检查和请求必要的权限。推荐使用 plus.android.requestpermissions 此方法可以动态处理权限申请，并提供回调结果。

以下是一个封装好的、适配不同 android 版本的权限申请函数示例：

// 封装一个请求存储/媒体权限的函数  
function requestStoragePermission() {  
    return new Promise((resolve, reject) => {  
        // 判断 android 版本  
        if (plus.os.sdkint >= 33) { // android 13 及以上  
            plus.android.requestpermissions(  
                ['android.permission.read_media_images'], // 申请新权限  
                (e) => {  
                    if (e.granted.length > 0) {  
                        resolve(); // 权限已获取  
                    } else {  
                        reject(new error('需要媒体读取权限才能选择图片'));  
                    }  
                },  
                (e) => {  
                    reject(e);  
                }  
            );  
        } else { // android 12 及以下  
            plus.android.requestpermissions(  
                ['android.permission.read_external_storage'],  
                (e) => {  
                    if (e.granted.length > 0) {  
                        resolve();  
                    } else {  
                        reject(new error('需要存储读取权限才能选择图片'));  
                    }  
                },  
                (e) => {  
                    reject(e);  
                }  
            );  
        }  
    });  
}  

// 在你的业务逻辑中使用  
async function selectimage() {  
    try {  
        await requeststoragepermission();  
        // 权限获取成功后，再调用 chooseimage  
        uni.chooseimage({  
            count: 1,  
            success: (res) => {  
                console.log('成功选择图片', res.tempfilepaths);  
            },  
            fail: (err) => {  
                console.error('选择图片失败', err);  
            }  
        });  
    } catch (error) {  
        console.error('权限申请失败或用户拒绝', error);  
        uni.showmodal({  
            title: '权限提示',  
            content: '需要您授权存储权限才能选择图片，请前往设置页面授权。',  
            success: (res) => {  
                if (res.confirm) {  
                    // 引导用户去设置页开启权限  
                    plus.android.requestpermissions(['android.permission.read_media_images'], /*...*/);  
                }  
            }  
        });  
    }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

3. 重要注意事项

• google play 上架要求：根据 google play 政策，如果应用核心功能不是图片/视频编辑器或频繁访问媒体文件，应当优先使用 android 照片选择器 (photo picker)，它无需权限。在 uni-app 中，你可以通过设置 albummode: 'system' 来尝试调用此选择器，但这需要 hbuilderx 4.28+ 版本支持，且在不同厂商设备上可能存在兼容性问题。如果使用 albummode: 'system'，则无需动态申请 read_media_images 权限。
• 鸿蒙 next (harmonyos next) 系统：在鸿蒙 next 上，情况完全不同。uni.chooseimage 使用的是系统的安全相册/安全相机机制，应用只能访问用户主动选择的图片，无需申请任何相册或媒体读取权限。
• 权限申请时机：应用商店（如小米、华为）审核要求“用户未使用相关功能时，不应提前申请权限”。因此，务必在用户点击“选择图片”按钮等实际操作时，再触发权限申请。
• 插件辅助：如果你希望更简单地处理权限申请目的说明和拦截逻辑，可以参考 dcloud 插件市场中的相关权限管理插件，例如 安卓权限申请、权限申请的使用目的。

总结来说，适配的关键是根据 android 版本动态申请对应的媒体权限（read_media_images 或 read_external_storage），在鸿蒙上则无需处理。