更新记录

1.0.7(2024-04-07)

兼容新系统

1.0.6(2022-03-14)

新增文件返回大小

1.0.5(2021-11-25)

修改ios字段错误问题引起选取文件类型失效

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 14.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 17

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


TX-File致力于一键实现轻松的文件功能

1.引入模块

const file = uni.requireNativePlugin('TX-File');

2.导入文件到本地

file.select({type:["public.data",
                                            "com.microsoft.powerpoint.ppt",
                                            "com.microsoft.word.doc",
                                            "com.microsoft.excel.xls",
                                            "com.microsoft.powerpoint.pptx",
                                            "com.microsoft.word.docx",
                                            "com.microsoft.excel.xlsx",
                                            "com.adobe.pdf",
                                            "public.avi",
                                             "public.3gpp",
                                             "public.mpeg-4",
                                             "com.compuserve.gif",
                                             "public.jpeg",
                                             "public.png",
                                             "public.plain-text"
                                        ],model:0},result=>{
                                console.log(result);
                                let localPath = plus.io.convertLocalFileSystemURL(result.filePath);
                                console.log(localPath);
                    })

函数参数说明

字段 说明
type 文件类型
model 整数类型 默认为UIDocumentPickerModeOpen(1)可以指定为UIDocumentPickerModeImport (0) UIDocumentPickerModeExportToService(2) UIDocumentPickerModeMoveToService(3)
savePath 本地保存路径(可选)可以指定保存路径

函数返回值说明

字段 说明
filePath 文件保存的完整路径
fileName 文件名称

3.打开文件

    file.select({type:["public.data",
                                            "com.microsoft.powerpoint.ppt",
                                            "com.microsoft.word.doc",
                                            "com.microsoft.excel.xls",
                                            "com.microsoft.powerpoint.pptx",
                                            "com.microsoft.word.docx",
                                            "com.microsoft.excel.xlsx",
                                            "com.adobe.pdf",
                                            "public.avi",
                                             "public.3gpp",
                                             "public.mpeg-4",
                                             "com.compuserve.gif",
                                             "public.jpeg",
                                             "public.png",
                                             "public.plain-text"
                                        ],model:1},result=>{
                                console.log(result);
                    })

函数参数说明

字段 说明
type 文件类型
model 整数类型 默认为UIDocumentPickerModeOpen(1)可以指定为UIDocumentPickerModeImport (0) UIDocumentPickerModeExportToService(2) UIDocumentPickerModeMoveToService(3)

函数返回值说明

字段 说明
filePath 文件保存的完整路径
fileName 文件名称

4.同步本地文件到云端

    var path = plus.io.convertLocalFileSystemURL('/static/html.pdf');
                console.log(path);
                file.select({filePath:[path],model:2},result=>{
                                console.log(result);
                    })

函数参数说明

字段 说明
filePath 数组字符串
model 整数类型 默认为UIDocumentPickerModeOpen(1)可以指定为UIDocumentPickerModeImport (0) UIDocumentPickerModeExportToService(2) UIDocumentPickerModeMoveToService(3)

函数返回值说明

字段 说明
filePath 文件保存的完整路径
fileName 文件名称

隐私、权限声明

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

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

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

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