Hypium-driver

简介

Hypium-driver提供HarmonyOS平台的UI自动化测试驱动，提供uitest的接口，驱动设备执行ui测试

使用指南

准备nodejs环境

请参考nodejs官网教程，准备nodejs环境，建议使用如下版本。

nodejs v20.11.1

安装hypium-js

使用npm全局安装hypium-driver安装包

npm install -g hypium-driver

如果只需要在指定工程中安装，可以移除-g选项

使用示例

以下示例仅包括设备的连接和断开，详细的设备驱动接口说明请参考本目录下的API文档

import { UiDriver } from "hypium-driver";

async function connectNoSn() {
    let driver = await UiDriver.connect( {} ); // 连接设备，创建driver对象，不指定设备默认连接hdc list targets识别的第一个设备
    await driver.disconnect(); // 断开设备连接
}

async function connectWithSn() {
    let driver = await UiDriver.connect( { deviceSn: "xxxxx" } ); // 连接设备，创建driver对象, 指定设备SN
    await driver.disconnect(); // 断开设备连接
}

API文档

您可以在安装hypium-driver后，在项目根目录node_modules > hypium-driver > api.md文件中查看详细的文档

隐私声明

Hypium-driver 不会收集涉及用户的测试用例相关信息，如用例名称、用例数量、执行日志、屏幕截图等。

Hypium-driver 会收集以下信息用于分析Hypium各功能在不同平台上的使用情况，从而针对性地优化我们的产品：

1. 执行设备的操作系统平台和版本号
2. 被测设备的型号以及鸿蒙系统版本
3. 被测应用的名称或包名
4. Hypium特性功能的触发时间和使用次数

所有Hypium收集的信息均为匿名数据，不包含可追踪用户的标识符。

关闭用户信息收集

您可以在项目根目录运行 npx hypium-driver telemetry disable 来停止收集Hypium运行相关用户信息。 您可以在项目根目录运行 npx hypium-driver telemetry enable 来开启收集Hypium运行相关用户信息。 您可以在项目根目录运行 npx hypium-driver telemetry status 来查看Hypium运行相关用户信息的收集状态。

完整的隐私协议请访问应用UI测试查看。