更新记录

1.3.0(2021-04-09)

增加了 IOS 端的文件预览查看支持。

1.2.0(2020-07-01)

  • 新增一个 android 系统文件分享的接口。
  • 优化了打开文件时,有部分安卓机,因文件浏览组件没加载完成,就打开文件而出现空白页面的情况。
  • 新增了,打开文件时的回调数据,可以处理一些特殊情况问题。
查看更多

平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 适用版本区间:9 - 14

原生插件通用使用流程:

  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 和 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 示例 体验

隐私、权限声明

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

文件读取

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

无,不涉及收集用户的任何数据。

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

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