使用`ACTION_OPEN_DOCUMENT_TREE`访问文件

基础概念

ACTION_OPEN_DOCUMENT_TREE 是 Android 系统提供的一个 Intent 动作，用于打开文件系统中的一个目录树，允许用户选择一个或多个目录。这个动作通常用于应用需要访问用户设备上的文件时，例如备份数据、导入文件等场景。

优势

用户授权：通过 ACTION_OPEN_DOCUMENT_TREE，应用可以获得用户明确授权的目录访问权限，而不是整个文件系统的访问权限，这有助于保护用户隐私。
灵活性：用户可以选择任意目录，应用可以根据用户的选择来决定如何处理这些文件。
安全性：与直接访问文件路径相比，使用 ACTION_OPEN_DOCUMENT_TREE 可以更好地遵守 Android 的权限模型，减少安全风险。

类型

ACTION_OPEN_DOCUMENT_TREE 是一个 Intent 动作，属于 Android 的内容提供者（Content Provider）框架的一部分。

应用场景

文件备份与恢复：应用需要访问用户设备上的特定目录来备份或恢复数据。
文件导入：应用需要用户选择文件或目录来导入数据。
文件共享：应用需要访问用户设备上的文件来与其他用户共享。

可能遇到的问题及解决方法

问题：无法启动 `ACTION_OPEN_DOCUMENT_TREE` 意图

原因：可能是由于权限不足或 Android 版本不支持。

解决方法：确保应用已经请求了 MANAGE_EXTERNAL_STORAGE 权限，并且在 Android 11 及以上版本中，需要在 AndroidManifest.xml 中声明 requestLegacyExternalStorage="true"。

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

在代码中请求权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        intent.setData(Uri.parse("package:" + getPackageName()));
        startActivityForResult(intent, REQUEST_CODE);
    }
}

问题：用户选择目录后无法访问

原因：可能是由于权限未正确处理或 Uri 解析错误。

解决方法：在 onActivityResult 中处理用户选择的目录 Uri，并确保应用具有适当的权限。

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        Uri treeUri = data.getData();
        if (treeUri != null) {
            // 保存 Uri 并请求权限
            int flags = Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION;
            getContentResolver().takePersistableUriPermission(treeUri, flags);
        }
    }
}