UnitAuto

☀️ 机器学习单元测试平台

零代码、全方位、自动化 测试 方法/函数 的正确性、可用性和性能

使用文档 视频教程 在线体验

---

机器学习单元测试平台，零代码、全方位、自动化 测试 方法/函数 的正确性、可用性和性能。
腾讯 IEG(互动娱乐事业群)、WXG(微信事业群) 两大事业群多个部门的多个项目使用中。

已被 互联网教育智能技术及应用国家工程实验室 收录。 https://github.com/TommyLemon/UnitAuto/issues/15

特点优势

相比 JUnit, JTest, Mockito, Mockk 等一堆 Compiling testing 工具：
1.其它工具需要每个方法都写一大堆测试代码，需要开发成本、需要解决测试代码的 bug、业务代码更改后需要同步修改测试代码等；
UnitAuto 不需要写任何代码，直接读取方法的属性，自动注入参数，拿到返回值和类成员变量，机器学习自动化校验。

2.UnitAuto 这种 Runtime testing 工具无需 Mock 环境(Application, Context 等)，
更不用为 无法有效地 Mock 环境相关类、第三方登录未提供 Mock 支持 等而头疼，
只要被测方法满足 有 return 值、有 interface 回调、改变成员变量 field 这 3 点中至少一点就能测。

原理说明

被测项目不需要写任何单元测试代码（逻辑代码、注解代码等全都不要），
UnitAuto 会自动生成测试参数，并执行方法，拿到返回值等进行校验。
泛型、接口等自动模拟，异步执行方法自动记录回调过程，都是零代码。

UnitAuto-Admin 是类似 APIAuto 的机器学习零代码测试工具（查看、上传、执行、测试 后端项目中的方法等），
UnitAuto-Java 提供扫描所有方法、执行某个方法两个 API （主要引入 MethodUtil.java 这个类，里面已实现）。

通过扫描项目中的可访问的 package, class, method 来生成和导入测试用例

HTTP 远程调用被测服务/App，转至内部 构造/获取 实例来 invoke 动态执行方法

获取参数、成员变量等前后状态，拦截方法被调用过程并可视化展示

通过简单配置自动调整参数组合，拿到返回结果后通过 前后结果对比 或 机器学习校验模型 来自动断言

后端不再需要像以下示例一样编写和维护大量单元测试用例代码（逻辑代码、注解代码等）：

客户端可作为 HTTP Server 来为 UnitAuto 网页工具 提供远程调用的接口，效果同样：

示例项目

UnitAuto Java 后端 Server 在线 测试
APIJSON Java 后端 Server 在线 测试
UnitAuto Android 客户端 App 直接 下载 （第一次可能失败，返回报错 JSON，一般重试一次就可以）
APIJSON Android 客户端 App 直接 下载 （第一次可能失败，返回报错 JSON，一般重试一次就可以）

演讲视频

UnitAuto-机器学习自动化单元测试平台简介
https://www.bilibili.com/video/BV1Tk4y1R7Yo

UnitAuto-异步回调方法的零代码单元测试
https://www.bilibili.com/video/BV1kk4y1z7bW

集成到被测项目

Java 后端 Server

1.依赖 unitauto.jar

放到你 启动 Application 所在项目的 libs 目录，然后 Eclipse Add to Build Path 或 Idea Add as Library
https://github.com/TommyLemon/UnitAuto/tree/master/UnitAuto-Java-Demo/libs

2.依赖 unitauto-jar.jar

如果不打 jar/war 包，则可以跳过这个步骤。
依赖方式同步骤 1。
https://github.com/TommyLemon/UnitAuto/tree/master/UnitAuto-Java-Demo/libs
依赖后需要在 Application static 代码块 中初始化

    static {
        UnitAutoApp.init();
    }

3.提供接口给 UnitAuto 后台管理工具

Controller 提供两个 POST application/json 格式的 HTTP API，分别是

/method/list    动态扫描方法，可以单纯接收入参并转发到 MethodUtil.listMethod(String request)
/method/invoke  动态执行方法，可以单纯接收入参并转发到 MethodUtil.invokeMethod(String request, Object instance, Listener<JSONObject> listener)

参考 DemoController

4.配置环境相关类及自定义处理逻辑

拦截 MethodUtil 类中的 INSTANCE_GETTER, JSON_CALLBACK, CLASS_LOADER_CALLBACK 等 interface 的回调方法，
可以支持获取 Context 等环境相关类的实例、转 JSON 对象时过滤特定类、其它自定义逻辑处理，参考 DemoApplication

Android 客户端 App

1.依赖 UnitAuto-Apk

把 UnitAuto-Apk 导入到你项目 app moudule 所在目录，settings.gradle 中

include ':UnitAuto-Apk'

app moudule 目录，build.gradle 中

dependencies {
    api project(':UnitAuto-Apk')
}

2.初始化 UnitAuto

在 Application onCreate 方法 中初始化

    @Override
    public void onCreate() {
        super.onCreate();
        UnitAutoApp.init(this);
    }

3.提供 UnitAuto 管理界面入口

在 AndroidManifest.xml 中注册 UnitAutoActivity

<manifest ... >
    <application ... >
      
        <activity
            android:name="unitauto.apk.UnitAutoActivity"
            android:launchMode="singleInstance">
        </activity>
      
     </application>
</manifest>

可在你项目的任何界面新增一个按钮或其它形式的入口，仅 DEBUG 模式下展示

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onClick="onClickUnit"
        android:text="UnitAutoActivity"
        android:textAllCaps="false"
        />

参考 layout/activity_main

点击这个入口跳转到 UnitAutoActivity

    public void onClickUnit(View v) {
        startActivity(UnitAutoActivity.createIntent(this));
    }

参考 MainActivity

4.配置环境相关类及自定义处理逻辑

在 Application onCreate 方法 中配置，参考 Java 后端 Server 中 4.配置环境相关类及自定义处理逻辑

部署后台管理工具

可以直接下载源码解压后用浏览器打开 UnitAuto-Admin/index.html，建议用 Chrome 或 火狐 (Safari、Edge、IE 等可能有兼容问题)。
也可以直接访问官网的线上环境 http://apijson.cn/unit 或开发环境 http://apijson.org:8000/unit 。

点右上角设置项 "项目服务器地址 URL"，把输入框内基地址改为你主机的地址(例如 http://192.168.0.102:8080 )

右上角登录的默认管理员账号为 13000082001 密码为 123456，

然后点右上角设置项 "查看、同步方法文档"，确保被测项目已启动，然后一键导入项目中的方法。
等它完成后自动显示测试用例列表，点击列表项进去查看详情和手动测试，或者一键自动回归测试全部 方法/函数。

如果测试 Android/iOS App，需要保证 手机/平板 与 使用 UnitAuto-Admin 网页的电脑 连接同一个局域网，
如果使用 Android/iOS 模拟器，则一定都是在同一个局域网，并且可以用 http://localhost:端口 进行访问。



自动管理测试用例 这个功能 需要部署APIJSON后端，见
https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Java-Server

常见问题

1.无法访问接口

Chrome 90+ 对 CORS 请求禁止携带 Cookie 或 Chrome 80-89 强制 same-site Cookie 的策略导致
https://github.com/TommyLemon/UnitAuto/issues/11

2.没有生成文档

右上角设置项与被测服务实际配置不一致 等
Tencent/APIJSON#85

3.托管服务器访问不了

不能代理接口、不能展示文档、不能对断言结果纠错 等
https://github.com/TommyLemon/UnitAuto/issues/10

4.apijson.org 访问不了

管理后台网页改用 http://apijson.cn/unit ，托管服务地址改为 http://47.74.39.68:9090
https://github.com/TommyLemon/UnitAuto/issues/12

更多常见问题
https://github.com/TommyLemon/UnitAuto/issues

技术交流

关于作者

https://github.com/TommyLemon

QQ群聊

734652054（新）
607020115（旧）

如果有什么问题或建议可以 提ISSUE 或 加群，交流技术，分享经验。
如果你解决了某些bug，或者新增了一些功能，欢迎 贡献代码，感激不尽。

其它项目

APIJSON 腾讯零代码、热更新、全自动 ORM 库 🏆 后端接口和文档自动化，前端(客户端) 定制返回 JSON 的数据和结构

APIAuto 敏捷开发最强大易用的 HTTP 接口工具，机器学习零代码测试、生成代码与静态检查、生成文档与光标悬浮注释

APIJSON.NET C# 版 APIJSON ，支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite

apijson-go Go 版 APIJSON ，支持单表查询、数组查询、多表一对一关联查询、多表一对多关联查询 等

APIJSON-php PHP 版 APIJSON，基于 ThinkPHP，支持 MySQL, PostgreSQL, SQL Server, Oracle 等

apijson-php PHP 版 APIJSON，基于 ThinkPHP，支持 MySQL, PostgreSQL, SQL Server, Oracle 等

apijson-node 字节跳动工程师开源的 Node.ts 版 APIJSON，提供 nestjs 和 typeorm 的 Demo

uliweb-apijson Python 版 APIJSON，支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite 等

APIJSONParser 第三方 APIJSON 解析器，将 JSON 动态解析成 SQL

APIJSON-ToDo-Demo 一个简单的 todo 示例项目，精简数据，简化上手流程，带自定义鉴权逻辑

apijson-practice BAT 技术专家开源的 APIJSON 参数校验注解 Library 及相关 Demo

apijson-learn APIJSON 学习笔记和源码解析

持续更新

https://github.com/TommyLemon/UnitAuto/commits/master

我要赞赏

创作不易，右上角点 ⭐ Star 支持下本项目吧，谢谢 ^_^
https://gitee.com/TommyLemon/UnitAuto