用户指南（更新中）

6月28日修改

项目介绍

HttpRunner（简称 hrp）是一个基于 Apache-2.0 开源协议的自动化框架，诞生于 2017 年，最开始应用于 API 接口、性能测试，后面逐步进化为了一款通用、可拓展的测试框架。

在 2022 年，HttpRunner 开始新增支持 UI 自动化测试，当前已经支持了 Android/iOS/Harmony/Browser 多种系统平台，并在 v5 版本融入了大模型技术。​

HttpRunner 相比其它 UI 自动化框架，主要特点包括：

•
采用纯视觉驱动方案（OCR/CV/LLM），追求通用性和尽可能低的性能损耗​

•
多端统一 API，降低学习和横向拓展的成本​

•
拥抱开源生态，充分复用开源组件，支持在字节内外部使用​

•
Golang 技术栈，二进制分发部署，告别依赖管理噩梦​

安装说明

基础工具	安装命令行工具	安装 HttpRunner 二进制工具 hrp： install 查看命令行帮助： hrp -h
基础工具		环境变量配置	【可选】HttpRunner UI 操作依赖 OCR/CV 算法服务，需配置如下环境变量 VEDEM 【可选】如需使用大模型服务，需配置如下环境变量 LLM
环境依赖	Android 自动化	• 【必须】adb server 安装 adb 环境 • 【可选】uiautomator2 • 【可选】scrcpy：录屏功能（默认使用系统自带的 adb screenrecord 不带声音；如需同时录制音频，则需采用 scrcpy）安装 scrcpy 命令 hrp adb --help
		iOS 自动化	• 【必须】WDA • 【可选】ffmpeg：录屏功能 hrp ios --help 挂载 ios 开发者镜像启动 WDA
		鸿蒙自动化
		Browser 自动化
开发环境	JSON 用例编写	HttpRunner 支持采用 JSON/YAML 编写测试用例，并使用 hrp 命令执行。在此种情况下，系统无需安装 Golang 开发环境。
		GoTest 用例编写	HttpRunner 同时也支持采用 GoTest 的形式编写测试用例，此时需要安装 Golang 开发环境。 install go 推荐采用该种方式，可以实时获得语法提示，规避 JSON/YAML 用例格式容易写错的问题。

用户指南（更新中）​