harmony-utils之PasteboardUtil，剪貼板工具類

harmony-utils 簡介與說明

[harmony-utils] 一款功能豐富且極易上手的HarmonyOS工具庫，借助眾多實用工具類，致力于助力開發者迅速構建鴻蒙應用。其封裝的工具涵蓋了APP、設備、屏幕、授權、通知、線程間通信、彈框、吐司、生物認證、用戶首選項、拍照、相冊、掃碼、文件、日志，異常捕獲、字符、字符串、數字、集合、日期、隨機、base64、加密、解密、JSON等一系列的功能和操作，能夠滿足各種不同的開發需求。
[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方法與使用

requestPermissions 申請剪貼板權限

PasteboardUtil.requestPermissions().then((result) = > {
  ToastUtil.showToast(`檢測并申請授權，允許應用讀取剪貼板：${result}`);
});

getSystemPasteboard 獲取系統剪貼板對象

let systemPasteboard = PasteboardUtil.getSystemPasteboard();

hasData 判斷系統剪貼板中是否有內容

let hasData = PasteboardUtil.hasDataSync();
ToastUtil.showToast(`系統剪貼板中是否有內容：${hasData}`);

setData 將數據寫入系統剪貼板

let text = "一款高效的OpenHarmony/HarmonyOS工具包。"
PasteboardUtil.setDataSync(pasteboard.MIMETYPE_TEXT_PLAIN, text);

getData 讀取系統剪貼板內容

let text = PasteboardUtil.getDataSync().getPrimaryText();
ToastUtil.showToast(`剪切板內容為：${text}`);

setDataText 將純文本數據寫入系統剪貼板

let text = "harmony-utils 一款高效的OpenHarmony/HarmonyOS工具包，封裝了常用工具類，提供一系列簡單易用的方法。"
PasteboardUtil.setDataText(text).then(() = > {
  ToastUtil.showToast("設置成功！");
})

getDataText 讀取系統剪貼板純文本內容

let str = await PasteboardUtil.getDataText();
ToastUtil.showToast(`剪切板內容為：${str}`);

setDataHtml 將HTML數據寫入系統剪貼板

let html = "< !DOCTYPE html >n" + "< html >n" + "< head >n" + "< meta charset="utf-8" >n" +
  "< title >HTML-PASTEBOARD_HTML< /title >n" + "< /head >n" + "< body >n" + "< h1 >HEAD< /h1 >n" +
  "< p >一個富文本< /p >n" + "< /body >n" + "< /html >";
PasteboardUtil.setDataHtml(html).then(() = > {
  ToastUtil.showToast("設置成功");
})

getDataHtml 讀取系統剪貼板HTML內容

let html = await PasteboardUtil.getDataHtml();
 ToastUtil.showToast(`剪切板內容為：${html}`);

setDataUri 將URI數據寫入系統剪貼板

let dataUri = 'dataability:///com.example.myapplication1/user.txt';
PasteboardUtil.setDataUri(dataUri).then(() = > {
  ToastUtil.showToast("設置成功");
})

getDataUri 讀取系統剪貼板URI內容

let uri = PasteboardUtil.getDataUriSync();
ToastUtil.showToast(`剪切板內容為：${uri}`);

setDataWant 將Want數據寫入系統剪貼板

let want: Want = {
  deviceId: 'device_666666',
  bundleName: 'com.example.myapplication',
  abilityName: 'FuncAbility',
  moduleName: 'entry'
};
PasteboardUtil.setDataWantSync(want);

getDataWant 讀取系統剪貼板Want內容

let want = PasteboardUtil.getDataWantSync();
if (want) {
  let jsonStr = JSON.stringify(want, null, 2);
  Utils.showSheetText(jsonStr);
}else {
  ToastUtil.showToast("剪切板內容為空，請先設置內容");
}

setDataPixelMap 將PixelMap數據寫入系統剪貼板

let pixelMap = await ImageUtil.getPixelMapFromMedia($r("app.media.test_as4"))
PasteboardUtil.setDataPixelMap(pixelMap).then(() = > {
  ToastUtil.showToast("設置成功");
});

getDataPixelMap 讀取系統剪貼板PixelMap內容

let pixelMap = PasteboardUtil.getDataPixelMapSync();
if (pixelMap) {
  Utils.showSheetImg(pixelMap);
} else {
  ToastUtil.showToast("剪切板內容為空，請先設置內容");
}

getDataStr 讀取系統剪貼板里的字符串

let str = PasteboardUtil.getDataStrSync();
ToastUtil.showToast(`剪切板內容為：${str}`);

getDataEasy 讀取系統剪貼板里的內容（純文本內容、HTML內容、URI內容、Want內容、PixelMap內容）

let data = PasteboardUtil.getDataEasy();
if (data && typeof data === 'string') {
  Utils.showSheetText(data);
} else if (data && typeof data === 'object') {
  if (typeof (data as PixelMap).getImageInfo === 'function') {
    Utils.showSheetImg(data as PixelMap);
  } else {
    Utils.showSheetText(JSON.stringify(data, null, 2));
  }
} else {
  ToastUtil.showToast("剪切板內容為空，請先設置內容");
}

clearData 清空系統剪貼板內容

PasteboardUtil.clearDataSync();
ToastUtil.showToast(`清空成功！`);

創作不易，請給童長老點贊

審核編輯 黃宇