Android应用MANAGE_EXTERNAL_STORAGE权限致Play拒审修复方法

• Android 10（API 29）开始强制启用分区存储机制，targetSdkVersion 30的应用默认无权限直接读写外部存储公共目录（即你使用的Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)路径），仅持有READ/WRITE_EXTERNAL_STORAGE权限无法访问该路径下的文件。
• MANAGE_EXTERNAL_STORAGE属于高敏感全文件访问权限，Google Play仅允许核心功能必须遍历全设备文件的应用（如文件管理器、系统级备份工具）申请，普通PDF阅读/展示类应用申请该权限会直接触发拒审。
• 你使用的com.github.barteksc:android-pdf-viewer:2.8.2为多年未迭代的旧版本，未做分区存储适配，默认依赖直接文件路径读取外部存储的逻辑，因此移除全文件权限后会出现加载失败。

1. 清理违规权限与冗余配置 #

首先从AndroidManifest.xml中完全删除MANAGE_EXTERNAL_STORAGE权限声明，仅保留必要权限，同时关闭过时的旧版存储兼容标记：

<!-- 仅保留必要权限，API33及以上系统不需要申请旧版存储权限 -->
<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.INTERNET" />

<application
    <!-- 不要开启旧版存储兼容，target 30下该标记在Android11+设备上无效，还会触发合规风险 -->
    android:requestLegacyExternalStorage="false"
    ...>
    <!-- 其余组件声明不变 -->
</application>

2. 替换PDF文件存储路径 #

不要再使用外部存储公共目录存放应用自行下载的PDF文件，改为使用应用私有外部存储目录，该目录无需申请任何存储权限，应用可直接读写，完全符合分区存储规则：

// 替换原有公共目录获取逻辑
File pdfSaveDir = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS);
if (!pdfSaveDir.exists()) {
    pdfSaveDir.mkdirs();
}
// 下载的PDF文件直接存入该目录即可，示例：File downloadedPdf = new File(pdfSaveDir, "demo.pdf");

如果业务要求下载的PDF需要对系统文件管理器可见，通过MediaStore API或存储访问框架（SAF）写入公共目录即可，该流程无需全文件访问权限。

3. 适配PDF加载逻辑 #

你使用的PDF库本身支持从应用私有目录加载文件，将下载完成的私有目录下的PDF文件对象直接传入加载逻辑即可正常展示：

pdfView.fromFile(downloadedPdf)
        .defaultPage(0)
        .enableSwipe(true)
        .swipeHorizontal(false)
        .load();

如果上述操作后仍出现加载异常，直接将依赖升级到已适配分区存储的维护版本，替换原有2.8.2版本依赖即可，无需修改业务加载代码：

// 替换原有的com.github.barteksc:android-pdf-viewer:2.8.2依赖
implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'

4. 本地PDF加载场景合规处理 #

如果你的应用需要支持加载用户设备上存储的其他PDF文件，不要申请全文件访问权限，直接调用系统SAF文件选择器，让用户手动选择目标PDF文件，拿到系统返回的文件Uri后，通过ContentResolver获取ParcelFileDescriptor传入PDF库加载即可，该流程无需任何存储权限，完全符合Google Play政策要求。

内容的提问来源于stack exchange，提问作者abhilash kaveriappa