更新记录

1.0.7(2023-11-20)

添加支持SD卡和U盘文件

1.0.6(2022-10-17)

  1. 没有存储权限先提示授权,而不是直接调用获取权限;
  2. 修复指定文件后缀大小写不一致匹配不上问题。

1.0.5(2022-07-27)

修复 Android 11 版本以上只能选择媒体文件问题:添加了 android.permission.MANAGE_EXTERNAL_STORAGE 权限,manifest.json 文件里需要添加该权限,Android权限配置里找不到请切换源码视图添加。

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 ×

原生插件通用使用流程:

  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端,支持SD卡、U盘读取,界面简洁,支持多选、可控制数量,可根据文件后缀指定显示的文件类型。

调用示例

const plugin = uni.requireNativePlugin('GuoWei-SelectFileModule')
plugin.chooseFile(
    {
        count: 10,
        extension: ["docx", "xlsx", "pptx"],
        rootDirName: '根目录',
        themeColor: '#00ff00',
        folderIconColor: '#ff0000',
        fileIconColor: '#0000ff',
        showHiddenFiles: false
    }, 
    result => {
        console.log(result) // result 看下方“回调说明”
    }
)

参数说明

参数 类型 默认 是否必传 说明
count int 0 选择文件最大数量,0为不限制
extension array 指定文件后缀,如:["docx", "xlsx", "pptx"],默认不限制
rootDirName string 我的手机 根目录名称
themeColor string #4B9FFC 主题色
folderIconColor string #4B9FFC 文件夹图标颜色
fileIconColor string #BBCFFF 文件图标颜色
showHiddenFiles boolean false 是否显示隐藏文件

回调说明

{
    "code": 0, // 0-成功,1-用户取消,2-没有权限
    "files": [
        {
            "path": "/storage/emulated/0/.../a.xlsx", // 文件路径
            "url": "file:///.../a.xlsx", // 文件URL,可直接上传到服务器
            "name": "a.xlsx",
            "date": 1605402220000, // 最后修改时间,毫秒值 
            "size": 1000, // bytes
            "suffix": ".xlsx"
        },
        ...
    ]
}

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android.permission.READ_EXTERNAL_STORAGE android.permission.WRITE_EXTERNAL_STORAGE android.permission.MANAGE_EXTERNAL_STORAGE

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问