ZOLOZZOLOZDOCS

接入ZOLOZ HarmonyOS SDK

本文介绍手动接入ZOLOZ HarmonyOS SDK的完整流程。

前提条件

在接入ZOLOZ HarmonyOS SDK之前，请确保您使用的开发工具为DevEco Studio 5.0.5及以上版本。

适用产品

ZOLOZ HarmonyOS SDK支持以下产品：

  • RealID
  • ID Recognition
  • Face Capture
  • Connect

接入步骤

步骤1：下载并安装SDK

  1. 打开ZOLOZ鸿蒙仓库。
  2. 选择需要集成的zolozkit版本（推荐使用最新版本），并下载对应的zolozkit.har包。
  3. 将下载的SDK文件（.har）拖拽到您工程的libs目录中。
    image
  4. 在您需要集成SDK的模块下，找到oh-package.json5文件，添加以下依赖配置。
copy
{
    "dependencies": {
      // 请将./libs/zolozkit.har替换为zolozkit.har所在的实际目录
        "zolozkit": "file:./libs/zolozkit.har"
    }
}

image

步骤2：验证har是否引入成功

在oh-package.json5中配置依赖并同步工程后，建议在项目中添加以下测试代码。如果能正常获取metainfo字符串，说明SDK已成功引入。

copy
// 导入ZOLOZ
import { ZolozFacade } from "zolozkit";

// 测试调用ZolozFacade getMetaInfo
const metainfo = ZolozFacade.getMetaInfo();

步骤3：启动ZOLOZ SDK

运行以下代码导入SDK并启动认证流程：

copy
// 导入ZOLOZ
import { ZolozFacade, ZolozRequest, ZolozResponse, ZLZResponseCode } from "zolozkit";

// 构造请求
const request = new ZolozRequest(clientCfg, { rsaPubKey });

// 启动SDK
const response: ZolozResponse = await ZolozFacade.getInstance().startWithRequest(getContext(this), request);

// 根据结果码处理后续逻辑
if (response.code === ZLZResponseCode.Interrupt) {
  // 用户退出或系统中断，SDK内部已弹框提示
} else {
  // 流程正常结束，请调用后端checkResult API获取交易结果（交易结果以后端服务为准）
}