1. 开发四步曲

步骤1：写入数据

import pasteboard from '@ohos.pasteboard';
// 创建文本数据（跨设备同步）
let textData = pasteboard.createData(
  pasteboard.MIMETYPE_TEXT_PLAIN, 
  "跨设备粘贴测试"
);
// 创建仅本地数据（如URI）
let uriData = pasteboard.createUriData("file://internal/storage/image.jpg");
uriData.setLocalOnly(true); // 禁止跨设备同步

// 写入系统剪贴板
let sysPasteboard = pasteboard.getSystemPasteboard();
sysPasteboard.setData(textData);

步骤2：读取数据

sysPasteboard.getData().then((data) => {
  if (data.hasMimeType(pasteboard.MIMETYPE_TEXT_PLAIN)) {
    console.log("文本内容：" + data.getPrimaryText());
  } else if (data.hasMimeType(pasteboard.MIMETYPE_TEXT_URI)) {
    console.log("URI内容：" + data.getPrimaryUri());
  }
}).catch((err) => {
  console.error("读取失败：" + err.code);
});

步骤3：监听剪贴板变化

// 注册监听器
let listenerId = pasteboard.on('update', () => {
  console.log("剪贴板内容已更新！");
});

// 取消监听（页面销毁时）
pasteboard.off('update', listenerId); 

2. 避坑指南

• 权限缺失处理// config.json 添加权限 "reqPermissions": [{ "name": "ohos.permission.DISTRIBUTED_DATASYNC" }]首次跨设备同步需动态申请权限：requestPermissionsFromUser()
• 超量传输拦截跨设备数据>64KB时，setData() 返回错误码 201（建议压缩文本或分片传输）
• 生命周期管理// 监听应用前后台切换 appManager.on('activeStateChange', (state) => { if (state === 0) { // 进入后台 sysPasteboard.clear(); // 主动清除敏感数据 } });

3. 性能优化技巧

1. 预加载机制// 预测用户可能粘贴时提前加载 deviceManager.suspendDeviceSync(false); // 保持设备连接
2. 数据压缩策略import zlib from '@ohos.zlib'; let compressed = zlib.compressSync(textData); // GZIP压缩
3. 能耗控制屏幕关闭时暂停同步：power.on('screenState') 事件管理

4. 完整流程图解

设备A->>+分布式数据库： 加密写入数据
  分布式数据库-->>设备B： 推送变更通知
  设备B->>+分布式数据库： 请求数据
  分布式数据库-->>-设备B： 返回解密数据
  设备B->>UI： 渲染粘贴内容