更新记录

1.1.0（2024-05-10）

修复有些情况下“确定”按键不显示问题

1.0.9（2023-06-29）

添加英文适配，参数 lan：默认跟随系统，指定中文传 "zh_CN"，指定英文传 "en"

1.0.8（2023-06-02）

解决首次使用时，部分手机加载过慢问题。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

简介

本插件支持Android APP端，支持Android12，支持多选、指定文件扩展名、指定文件目录、搜索、排序。

权限说明

Android 11 以上需要添加权限：
android.permission.MANAGE_EXTERNAL_STORAGE
manifest.json -> 权限配置里找不到请切换源码视图添加。
使用该权限 targetSdkVersion 要设置为 30 以上

使用说明

1、获取插件

const plugin = uni.requireNativePlugin('GW-ChooseFileModule')

2、调用 chooseFile(options, callback) 方法

plugin.chooseFile(options, callback)

options参数说明

paths 参数说明

paths 参数是一个对象的数组，对象的结构如下：

callback 返回参数说明

选择成功后以 files 的形式传给页面，res = {files: [文件对象数组]}，文件对象数组的对象的结构如下：

调用示例

const plugin = uni.requireNativePlugin('GW-ChooseFileModule')
plugin.chooseFile(
    {
        // 非必填，选择文件最大数量
        count: 10,

        // 非必填，指定文件扩展名
        extension: ["docx", "xlsx", "pptx"],

        // 非必填，指定目录，可指定任意多个目录
        paths: [
            {
                deep: false, // deep为true表示扫描文件包含指定目录及以下的全部子目录，false表示只扫描指定目录下一级的文件
                path: 'Download' // 指定根目录下的相对目录，不用写根目录（/storage/emulated/0）
            },
            {
                deep: true,
                path: 'Documents'
            }
        ]
    },
    res => {
        console.log(res)
        /*
        返回示例
        {
            "files": [
                {
                     // 本地存储路径，uni 上传前面需要添加 file://
                    "path": "/storage/emulated/0/Download/a.xlsx",

                     // 文件名
                    "name": "a.xlsx",

                     // 最后修改时间(毫秒)
                    "lastModified": 1658113714000,

                    // 大小(Byte)
                    "size": 10049,

                     // 扩展名
                    "extension": "xlsx",

                    // mimeType
                    "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
                }
            ]
        }
        */
    }
)