更新记录
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 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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 |
文件名称 |