更新记录
1.3.0(2021-04-09)
增加了 IOS 端的文件预览查看支持。
1.2.0(2020-07-01)
新增一个 android 系统文件分享的接口。
优化了打开文件时,有部分安卓机,因文件浏览组件没加载完成,就打开文件而出现空白页面的情况。
新增了,打开文件时的回调数据,可以处理一些特殊情况问题。
查看更多
平台兼容性
Android
iOS
适用版本区间:4.4 - 11.0
适用版本区间:9 - 14
原生插件通用使用流程:
购买插件,选择该插件绑定的项目。
在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
开发完毕后正式云打包
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
已购买用户不受影响,可以正常打包使用。
Android 和 IOS 办公文件浏览查看器
支持打开文件格式:[ doc,docx,ppt,pptx,xls,xlsx,txt,pdf ], 只支持打开本地的文件,在线的文件需要下载后才能打开。
实例化插件:
const open=uni.requireNativePlugin("Html5App-openFile");
提示,
如果应用是第一次安装打开文件浏览时,有个别手机可能会加载不出,需要退出应用,关闭程序,二次打开才可以。(以前在部分华为手机上有过)
如果确实多次打开失败,可以调用系统文件打开,让用户选择在那个第三方APP中打开。
打开文件的方法:
open.openFile({filename:filepath},ret=>{
if(ret.code==-1) //文件浏览组件在加载中,请稍等
{
}
if(ret.code==-2) //文件浏览组件加载超时
{
}
if(ret.code==0) //打开文件成功
{
}
});
filename 参数:是文件的平台绝对路径,格式例如:
/storage/sdcard0/Android/data/io.dcloud.HBuilder/apps/HBuilder/doc/1.pdf
如果地址是以下这种相对地址的
_doc/download/06e43dddb107.pdf
就要使用 plus.io.convertLocalFileSystemURL(); 方法来转换下地址变成绝对路径, 例如:
var filePath=plus.io.convertLocalFileSystemURL("_doc/download/06e43dddb107.pdf");
变成绝对路径才可以正常打开浏览文件
/storage/sdcard0/Android/data/io.dcloud.HBuilder/doc/download/06e43dddb107.pdf
如需要把本地文件分享给其他好友,例如:QQ,微信 ,使用以下这个方法,这个方法只支持安卓
open.shareToFile({filename:filepath,title:"分享文件",fileType:"*/*"});
filename => 文件路径
title => 分享框上的文字提示
fileType => 文件类型 , 默认 / ,代表所有文件,例如:image/*.
扫一扫下载安卓DEMO 示例 体验