更新记录
0.2.4(2022-06-20)
添加跳到指定页面的方法,goToPage
0.2.3(2022-05-21)
提高恢复上一次查看位置准确性
0.2.2(2021-09-13)
1.横竖屏可配置,有的app不支持横竖屏,可以隐藏
查看更多平台兼容性
Android | iOS |
---|---|
× | 适用版本区间:11 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
``## 使用说明
-
1.利用iOS PDFKit开发的一款pdf阅读插件
-
2.目前本插件的功能有:pdf阅读,pdf目录, 缩略图预览。 支持自定义导航条文字颜色,-背景色,已经页面中悬浮的按钮颜色
-
3.使用方法:
// 本地址为测试地址,可能会失效,请实时更换
let url = 'http://www.wiwdd.com:8080/Dlib/books/file/ts/201706/57631/a_363fce1fe9fa47f1a7a88e252d4a50a6.pdf'//'这里放pdf的网络地址';
if(this.localUrl){
plus.io.resolveLocalFileSystemURL(this.localUrl,
(entry)=>{
jwPdfReader.showPdfUrl(entry.toLocalURL(),true,{title: 'pdf阅读器'})
},e=>{
})
return
}
uni.showLoading({
title:'加载中...'
})
uni.downloadFile({
url:url,
success: (res) => {
uni.showToast({
icon:'none',
title:'下载成功了',
})
if(res.statusCode == 200){
uni.saveFile({
tempFilePath: res.tempFilePath,
success:(res) => {
// res.savedFilePath
this.localUrl = res.savedFilePath
uni.hideLoading()
plus.io.resolveLocalFileSystemURL(res.savedFilePath,
(entry)=>{
// 第一个参数是文件在本地的url绝对路径
// 第二个参数是自动跳到上一次的阅读位置 false不会跳转
// 第三个参数为相关的配置 options
jwPdfReader.showPdfUrl(entry.toLocalURL(),true,{
title: 'pdf阅读器', // 导航标题文字
floatColor: '#333', // 浮动按钮颜色 默认灰色
navColor: '#fff', // 导航条背景颜色
tinkColor: '#333', // 导航条菜单文字颜色 默认灰色
adapte: true, // 是否适配底刘海屏 true 底部黑边 false 全屏到底
showOutlines: true, // 是否显示大纲菜单
orientation: false // 是否支持横竖屏,工程支持,否则设置了点击没反应
})
jwPdfReader.goToPage(20)
},e=>{
})
},
fail: () => {
uni.hideLoading()
uni.showToast({
icon:'none',
title:"下载失败"
})
}
})
}else{
uni.hideLoading()
uni.showToast({
icon:'none',
title:"下载失败"
})
}
},
fail: () => {
uni.hideLoading()
uni.showToast({
icon:'none',
title:"下载失败"
})
}
})
- 4.注意:因为PDFKit是iOS11之后才有的,所以最低支持iOS11版本。本阅读器是需要将文件缓存到本地,读取本地文件,需要开发人员自己做好本地资源的维护,建议只存储相对路径,否则覆盖安装app后可能会导致读不到之前存储的本地路径对应的文件,如果出现此问题,有可能就是路径问题导致。