HarmonyOS 5.0 分布式数据协同与跨设备同步

大家好，我是 V 哥。使用 Mate 70有一段时间了，系统的丝滑使用起来那是爽得不要不要的，随着越来越多的应用适配，目前使用起来已经和4.3的兼容版本功能差异无碍了，还有些纯血鸿蒙独特的能力很是好用，比如，隔空取物，碰一碰分享图片和视频，多设备协同与跨设备同步数据真的太方便了，那对于开发者而言，数据协同与跨设备同步应该如何实现呢？今天 V 哥的文章就来分享这个神奇的功能。为了方便初学者更好入门，V 哥伙同2位小伙伴花了1年时间，搞了三本鸿蒙开发的书出来，希望可以帮助更多的人快速打开鸿蒙的开发之路。

要实现数据协同和跨设备同步，通常我们需要这三个技术点：

基于DistributedDataManager的实时数据同步机制
分布式数据库（RelationalStore）的冲突解决策略
设备间数据安全传输的HMACSHA256加密实践

下面，V 哥将一一给大家来介绍。

第一个技术点，DistributedDataManager用于跨设备数据同步

一、基于 DistributedDataManager 的实时数据同步

实现代码：

import distributedData from **********';
import deviceManager from **********';

@Entry
@Component
struct DistributedSyncDemo {
  private kvManager: distributedData.KVManager;
  private kvStore: distributedData.KVStore;
  private deviceId: string = ""; // 目标设备ID

  async aboutToAppear() {
    // 1. 初始化设备发现
    let devices = await deviceManager.getTrustedDeviceListSync();
    this.deviceId = devices[0].deviceId;

    // 2. 创建KVManager
    const context = getContext(this);
    this.kvManager = distributedData.createKVManager({
      context,
      bundleName: 'com.example.demo'
    });

    // 3. 创建KVStore
    this.kvStore = await this.kvManager.getKVStore('myStore', {
      createIfMissing: true,
      encrypt: false,
      backup: false,
      autoSync: true // 开启自动同步
    });

    // 4. 注册数据监听
    this.kvStore.on('dataChange', distributedData.SubscribeType.SUBSCRIBE_TYPE_ALL, (data) => {
      console.log(`数据变更：key=${data.key}, value=${data.value}`);
    });
  }

  // 写入数据并同步
  async putData(key: string, value: string) {
    await this.kvStore.put(key, value);
    await this.kvStore.sync(this.deviceId, distributedData.SyncMode.PUSH);
  }

  build() {
    Column() {
      Button('同步数据')
        .onClick(() => {
          this.putData('username', 'Alice');
        })
    }
  }
}

注意事项：

设备发现：需先调用 deviceManager.getTrustedDeviceListSync() 获取已认证设备列表
权限声明：在 module.json5 中添加：

"requestPermissions": [
  "ohos.permission.DISTRIBUTED_DATASYNC"
]

同步策略：SyncMode.PUSH 为单向推送，PULL 为拉取，PUSH_PULL 为双向同步
性能优化：高频数据更新建议使用批处理 putBatch()

第二个技术点是RelationalStore的冲突解决

二、分布式数据库冲突解决策略

实现代码：

import relationalStore from **********';

@Entry
@Component
struct DistributedDBDemo {
  private db: relationalStore.RdbStore;

  async aboutToAppear() {
    // 1. 配置数据库
    const config = {
      name: 'mydb.db',
      securityLevel: relationalStore.SecurityLevel.S1,
      encrypt: true
    };

    // 2. 设置冲突解决策略
    const storeConfig: relationalStore.StoreConfig = {
      conflictResolution: relationalStore.ConflictResolutionPolicy.LAST_WIN // 最后写入胜利
    };

    // 3. 创建数据库连接
    this.db = await relationalStore.getRdbStore(getContext(this), config, storeConfig);

    // 4. 创建表
    await this.db.executeSql(
      `CREATE TABLE IF NOT EXISTS user (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL UNIQUE ON CONFLICT REPLACE,
        age INTEGER
      )`
    );
  }

  // 插入冲突数据
  async insertUser(name: string, age: number) {
    const value = {
      'name': name,
      'age': age
    };
    try {
      await this.db.insert('user', value);
    } catch (err) {
      console.error(`冲突处理：${err.message}`);
    }
  }

  build() {
    Column() {
      Button('插入冲突数据')
        .onClick(() => {
          this.insertUser('Alice', 30); // 当name重复时触发REPLACE策略
        })
    }
  }
}

注意事项：

冲突策略类型：• ON CONFLICT ROLLBACK：回滚事务• ON CONFLICT ABORT：中止操作• ON CONFLICT REPLACE：替换旧数据
分布式事务：跨设备操作需使用 beginTransaction()/commit()
索引优化：对高频查询字段添加索引提升性能

第三个技术点是使用HMACSHA256进行加密传输

三、HMACSHA256 加密传输

实现代码：

import cryptoFramework from **********';

@Entry
@Component
struct SecureTransferDemo {
  private key: cryptoFramework.SymKey; // HMAC密钥

  async initKey() {
    // 1. 生成HMAC密钥
    let keyGen = cryptoFramework.createSymKeyGenerator('SHA256');
    this.key = await keyGen.generateSymKey();
  }

  // HMAC签名
  async signData(data: string): Promise<Uint8Array> {
    let mac = cryptoFramework.createMac('SHA256');
    await mac.init(this.key);
    await mac.update(new Uint8Array(new TextEncoder().encode(data)));
    return await mac.doFinal();
  }

  // 验证签名
  async verify(data: string, signature: Uint8Array): Promise<boolean> {
    let newSign = await this.signData(data);
    return JSON.stringify(newSign) === JSON.stringify(signature);
  }

  async transferData() {
    await this.initKey();
    const rawData = 'Sensitive Data';
    
    // 生成签名
    const signature = await this.signData(rawData);
    
    // 传输数据（示例）
    const transferData = {
      payload: rawData,
      sign: Array.from(signature)
    };

    // 接收端验证
    const isValid = await this.verify(transferData.payload, new Uint8Array(transferData.sign));
    console.log(`验证结果：${isValid}`);
  }

  build() {
    Column() {
      Button('安全传输')
        .onClick(() => {
          this.transferData();
        })
    }
  }
}

注意事项：