uniapp如何调用安卓原生接口打开文件管理器并获取用户选择的文件路径？

Question

在UniApp项目开发中，如何通过调用安卓原生接口实现打开文件管理器，并准确获取用户选择的文件路径？由于H5和小程序环境的限制，直接操作文件系统较为复杂，而安卓端可以通过JNI或Intent实现此功能。具体问题如下： 在UniApp中，使用`plus.android`对象调起安卓文件管理器时，如何正确配置Intent以确保兼容不同设备的文件管理应用？同时，在回调中如何解析返回的数据并提取完整的文件路径（如`/sdcard/example.txt`），而不是仅获取内容URI（如`content://...`）？此外，若目标设备运行Android 10及以上版本，如何应对Scoped Storage机制对文件路径获取的影响？

Answer 1

1. 问题概述与背景

在UniApp项目开发中，调用安卓原生接口实现文件管理器的打开，并准确获取用户选择的文件路径是一项常见的需求。然而，由于H5和小程序环境的限制，直接操作文件系统较为复杂。安卓端可以通过JNI或Intent实现此功能，但需要解决兼容性、回调解析以及Scoped Storage机制的影响等问题。

本章节将从以下几个方面展开：

• 如何正确配置Intent以确保兼容不同设备的文件管理应用。
• 如何解析返回的数据并提取完整的文件路径。
• Android 10及以上版本中Scoped Storage机制对文件路径获取的影响及解决方案。

2. Intent配置与兼容性处理

在UniApp中使用`plus.android`对象时，需通过Intent配置来调起安卓文件管理器。以下是关键步骤：

1. 创建Intent对象并设置其Action为`ACTION_OPEN_DOCUMENT`，这是推荐的方式，适用于Android 4.4及以上版本。
2. 指定文件类型（如`*/*`表示所有类型），以便用户可以选择任意类型的文件。
3. 添加必要的标志位，例如`FLAG_GRANT_READ_URI_PERMISSION`，以确保应用能够读取选中的文件。

以下是代码示例：

    function openFileManager() {
        const Intent = plus.android.importClass("android.content.Intent");
        const Uri = plus.android.importClass("android.net.Uri");

        let intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("*/*");
        intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

        const currentActivity = plus.android.runtimeMainActivity();
        currentActivity.startActivityForResult(intent, 100);
    }
    

3. 回调数据解析与完整路径提取

当用户选择文件后，安卓会通过`onActivityResult`方法返回结果。我们需要解析返回的URI并将其转换为完整路径：

步骤	描述
1	获取返回的Intent对象及其数据URI。
2	通过ContentResolver查询URI的真实路径。
3	根据查询结果构造完整文件路径。

以下是回调处理的代码示例：

    function onActivityResult(resultCode, data) {
        if (resultCode === 0) return;

        const uriString = data.getData().toString();
        const DocumentFile = plus.android.importClass("androidx.documentfile.provider.DocumentFile");
        const uri = plus.android.invoke(data, "getData");

        const documentFile = DocumentFile.fromSingleUri(plus.android.currentContext, uri);
        const filePath = getRealPathFromURI(uri);

        console.log("Selected File Path:", filePath);
    }

    function getRealPathFromURI(contentURI) {
        const cursor = plus.android.runtimeMainActivity().getContentResolver().query(
            contentURI,
            null,
            null,
            null,
            null
        );
        cursor.moveToFirst();
        const idx = cursor.getColumnIndex("_data");
        const path = cursor.getString(idx);
        cursor.close();
        return path;
    }
    

4. Scoped Storage机制的影响与应对策略

自Android 10开始，Google引入了Scoped Storage机制，限制了应用对共享存储的访问权限。这导致传统的路径解析方式可能失效。以下是应对策略：

• 优先使用`MediaStore` API访问媒体文件。
• 对于非媒体文件，继续使用`DocumentFile` API并借助`openInputStream`读取文件内容。

以下是流程图展示如何处理Scoped Storage：

graph TD;
            A[检查Android版本] --> B{版本>=10?};
            B --是--> C[使用DocumentFile API];
            B --否--> D[传统路径解析];
            C --> E[读取文件内容];
            D --> F[返回完整路径];