如何让Android ACTION_OPEN_DOCUMENT_TREE向用户说明申请文件夹权限的原因？

方案1：申请全文件访问权限（优先推荐） #

Android 11及以上系统提供了MANAGE_EXTERNAL_STORAGE权限，获取该权限后可以直接读取SD卡任意路径的文件，完全不需要走SAF文件夹选择流程，只需要一次权限申请弹窗，你可以在申请前加自定义的多语言引导说明。

• 如果你应用的分发渠道以合作方预装、SD卡附带安装包为主，不需要上架Google Play，可直接使用该权限，没有额外限制
• 如果需要上架Google Play，你可以提交使用场景说明，面向少数民族扫盲的公益类应用基本都可以通过该权限的审核
• 权限申请代码示例：

if (Environment.isExternalStorageManager()) {
    // 已获取权限，直接读取BloomExternal文件夹
} else {
    Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
    Uri uri = Uri.fromParts("package", getPackageName(), null);
    intent.setData(uri);
    startActivityForResult(intent, REQUEST_MANAGE_STORAGE);
}

方案2：优化现有SAF流程适配低版本/定制ROM #

如果你无法申请MANAGE_EXTERNAL_STORAGE权限，可以针对现有SAF流程做优化，解决引导失效的问题：

1. 关于DocumentsContract.EXTRA_PROMPT不生效的问题：该参数仅在原生Android 13及以上的系统文件选择器中生效，低版本系统、第三方定制ROM大多没有实现该参数，没有通用兼容的解决方法
2. 引导页优化：不要使用固定按钮样式的示意图，改成通用引导，比如用大箭头指向屏幕底部区域，搭配简单的图标（比如对勾、点击的手势图标），不受系统版本按钮文字、样式变化的影响
3. 增加校验逻辑：用户选择文件夹返回后，先校验返回的URI是否对应BloomExternal文件夹，如果不匹配就重新发起SAF申请，避免用户误操作选到其他文件夹

方案3：调整文件夹存放路径规避SAF #

因为你是和合作方一起预制SD卡内容，可以把BloomExternal文件夹放到SD卡的公共媒体目录下，比如/Books/BloomExternal/，针对公共媒体目录的读取只需要申请普通的READ_EXTERNAL_STORAGE权限，不需要走SAF流程，权限申请弹窗更简单，引导成本更低。

你提到的「标记无保密文件夹免权限访问」的需求，目前原生Android系统没有提供对应机制，短期内无法实现。

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