LianjiaTech / flutter_ui_auto_test

贝壳 flutter UI 自动化测试

（Android&iOS）UI自动化框架中，为混合型或纯flutter UI自动化提供便捷的能力。 详细原理可参考：Flutter UI测试自动化原理与实践

环境：

python环境：python3
XX：

快速使用

Dart测项目配置

1. 在Flutter工程的yaml文件中依赖本库
2. 在项目的main()函数入口增加启动FutService的代码，如下所示。

void main(){
	runApp(...);
	
	// 这个服务提供了自动化测试运行时的操作页面元素的能力
	// port：该服务占用系统端口号
	// 初始化至少要放在runApp()的后面
	// 如果App中有两个Flutter容器，port端口号也要不同
	FutService.initService(port: 1234);
}

**注意：**本库提供的能力基于AspectD hook系统能力来实现，所以在项目中需要配置AspectD能力。使用见(https://github.com/LianjiaTech/Beike_AspectD)

获取页面元素

本项目中提供一个FutConfigPage的配置页面，这个页面可以开启flutter UI自动化测试获取元素ID的配置，可以在合适入口处打开。建议用Native能力写一个全局悬浮弹窗。

1. 执行python/flutter_weditor.py ，可在控制台查看到当前IP
2. 手机端从“悬浮窗”入口进入FutConfigPage配置页面
3. 将控制台IP输入，点击连接，此时即与Service端建立连接
4. 点击底部“开启”按钮，左下脚展示搜索图标，则代表开启
5. 点击返回，退出配置页面。点击搜索图标，再点击任意按钮，即可在PC端控制台查看到相关ID信息

python侧：

安装依赖：pip install -r requirements.txt

1. 连接设备：
   fd = fd.connect('ip')//ip为测试机IP地址
2. 根据ID获取元素操作点击：
   fd.click_id_by_position(element_id='XXX', logtext='点击')
3. 根据ID直接点击
   fd.click_id('XX')
4. 输入文字
   fd.set_text('XXX', '123')
5. 断言
   fd.assert_toast('保存成功')
6. 关闭
   fd._close_()

上层操作API在python/下，可独立与客户端的flutter侧建立链接。与在原生UI自动化框架混合，需要要保持FlutterDirver持续建立链接。