如何在Android中配置使应用沙箱化DOCUMENTS子文件夹开放用户访问？

问题背景 #

默认情况下，iOS和Android应用均可将文件下载至专属沙箱子目录，但这些文件对用户隐藏，仅应用自身可访问。
在iOS中，只需在info.plist中添加UIFileSharingEnabled和LSSupportsOpeningDocumentsInPlace两个键，就能让应用的/apps/MyApp/Documents目录以符号链接形式显示在iPhone的Files应用On My iPhone --> MyAppFolder路径下，实现文件对用户可见。

当前Android端采用直接写入Downloads文件夹（依赖externalRootDirectory）的方式，但该方式依赖非全设备通用的条件，且未来存在被系统收回权限的风险。

核心问题：Android是否有类似iOS的配置或方法，可让应用沙箱化文件夹对用户开放？若有，需进行哪些配置或操作？

解决方案 #

Android提供了多种符合沙箱安全机制的实现方式，以下是两种最常用的方案：

1. Android 11+ 专属：声明可访问的沙箱目录 #

Android 11及以上版本支持直接将应用沙箱内的特定目录暴露给用户，无需额外权限，完全基于系统沙箱机制：

• 在AndroidManifest.xml的<application>标签内添加FileProvider配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

• 新建res/xml/file_paths.xml文件，指定要开放的沙箱子目录（以应用内的documents目录为例）：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="my_app_public_docs" path="documents/" />
</paths>

• 配置完成后，用户可通过系统文件管理器的应用分类找到你的应用，进入后即可访问指定的沙箱目录（路径示例：文件管理器 → 我的文件 → 应用 → 你的应用名称 → my_app_public_docs）。

2. 跨版本兼容：通过MediaStore暴露沙箱文件 #

如果需要兼容Android 10及以下版本，可将沙箱内的文件通过MediaStore插入系统媒体库，让文件显示在Downloads文件夹的子目录中：

• 无需申请WRITE_EXTERNAL_STORAGE权限（Android 10+），示例Kotlin代码如下：

val targetFileName = "sample.pdf"
val contentValues = ContentValues().apply {
    put(MediaStore.Downloads.DISPLAY_NAME, targetFileName)
    put(MediaStore.Downloads.MIME_TYPE, "application/pdf")
    put(MediaStore.Downloads.RELATIVE_PATH, "Download/MyAppFiles")
}

// 获取插入后的URI并写入文件
context.contentResolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, contentValues)?.let { uri ->
    context.contentResolver.openOutputStream(uri)?.use { outputStream ->
        // 将应用沙箱内的文件复制到该输出流
        File(context.filesDir, "documents/$targetFileName").inputStream().copyTo(outputStream)
    }
}

• 这种方式下，文件会出现在系统Downloads文件夹的MyAppFiles子目录中，用户可直接查看和操作。

注意事项 #

• 优先选择第一种方案（Android 11+专属），因为它完全基于应用沙箱，无需依赖外部存储权限，安全性更高，且不受未来系统权限变更影响。
• 若需兼容旧版本，第二种方案是可靠的跨版本实现方式。

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