前言剪贴板是应用间数据传递的常用方式如复制文本、分享链接等。pura/harmony-utils的PasteboardUtil封装了剪贴板读写方法简化了剪贴板操作。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、PasteboardUtil核心APIPasteboardUtil提供了以下剪贴板操作方法方法说明返回类型使用场景setText(text)复制文本到剪贴板void复制功能getText()从剪贴板读取文本string粘贴功能hasText()剪贴板是否有文本boolean状态检测clear()清空剪贴板void隐私保护1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃状态检测支持检测剪贴板是否有内容1.2 剪贴板操作对照操作方法说明触发方式复制setText写入剪贴板用户点击粘贴getText读取剪贴板用户点击检测hasText检查内容自动检测清空clear清除内容主动清理二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 复制文本import{PasteboardUtil}frompura/harmony-utils;Button(复制文本).width(100%).onClick((){try{PasteboardUtil.setText(Hello harmony-utils!);this.result文本已复制到剪贴板 ;}catch(e){this.result异常: e;}})2.3 粘贴文本Button(粘贴文本).width(100%).onClick(async(){try{lettextawaitPasteboardUtil.getText();this.result剪贴板内容:\n${text||空};}catch(e){this.result异常: e;}})2.4 检查剪贴板Button(检查剪贴板).width(100%).onClick((){try{lethasPasteboardUtil.hasText();this.result剪贴板:${has?有内容 ✅:为空 ❌};}catch(e){this.result异常: e;}})三、完整页面示例import{PasteboardUtil,ToastUtil}frompura/harmony-utils;EntryComponentstruct PasteboardDemo{Stateresult:string;StateinputText:string;build(){Column({space:12}){TextInput({text:this.inputText}).onChange(vthis.inputTextv)Button(复制).width(100%).onClick((){PasteboardUtil.setText(this.inputText);ToastUtil.show(已复制);});Button(粘贴).width(100%).onClick(async(){lettextawaitPasteboardUtil.getText();this.resulttext||剪贴板为空;});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 一键复制组件import{PasteboardUtil,ToastUtil}frompura/harmony-utils;Componentstruct CopyableText{Proptext:string;build(){Row(){Text(this.text).layoutWeight(1)Text(复制).fontColor(#007DFF).onClick((){PasteboardUtil.setText(this.text);ToastUtil.show(已复制);})}}}4.2 邀请码复制functioncopyInviteCode(code:string):void{PasteboardUtil.setText(code);ToastUtil.showLong(邀请码已复制快去分享吧);}五、注意事项隐私安全剪贴板内容其他应用也可读取异步读取getText为异步方法需使用await内容限制剪贴板内容有大小限制初始化依赖使用前需确保AppUtil.init()已调用清空时机敏感信息使用后建议清空剪贴板六、常见问题Q1: getText()读取不到内容可能是其他应用未写入文本或剪贴板已被清空。Q2: 复制后其他应用粘贴不到检查是否成功写入部分系统对跨应用剪贴板有限制。Q3: 如何复制图片到剪贴板当前PasteboardUtil主要支持文本图片复制需要使用系统剪贴板API。Q4: 剪贴板内容会自动清除吗系统可能定期清除剪贴板内容建议及时使用。总结PasteboardUtil的剪贴板操作方法为应用间数据传递提供了便捷支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用剪贴板实现复制粘贴、分享链接等功能。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。