HarmonyKit | 鸿蒙新特性：cryptoFramework 异步加密哈希计算实战

引言：cryptoFramework 的异步哲学

HarmonyKit 的哈希计算工具是唯一使用 @kit.CryptoArchitectureKit 的工具。鸿蒙加密框架提供了完整的密码学原语——哈希、对称/非对称加密、数字签名。HashKit 只用到了 createMd 哈希接口，但足以展示鸿蒙加密 API 的核心设计模式：异步的 create → update → digest 三阶段流水线。

项目仓库：https://atomgit.com/VON-/harmony-kit

三阶段流水线

import { cryptoFramework } from '@kit.CryptoArchitectureKit';
import { buffer } from '@kit.ArkTS';

export class HashUtils {
  static async hash(input: string, algorithm: 'MD5' | 'SHA1' | 'SHA256'): Promise<string> {
    try {
      let md = cryptoFramework.createMd(algorithm);
      let uint8Array = new Uint8Array(buffer.from(input, 'utf-8').buffer);
      await md.update({ data: uint8Array });
      let result = await md.digest();
      return buffer.from(result.data).toString('hex');
    } catch (e) {
      return '计算失败: ' + (e as Error).message;
    }
  }
}

阶段一 createMd：创建指定算法的哈希实例。'MD5'、'SHA1'、'SHA256' 是 HarmonyKit 支持的三种算法。返回的 Md 对象是一个"哈希状态机"——初始化后等待数据输入。

阶段二 update：向状态机喂入数据。数据必须是 DataBlob 类型（包含 data: Uint8Array）。类型转换链：string → buffer.from(utf-8) → ArrayBuffer → Uint8Array。注意不能直接把 string 传给 update——会触发类型错误。

阶段三 digest：提取最终哈希摘要。返回 result.data 是 Uint8Array。用 buffer.from(result.data).toString('hex') 转换为十六进制字符串。

为什么必须是异步的

cryptoFramework 的底层实现可能使用专用安全硬件（TEE、Secure Enclave）或独立加密线程池。await 让调用方在等待硬件计算时继续执行其他任务。如果是同步 API，大文件哈希计算可能阻塞 UI 线程数秒。

三种算法选择

@State algorithm: string = 'MD5';

ForEach(['MD5', 'SHA1', 'SHA256'], (algo: string) => {
  Button(algo).fontSize(12).height(30)
    .backgroundColor(this.algorithm === algo ? '#007aff' : '#f0f0f0')
    .fontColor(this.algorithm === algo ? '#ffffff' : '#333333')
    .onClick(() => { this.algorithm = algo; });
});

• MD5（128位）：文件完整性快速校验。虽然密码学上已被攻破（碰撞攻击），但非安全场景仍足够
• SHA1（160位）：Git commit 哈希。Git 用户最熟悉的算法
• SHA256（256位）：安全场景——密码哈希、数字签名、区块链

三个互斥按钮，选中态蓝色填充。algorithm 参数使用字符串字面量联合类型（'MD5' | 'SHA1' | 'SHA256'），编译器在调用点就能验证合法性。

异步执行与 UI 响应

async doHash() {
  if (!this.input.trim()) return;
  let algo = this.algorithm as 'MD5' | 'SHA1' | 'SHA256';
  this.output = await HashUtils.hash(this.input, algo);
}

ArkUI 天然支持 Promise——按钮点击后 doHash 异步执行，UI 保持响应。as 类型断言因为 this.algorithm 类型是 string，但 hash() 期望精确字面量联合类型——断言的安全性由 UI 层三个互斥按钮的设计保证。

输出格式

哈希值始终以十六进制展示（而非 Base64）。十六进制是哈希的事实标准——所有在线工具、Git 日志、API 文档都使用十六进制哈希值。方便用户跨工具交叉验证。

项目仓库：https://atomgit.com/VON-/harmony-kit