harmony-utils之PreviewUtil，文件預(yù)覽工具類

harmony-utils 簡介與說明

[harmony-utils] 一款功能豐富且極易上手的HarmonyOS工具庫，借助眾多實用工具類，致力于助力開發(fā)者迅速構(gòu)建鴻蒙應(yīng)用。其封裝的工具涵蓋了APP、設(shè)備、屏幕、授權(quán)、通知、線程間通信、彈框、吐司、生物認證、用戶首選項、拍照、相冊、掃碼、文件、日志、異常捕獲、字符、字符串、數(shù)字、集合、日期、隨機、base64、加密、解密、JSON等一系列的功能和作，能夠滿足各種不同的開發(fā)需求。
[picker_utils] 是harmony-utils拆分出來的一個子庫，包含 PickerUtil、PhotoHelper、ScanUtil。

下載安裝
ohpm i @pura/harmony-utils
ohpm i @pura/picker_utils

//全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init()
 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
   AppUtil.init(this.context);
 }

API方法與使用

generatePreviewInfo 根據(jù)文件uri構(gòu)建PreviewInfo

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
 FileUtil.writeEasy(docPath, "harmony-utils 一款高效的OpenHarmony/HarmonyOS工具包。幫助開發(fā)者快速構(gòu)建鴻蒙應(yīng)用。");
 let uri = FileUtil.getUriFromPath(docPath);
 let info = PreviewUtil.generatePreviewInfo(uri);
 let infoStr = JSON.stringify(info, null, 2);
 LogUtil.error(infoStr);

openPreview 通過傳入文件預(yù)覽信息，打開預(yù)覽窗口。1秒內(nèi)重復(fù)調(diào)用無效

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
 let uri = FileUtil.getUriFromPath(docPath);
 let info = PreviewUtil.generatePreviewInfo(uri);
 PreviewUtil.openPreview(info).catch((error: BusinessError) = > {
  LogUtil.error(`onSharePreview-異常 ~ code: ${error.code} -·- message: ${error.message}`);
 });

openPreviewEasy 通過傳入文件的uri，打開預(yù)覽窗口。1秒內(nèi)重復(fù)調(diào)用無效

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
 let uri = FileUtil.getUriFromPath(docPath);
 PreviewUtil.openPreviewEasy(uri);

canPreview 根據(jù)文件的uri判斷文件是否可預(yù)覽

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
 let uri = FileUtil.getUriFromPath(docPath);
 let canPreview = await PreviewUtil.canPreview(uri);
 ToastUtil.showToast(`canPreview: ${canPreview}`);

hasDisplayed 判斷預(yù)覽窗口是否已經(jīng)存在

let hasDisplayed = await PreviewUtil.hasDisplayed();
 ToastUtil.showToast(`hasDisplayed: ${hasDisplayed}`);

closePreview 關(guān)閉預(yù)覽窗口，僅當(dāng)預(yù)覽窗口存在時起效

PreviewUtil.closePreview().then(() = > {
  ToastUtil.showToast("已關(guān)閉預(yù)覽");
});

loadData 加載預(yù)覽文件信息。僅當(dāng)預(yù)覽窗口存在時起效

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
let uri = FileUtil.getUriFromPath(docPath);
let info = PreviewUtil.generatePreviewInfo(uri);
let hasDisplayed = await PreviewUtil.hasDisplayed();
if (hasDisplayed) {
  PreviewUtil.loadData(info);
} else {
  PreviewUtil.openPreview(info);
}

loadDataEasy 加載預(yù)覽文件信息。僅當(dāng)預(yù)覽窗口存在時起效

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
let uri = FileUtil.getUriFromPath(docPath);
let hasDisplayed = await PreviewUtil.hasDisplayed();
if (hasDisplayed) {
  PreviewUtil.loadDataEasy(uri);
} else {
  PreviewUtil.openPreviewEasy(uri);
}

onSharePreview 調(diào)用其他應(yīng)用預(yù)覽文件

let docPath = FileUtil.getFilesDirPath("download/wps/doc', "測試DOC文件.doc");
let uri = FileUtil.getUriFromPath(docPath);
PreviewUtil.onSharePreview(uri).catch((error: BusinessError) = > {
  ToastUtil.showToast("打開文件失敗，" + error.message);
  LogUtil.error(`onSharePreview-異常 ~ code: ${error.code} -·- message: ${error.message}`);
});

getTypeDescriptor 根據(jù)文件后綴名獲取TypeDescriptor（標(biāo)準(zhǔn)化數(shù)據(jù)類型的描述類）

let typeDescriptor = PreviewUtil.getTypeDescriptor("png");
ToastUtil.showToast(`${typeDescriptor.mimeTypes}`);

getMimeType 根據(jù)文件后綴名獲取文件mimeType

let mimeType = PreviewUtil.getMimeType("png");
let mimeType2 = PreviewUtil.getMimeType("txt");
ToastUtil.showToast(`${mimeType} --- ${mimeType2}`);

getIconFileStr 根據(jù)文件后綴名獲取對應(yīng)文件類型的圖標(biāo)

let iconFileStr = PreviewUtil.getIconFileStr("doc");
let iconRes: Resource = $r(iconFileStr);

canIUsePreview 判斷當(dāng)前設(shè)備是否支持文件預(yù)覽能力

let bl = PreviewUtil.canIUsePreview();
 ToastUtil.showToast(`當(dāng)前設(shè)備是否支持文件預(yù)覽能力:${bl}`);

創(chuàng)作不易，請給童長老點贊

審核編輯 黃宇