Android：如何让AppData在DocumentsUI文件浏览器菜单中显示

要让你的应用在系统文件浏览器（如DocumentsUI）的抽屉菜单中显示，直接跳转至getExternalFilesDir(null)对应的AppData文件夹，需完成以下配置：

1. 配置Manifest核心属性 #

在<application>标签中添加两个关键属性，这是让系统识别并列出应用的核心：

• android:manageSpaceActivity：指定一个Activity作为存储管理入口，系统文件浏览器点击应用条目时会关联此组件
• android:hasFragileUserData="true"：标记应用包含需用户手动管理的重要数据，促使系统将其列入抽屉菜单

示例Manifest代码：

<application
    ...
    android:manageSpaceActivity=".StorageManageActivity"
    android:hasFragileUserData="true"
    ...>
    <!-- 其他组件配置 -->
</application>

2. 实现StorageManageActivity（可选但优化体验） #

指定的Activity可以直接引导用户进入应用的外部文件目录，无需额外操作。示例代码（Kotlin）：

class StorageManageActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 获取应用外部文件目录的Uri，为空则直接关闭页面
        val externalDir = getExternalFilesDir(null) ?: run {
            finish()
            return
        }
        // 构建目录对应的树Uri
        val treeUri = DocumentsContract.buildDocumentUriUsingTree(
            MediaStore.getExternalVolumeContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY),
            DocumentsContract.getTreeDocumentId(externalDir.toUri())
        )
        // 启动系统文件浏览器并定位到目标目录
        val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE).apply {
            putExtra(DocumentsContract.EXTRA_INITIAL_URI, treeUri)
        }
        startActivity(intent)
        finish()
    }
}

3. 权限说明 #

访问应用自身的getExternalFilesDir目录无需READ/WRITE_EXTERNAL_STORAGE权限，但如果需要系统文件浏览器完整展示目录内的媒体文件，可根据目标SDK版本添加对应权限（Android 13+使用READ_MEDIA_IMAGES等细分媒体权限）。

完成配置后，重启系统文件浏览器或设备，你的应用就会出现在抽屉菜单中，点击即可直接进入AppData目录进行文件管理。

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