15 Star 95 Fork 23

TommyLemon / UnitAuto

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

UnitAuto

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

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

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


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

特点优势

相比 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.没有生成文档

右上角设置项与被测服务实际配置不一致 等
https://github.com/Tencent/APIJSON/issues/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(新)APIJSON-Free
607020115(旧)APIJSON-Fee

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

其它项目

APIJSON 腾讯零代码、热更新、自动化 ORM 库 🏆 后端接口和文档自动化,前端(客户端) 定制返回 JSON 的数据和结构
APIAuto 敏捷开发最强大易用的 HTTP 接口工具,机器学习零代码测试、生成代码与静态检查、生成文档与光标悬浮注释

持续更新

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

我要赞赏

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

Comments ( 4 )

Sign in for post a comment

About

机器学习单元测试平台,零代码、全方位、自动化 测试 方法/函数 的性能、正确性和可用性,由腾讯工程师开发 expand collapse
JavaScript and 4 more languages
Apache-2.0
Cancel

Releases

No release

UnitAuto

Contributors

All

Activities

load more
can not load any more
JavaScript
1
https://gitee.com/TommyLemon/UnitAuto.git
git@gitee.com:TommyLemon/UnitAuto.git
TommyLemon
UnitAuto
UnitAuto
master

Search

105716 1d94204e 1850385 105716 2d26be5c 1850385