《鸿蒙/Harmony | 开发日志》预览文件

news/2024/9/25 10:09:52

APP 中常有需求就是点击文件打开预览。

鸿蒙中，可以借助访问的预览文件服务来实现。

测试下来，常见的文档类型txt, doc, excel, ppt,pdf, 图片，视频等都是默认可以打开的。遇到不能打开的，界面也会按钮是否使用其他 APP 来打开。

支持的文件类型

官方文档列出的支持类型，实际测试下来，除了下面的列表，对doc, ppt, excel, pdf等文件都是直接支持的（没有安装过wps）。

遇到不支持的文件类型也没有关系，在预览不了的时候，界面有一个使用其他其他应用，或者保存本地的功能。

代码实现

将一个本地的文件，使用预览服务预览。注意这里的文件，必须是当前应用有权限获取的文件，无论是用户选择的文件，或者是 APP 下载的文件保存在 APP 本身的缓存目录中的。至于如何下载文件，是另一个篇幅的事情。本章节的是一个已经存在的本地文件。

预览文件的代码


// 本地真是存在的文件
const filePath = ""// 需要将文件转换成文件uri
const uri = fileUri.getUriFromPath(filePath)
// 当前文件是否支持预览。这一步可以省略。看个人需求，就算不支持也是可以打开预览界面的。
// 但是这里要注意的是确保文件路径一定要存在。如果上面的文件不存在，isCan也是false的
const isCan = await filePreview.canPreview(this.context.uiAbilityContext, uri)if(!isCan) {// todo: 不支持如何处理
}
// 根据文件的名称获取文件的MIMEType，方法实现见下文章节
const mimeType = getMimeTypeByFileName(fileName)let fileInfo: filePreview.PreviewInfo = {title: fileName,uri: uri,mimeType: mimeType
};const uiAbilityContext = getContext(this);filePreview.openPreview(uiAbilityContext, fileInfo).catch((err: BusinessError) => {this.alert({ message: `文件: ${fileName}, 无法预览，原因: ${err.message}` })
});

根据真实文件地址获取文件uri

文件uri是鸿蒙特色的为了隐藏真是文件地址设计的。一般遇到文件处理的时候，可以都会遇到文件地址和文件uri互相转换的过程。可以参考《【鸿蒙官方文档】用户文件uri介绍》

根据文件的后缀名获取MIMEType

因为文件预览服务是需要知道MIMEType的，官方提供了《如何通过文件后缀获取对应的MIMEType列表》，我们只需要获取后缀名，再调用官方 API 即可：

export function getExtension(filename: string, includeDot = false): string {const dot = '.'if (filename.lastIndexOf(dot) == -1) {return ""}const ext = filename.split(dot).pop()return includeDot ? "." + ext : ext
}export function getMimeTypeByFileName(name: string) {const ext = getExtension(name)return getMimeTypeByExtension(ext)
}export function getMimeTypeByExtension(ext: string) {if (!ext.startsWith(".")) {ext = "." + ext}let typeId = uniformTypeDescriptor.getUniformDataTypeByFilenameExtension(ext);let typeObj = uniformTypeDescriptor.getTypeDescriptor(typeId);let mimeTypes = typeObj.mimeTypes;return mimeTypes[0]
}