彻底移除 Uniapp 云打包中的 READ_MEDIA_IMAGES/VIDEO 权限-平芜编程栈

引言

在使用 Uniapp 进行 Android 应用开发时，许多开发者会遇到一个棘手问题：云打包后自动添加了READ_MEDIA_IMAGES和READ_MEDIA_VIDEO权限。即便在配置文件中已明确移除，安装时仍会显示这些权限请求。本文将深入分析原因并提供完整解决方案。

一、问题根源分析

Uniapp 云打包自动添加这些权限通常源于以下原因：

SDK 或插件依赖：某些 Uniapp 原生插件或第三方 SDK 在集成时声明了媒体权限
编译策略：HBuilderX 在编译过程中会根据检测到的功能自动添加权限
Android 版本适配：Android 13+ 的权限策略变化导致权限自动添加

二、已验证的解决方案

1. 检查并清理插件依赖

首先排查是否由插件引起：

// 检查 package.json 和 manifest.json // 移除或替换包含媒体权限的插件 // 特别注意 camera、gallery、file-picker 等相关插件

2. 完整权限移除配置

在manifest.json中正确配置：

/* android打包配置 */"android" : {"excludePermissions" : ["<uses-permission android:name=\"android.permission.READ_MEDIA_IMAGES\"/>","<uses-permission android:name=\"android.permission.READ_MEDIA_VIDEO\"/>","<uses-permission android:name=\"android.permission.READ_MEDIA_AUDIO\"/>","<uses-permission android:name=\"android.permission.READ_MEDIA_VISUAL_USER_SELECTED\"/>"],}

3. 自定义 AndroidManifest.xml

创建原生配置文件夹：

在项目根目录创建nativeResources文件夹
创建nativeResources/Android/AndroidManifest.xml
添加以下内容：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android"> <!-- 移除不需要的权限 --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" tools:node="remove" /> <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" tools:node="remove" /> </manifest>

4. 彻底清理构建缓存

执行完整的清理流程：

# 1. 删除构建目录 rm -rf unpackage rm -rf platforms rm -rf plugins # 2. 清理 HBuilderX 缓存 # Windows: %APPDATA%/HBuilder X # macOS: ~/Library/Application Support/HBuilder X # Linux: ~/.config/HBuilder X # 3. 重新安装依赖 npm install # 4. 重新打包

三、高级排查方法

如果上述方法仍无效，可尝试：

1. 分析最终 APK

使用apkanalyzer或apktool解压 APK
检查AndroidManifest.xml最终版本
查找权限来源

2. 分模块排查

创建最小化测试项目
逐个添加插件，观察权限变化
定位具体引起问题的插件

3. 使用 Android Gradle 配置

在nativeResources/Android/build.gradle中添加：

android { compileSdkVersion 34 defaultConfig { minSdkVersion 21 targetSdkVersion 34 } // 移除重复权限 applicationVariants.all { variant -> variant.outputs.each { output -> output.processResources.doFirst { // 可在此处添加权限过滤逻辑 } } } }