此需求为
h5 端请求接口得到包含 PDF 文件数据的 Base64 编码字符串
希望可以预览 PDF 文件,并且可以保存和分享
关于 Base64 编码
Base64 是一种用 64 个字符来表示任意二进制数据的方法。当你有一个 PDF 文件并希望在网络上
发送或在 JavaScript 中处理时,你可以将其转换为 Base64 字符串。这样做的好处是,Base64
字符串只包含 ASCII 字符,因此可以在任何地方使用,不会出现编码问题。
实现思路
h5 通过 js 和原生交互,将 Base64 编码字符串传递给原生,因为 uniap 未提供可以直接访问 base64 编码字符串的方法,所以原生需通过将编码信息写入原生新创建的 pdf 文件,再通过 uniapp 提供的 **uni.openDocument(OBJECT)
** 方法,新开页面打开文档
思路概述
uniapp 下将 base64 编码信息写入原生新创建的 pdf 文件,总结起来需要下面五个步骤
- 需要请求本地文件系统对象
- 创建或打开当前目录下指定的文件
- 获取文件关联的写文件操作对象 FileWriter
- 将数据写入文件
- 通过
uni.openDocument
打开文件
uniap api 缺陷
uni-app js 引擎版还不支持用
uni.getFileSystemManager()
获取全局唯一的文件管理器 ,可部分替代的方案是plus.io
编码实现
明确下 plus 下私有目录的作用
应用私有资源目录,对应常量 plus.io.PRIVATE_WWW,仅应用自身可读
应用私有文档目录,对应常量 plus.io.PRIVATE_DOC,仅应用自身可读写
所以应该使用 plus.io.PRIVATE_DOC 路径
- 对应Android系统应用内部存储目录(通常为
/storage/emulated/0/Android/data/%PACKAGENAME%/
,其中%PACKAGENAME%是程序的包名)下的“apps%APPID%/doc”
,其中%APPID%是应用的标识。 - 对应iOS系统应用沙盒目录下的
/Library/Pandora/apps/%APPID%/doc
,其中%APPID%是应用的标识。
注意,这个路径并不是当前 app 包下的 Caches 中
具体实现的代码如下
plus.io.requestFileSystem(plus.io.PRIVATE_DOC, function(fs) {
console.log(fs.root.fullPath)
const filePath = `$ {fs.root.fullPath}files/${Date.now()}.pdf`
fs.root.getFile(filePath, {
create: true
}, function(fileEntry) {
console.log('filePath' + filePath)
fileEntry.createWriter(function(writer) {
writer.onwrite = function() {
console.log('success filePath' + filePath)
uni.openDocument({
filePath: filePath,
showMenu: true,
success: () = > {
uni.hideLoading()
},
fail: (error) = > {
uni.hideLoading()
toast(error.message || '操作失败,请稍后再试')
}
})
}
writer.onerror = function(e) {
uni.hideLoading()
console.log('写入文件失败:' + e.message)
}
writer.writeAsBinary(base64)
}, function(e) {
uni.hideLoading()
console.log('创建文件写入对象失败:' + e.message)
})
}, function(e) {
uni.hideLoading()
console.log('获取文件失败:' + e.message)
})
}, function(e) {
uni.hideLoading()
console.log('请求文件系统失败:' + e.message)
})
其中 writer.writeAsBinary(base64)
接受一个二进制字符串,注意 base64 串无需 URI 前缀 data:application/pdf;base64,
fs.root.fullPath
为获取应用的沙盒路径
错误方案
在调研时,采用过 writer.write()
,write
方法接受一个 ArrayBuffer
或 Blob
对象
// 将 base64 数据转换为 ArrayBuffer 数据
let arrayBuffer = uni.base64ToArrayBuffer(base64Data);
...
writer.write(arrayBuffer)
但上述操作会出错,无法正确的写入数据,未进行深入的研究,放弃使用此方法