📱 零代码快准稳 UI 智能录制回放平台 🚀
3 像素内自动精准定位,2 毫秒内自动精准等待,录制回放快、准、稳!
3 像素内自动精准定位,2 毫秒内自动精准等待,录制回放快、准、稳!
适用于 一次录制到处回放、反复回归界面操作、App UI/功能 自动化测试、
帮助开发快速复现和排查 bug、方便判断 bug 原因出在前端还是后端 等,
大量减少耗时费力又无聊的重复手工操作,大幅提高手工和自动化测试效率,
强力杜绝 测试和开发、前端和后端 关于缺陷单踢皮球等各种低效扯皮内耗!
用户包含腾讯,应微信团队邀请分享了 零代码测试工具与实践(API•单元•UI)
- 零代码 录制和回放 触屏、按键、键盘、数据 等
- 支持 16:9 标准屏、19.5:9 全面屏等各种设备屏幕
- 支持原生页面、内置 H5 网页、浏览器加载网页等
- 支持 Android 真机、Studio/Genymotion 等模拟器
- 单双指点击、长按、滑动、缩放各种像素级精细操作
- 自动精准等待、模拟 HTTP API 的请求和响应数据
- 不同机型录制回放偏差基本仅在 3 像素、2 毫秒 内
- 可从任意界面开始和停止录制、回放,绕过登录问题
- 可自动对关键步骤截屏,方便对比回放与录制差异
- 可自动和手动选择 View 及触摸区域、贴靠方式等
- 可保存录制步骤相关数据到后端数据库及从后端下载
- 可用管理端网页浏览检索用例和远程控制录制回放
- 附带 UnitAuto-机器学习零代码自动化单元测试
- 中文和英语双语文案,根据系统语言设置自动切换
相比各种 UI 录制回放/自动化测试 的 其它平台/工具/框架:
1.它们录制过程各种别扭难用反人类,甚至还需要开发/维护用例脚本、每个用例都写一大堆代码频繁部署等;
UIGO 不需要写任何代码,录制几乎是按和人正常操作完全一样的方式,操作简单易用,录制回放快、准、稳!
2.它们很难兼容各种不同宽高比分辨率屏幕,720P, 1080P 等 16:9 屏幕录制最多只能较好地在 16:9 屏幕回放,
即便手写代码或图像比对等也很难在列表项 View id/图标 重复控件精准定位,经常点错位置导致大量回放失败;
UIGO 则能很好地支持 16:9, 19.5:9 等各种不同屏幕录制,然后在 720P, 1080P, 2K, 1080X2340, 1440X3200
等各种 不同机型、不同系统、不同屏幕 基本都能很好地精准回放,偏差基本仅在相当于一根头发丝的 3 像素内!
3.它们要到处人为设置/调整操作步骤等待时间,还总是要么等太久、要么还没返回就过早执行下一步导致出错,
因为几乎无法保证网络请求在精准时间内返回,所以总是界面没加载完就滑动、弹窗没显示就点了"确定"位置等;
UIGO 则会自动精准等待 App 发送的各种 HTTP API 网络请求,偏差基本在 2 毫秒内,比眨眼一次还要快 50 倍,
像专业的测试工程师一样精准高效地等待数据和 UI 都加载好并执行 点击、长按、滑动、缩放 等每一步对应操作!
被测项目不需要写任何用例脚本代码(逻辑代码、注解代码、配置代码等全都不要),
UIGO 会自动录制 UI 触屏操作、虚拟+实体按键操作、HTTP API 网络请求与响应、
Activity, Fragment, Dialog, PopupWindow 等各种组件(控件)元素的生命周期 等,
回放时根据录制触摸点所在被分割球划分的 上、下、左、右、居中、等比 等区域
以及 屏幕分辨率、状态栏高度、导航栏高度、键盘高度 等来自动计算出回放触摸点,
再加上 id(如果有) 相同且距离最近的 View 区域来辅助微调,高度精准回放触屏操作!
对 返回按键、键盘按键 甚至 输入框编辑过程的每个变化的字符 也都能精准无误地还原!
UIGO Android 简单测试 App 直接 下载 (第一次可能失败,返回报错 JSON,一般重试一次就可以)
UIGO Android 复杂客户端 App 直接 下载 (第一次可能失败,返回报错 JSON,一般重试一次就可以)
其它申请的权限也尽可能都勾选授权,如果不能提前授权,则在使用时弹出是否申请权限弹窗后再确认授权
TommyLemon/APIAuto#61 (comment)
https://www.bilibili.com/video/BV1CK4218788
https://www.bilibili.com/video/BV1wA4m137ha
https://www.bilibili.com/video/BV1fH4y1E7gD
https://www.bilibili.com/video/BV1TK421C7y4
1.按业务 App 提供的方式打开 UIAuto 管理首页,例如 APIJSONApp 是登录后点击首页标题,UIAuto-Android 是点击首页 [自动 UI 测试] 按钮
2.点击 Record 录制按钮 > 点击顶部悬浮长条中间的 Record 录制 按钮开始录制 > 正常操作 App > 完成一个用例过程后,点击半透明圆形 〇 悬浮球完成录制
3.(可选)点击右下角 post 按钮上传录制的操作和数据等到后端数据库,可先编辑底部的后端服务器 HTTP URL Host 地址为你自己部署的 APIJSON 后端服务
1.按贴靠方式调整分割球位置及贴靠方式
按下(MotionEvent.ACTION_DOWN 事件)对应 View 的屏幕 [X, Y] 坐标位置前,必须先完成这步(如果已经配置正确则跳过)
分割球对应横纵两条分割线把屏幕分成了 左上、右上、左下、右下 4 个区域,对应数学上按坐标轴划分的 第 二、一、三、四 象限;
点击顶部控制条左上角 # 按钮可切换单双分割球,相比单分割球可更精细地设置高级属性
双分割球中间会出现一个长方形触控区域,默认点击位置按居中处理,可点击切换 center 居中, ratio 等比, top 靠上, bottom 靠下, left 靠左, right 靠右;
分割球本身贴靠方式可以点击分割球来切换 top_left 左上, top_right 右上, bottom_left 左下, bottom_right 右下, ratio 等比,
ratio_top 靠上并垂直纵向等比, ratio_bottom 靠下并垂直纵向等比, ratio_left 靠左并水平横向等比, ratio_right 靠右并水平横向等比
2.滑动要该快则快、该慢则慢
分页列表/网格等滑动尽量快速到底,保证不同宽高比分辨率屏幕上都能在同侧(↓ 从上往下、↑ 从下往上、→ 从左往右、← 从右往左)上显示一致;
点按内部 View 前可缓慢滑动保证目标出现在屏幕内,且手离开屏幕前先在同一位置稳住别动,保证不继续自动滚动(不同机型/系统对惯性滚动处理不一致导致偏差)
3.触控的 View 尽量都有 id,且尽量不要改动
UIGO 会对有 id 的被触控 View 在回放时进行微调触控位置(不改变 UI 布局,仅微调触屏输入坐标位置),灵活适配不同屏幕尤其是不同品牌机型的 UI 差异
4.最好开启托管服务器代理来录制 HTTP API 接口请求与响应流量,用于回放操作时同时回放数据
保证回放到某个步骤和录制到同一步骤时布局一致,不会触控点按错位
5.不要跳出 App,例如跳转外部浏览器或微信、支付宝等其它 App 来上网、登录、分享、支付等
目前不支持跨 App 录制回放,当前 App 外的对应事件录制不到也回放不了,打算后续支持对接支持跨 App 录制回放/自动化测试 的项目,
目前碰到这个问题要么避开,要么等待或手动点 》按钮跳过等待来直接继续执行下一步
1.参考 录制用例 1 来打开 UIAuto 管理首页 > 点击左下角 Remote 共享列表 按钮 > 点击打开其中一个和 App 及账号对应的用例,或者 录制用例 后直接进入用例详情界面
2.点击用例详情界面左下角 Replay 回放按钮,返回到用例对应开始录制的业务 App 界面,保证状态一致(都是刚进入后没有操作的界面,或者分页列表都下拉刷新过等)
3.点击顶部悬浮长条中间的 Replay 回放 按钮开始回放,观察每步操作前后,App 的 UI 展示、界面数据、界面跳转、弹窗显示、键盘输入等是否符合预期(和录制时表现一样)
1.回放开始时 App 初始状态必须和录制时一致
包括所在页面(最好都在首页)、列表/网格滚动距离(最好都是没滚动的初始值 0)、中英文等语言设置、字体大小和样式设置、缓存/调试等自定义配置 等
2.系统的中英文等语言、字体大小和样式 等设置尽可能保持一致
3.最好开启托管服务器代理来回放录制时的 HTTP API 接口请求与响应流量数据
可先跳过这个步骤,先下载体验 App 安装包,安装后 按以下 录制用例、回放用例 文档来操作
把 UnitAuto-Apk 导入到你项目 app moudule 所在目录,settings.gradle 中
include ':UnitAuto-Apk'
dependencies {
api project(':UnitAuto-Apk')
}
把 UIAuto 导入到你项目 app moudule 所在目录,settings.gradle 中
include ':UIAuto'
dependencies {
api project(':UIAuto')
}
在 Application onCreate 方法 中初始化
@Override
public void onCreate() {
super.onCreate();
UIAutoApp.STEP_TIMEOUT = 30*1000; // 一般为 HTTP API 网络请求超时时间 ms 毫秒值
UIAutoApp.getInstance().initUIAuto(this);
}
在 AndroidManifest.xml 中注册 UIAutoActivity
<manifest ... >
<application ... >
<activity
android:name="uiauto.UIAutoActivity"
android:label="@string/ui"
android:windowSoftInputMode="adjustPan"
android:configChanges="orientation|screenSize"
android:screenOrientation="portrait"
/>
<activity
android:name="uiauto.UIAutoListActivity"
android:label="@string/ui"
android:windowSoftInputMode="adjustPan"
android:screenOrientation="portrait"
/>
<activity
android:name="unitauto.apk.UnitAutoActivity"
android:label="@string/unit"
android:windowSoftInputMode="adjustPan"
android:configChanges="orientation|screenSize"
android:screenOrientation="userLandscape"
/>
</application>
</manifest>
可在你项目的任何界面新增一个按钮或其它形式的入口,仅 DEBUG 模式下展示
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:onClick="onClickUI"
android:text="UIAutoActivity"
android:textAllCaps="false"
/>
参考 layout/main_tab_activity
点击这个入口跳转到 UIAutoActivity
public void onClickUI(View v) {
startActivity(UIAutoActivity.createIntent(this));
}
在 HTTP API 发起请求处加上
UIAutoApp.getInstance().post(new Runnable() {
@Override
public void run() {
UIAutoApp.getInstance().onHTTPEvent(
action, type, method, host, url, headerStr, reqBodyStr, null, activity, fragment
);
}
});
在 HTTP API 响应结果处加上
UIAutoApp.getInstance().post(new Runnable() {
@Override
public void run() {
UIAutoApp.getInstance().onHTTPEvent(
- action, responseCode, method, host, url, headerStr, reqBodyStr, resBodyStr, null, activity, fragment
);
}
});
业务代码中如果使用了 android.app.AlertDialog,且录制回放用例涉及,则可以换成 uiauto.AlertDialog,
最简单的方式是顶部菜单 Edit > Find > Replace in files 全局搜索 import android.app.AlertDialog,
然后点搜索弹窗右下角 Replace All 按钮批量改为 import uiauto.AlertDialog。
如果因为用了自定义或第三方通用 Base Alert Dialog 不方便替换,则可以 extends uiauto.AlertDialog 或在里面加上:
@Override
public void show() {
super.show();
UIAutoApp.getInstance().onUIAutoDialogShow(this); // 通知已显示
}
// 拦截隐藏事件监听
private OnDismissListener listener;
@Override
public void setOnDismissListener(OnDismissListener listener) {
this.listener = listener;
}
private Activity context;
private void init(Context ctx) {
this.context = (Activity) ctx;
super.setOnDismissListener(new OnDismissListener() {
@Override
public void onDismiss(DialogInterface dialog) {
if (listener != null) {
listener.onDismiss(dialog);
}
UIAutoApp.getInstance().onUIAutoDialogDismiss(Dialog.this); // 通知已隐藏
}
});
}
// 每个可重写的构造方法都保证调用到 init 方法
public AlertDialog(Context context) {
super(context);
init(context);
}
public AlertDialog(Context context, @StyleRes int themeResId) {
super(context, themeResId);
init(context);
}
public AlertDialog(Context context, boolean cancelable, OnCancelListener cancelListener) {
super(context, cancelable, cancelListener);
init(context);
}
所有 Dialog, DatePickerDialog, TimePickerDialog, ProgressDialog, CharacterPickerDialog 等也同上处理。
业务代码中如果使用了 android.widget.PopupWindow,且录制回放用例涉及,则可以换成 uiauto.PopupWindow,
最简单的方式是顶部菜单 Edit > Find > Replace in files 全局搜索 import android.widget.PopupWindow,
然后点搜索弹窗右下角 Replace All 按钮批量改为 import uiauto.PopupWindow。
如果因为用了自定义或第三方通用 Base Popup Window 不方便替换,则可以 extends uiauto.PopupWindow 或在里面加上:
private android.widget.PopupWindow popupWindow;
private View view;
@Override
public void showAsDropDown(View anchor, int xoff, int yoff, int gravity) {
super.showAsDropDown(anchor, xoff, yoff, gravity);
if (view == null) {
try {
Field field = android.widget.ListPopupWindow.class.getDeclaredField("mPopup");
field.setAccessible(true);
popupWindow = (android.widget.PopupWindow) field.get(this);
// popupWindow.setOutsideTouchable(false);
Field dvField = android.widget.PopupWindow.class.getDeclaredField("mDecorView");
dvField.setAccessible(true);
view = (View) dvField.get(popupWindow);
if (view == null) {
View cv = popupWindow.getContentView();
view = cv == null ? null : cv.getRootView();
}
} catch (Throwable e) {
e.printStackTrace();
}
}
if (view == null) {
View cv = getContentView();
view = cv == null ? null : cv.getRootView();
}
Window w = getWindow();
// 通知已显示
UIAutoApp app = UIAutoApp.getInstance();
app.onUIAutoWindowCreate(w.getCallback(), w);
app.setCurrentPopupWindow(popupWindow, view, null, context, null);
}
// 拦截隐藏事件监听
private android.widget.PopupWindow.OnDismissListener listener;
@Override
public void setOnDismissListener(android.widget.PopupWindow.OnDismissListener listener) {
this.listener = listener;
}
public Window getWindow() {
Activity ctx = view == null ? null : (Activity) view.getContext();
if (ctx == null) {
ctx = context;
}
return ctx.getWindow();
}
private Activity context;
private void init(Context ctx) {
this.context = (Activity) ctx;
super.setOnDismissListener(new android.widget.PopupWindow.OnDismissListener() {
@Override
public void onDismiss() {
if (listener != null) {
listener.onDismiss();
}
Window w = getWindow();
// 通知已隐藏
UIAutoApp app = UIAutoApp.getInstance();
app.onUIAutoWindowDestroy(w.getCallback(), w);
app.setCurrentPopupWindow(null, null, null, context, null);
}
});
}
// 每个可重写的构造方法都保证调用到 init 方法
public PopupWindow(Context context) {
super(context);
init(context);
}
public PopupWindow(Context context, AttributeSet attrs) {
super(context, attrs);
init(context);
}
public PopupWindow(Context context, AttributeSet attrs, @AttrRes int defStyleAttr) {
super(context, attrs, defStyleAttr);
init(context);
}
public PopupWindow(Context context, AttributeSet attrs, @AttrRes int defStyleAttr, @StyleRes int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
init(context);
}
public PopupWindow(Context context, View contentView) {
super(contentView);
init(context);
}
public PopupWindow(Context context, int width, int height) {
super(width, height);
init(context);
}
public PopupWindow(Context context, View contentView, int width, int height) {
super(contentView, width, height);
init(context);
}
public PopupWindow(Context context, View contentView, int width, int height, boolean focusable) {
super(contentView, width, height, focusable);
init(context);
}
所有 ListPopupWindow 等也同上处理。
可先跳过,使用 https://apijson.cn:8080 或 https://apijson.cn:9090 代替
见 APIJSON-Demo 后端上手
https://github.com/APIJSON/APIJSON-Demo?tab=readme-ov-file#1%E5%90%8E%E7%AB%AF%E4%B8%8A%E6%89%8B
托管服务地址改为 https://47.98.196.224:8080
TommyLemon/APIAuto#13
更多常见问题
https://github.com/TommyLemon/APIAuto/issues
https://github.com/TommyLemon
如果有什么问题或建议可以 去 APIAuto 提 issue,交流技术,分享经验。
如果你解决了某些 bug,或者新增了一些功能,欢迎 提 PR 贡献代码,感激不尽。
APIJSON 🚀 腾讯零代码、全功能、强安全 ORM 库 🏆 后端接口和文档零代码,前端(客户端) 定制返回 JSON 的数据和结构
APIAuto 敏捷开发最强大易用的 HTTP 接口工具,机器学习零代码测试、生成代码与静态检查、生成文档与光标悬浮注释,集 文档、测试、Mock、调试、管理 于一体的一站式体验
UnitAuto 机器学习零代码单元测试平台,零代码、全方位、自动化 测试 方法/函数 的正确性、可用性和性能
SQLAuto 智能零代码自动化测试 SQL 语句执行结果的数据库工具,任意增删改查、任意 SQL 模板变量、一键批量生成参数组合、快速构造大量测试数据
Android-ZBLibrary Android MVP 快速开发框架,Demo 全面,注释详细,使用简单,代码严谨
https://github.com/TommyLemon/UIGO/commits/master
UIGO 从私有仓库默默开发了 3 年多到现在终于开源了,Apache 证书对商用和非商用都很友好。
创作不易、坚持更难,右上角点亮 ⭐ Star 支持/收藏下本项目吧,谢谢 ^_^
https://github.com/TommyLemon/UIGO