ATX(AutomatorX) (中文版)

重要说明 ！！！

ATX目前已经分成了两个项目

• 安卓(Android) https://github.com/openatx/uiautomator2 简称u2
• 苹果(iOS) https://github.com/openatx/facebook-wda

Introduction (简介)

Hope (愿景)

重要说明

python -muiautomator2 init

用于安卓和iOS原生应用测试的库已经分离出来，可以单独使用（强烈推荐单独使用，一来依赖少、稳定性高，二来写代码的时候还能自动补全）

• 对于Android应用的测试，如果不需要用到图像识别，推荐使用这个项目uiautomator2
• 对于iOS应用的测试，如果不需要用到图像识别，推荐使用这个项目facebook-wda

Features

• [x] 支持iOS, Android 双平台的原生应用，Web应用和游戏
• [x] 支持通过图像识别来定位元素的位置
• [x] 内置自动生成测试报告的功能
• [x] 网页版的脚本编辑器，来帮助快速的写代码

Discuss (讨论群)

• QQ: 499563266 PS: 因为群人数即将到达上限，所以目前进群有收取少量的群费,来募集扩大群规模的费用。
• 网易内部用户加Popo群 1347390 群主 hzsunshx
• Testerhome社区
• Gitter Chat Room

Limitation (限制)

• Python 2.7 or 3.6
• Android 4.4+
• iOS 9.0+ with Mac
• adb >= 1.0.36

Installation (安装)

pip install virtualenv
virtualenv venv
Linux or Mac
. venv/bin/activate
Windows
venv\Scripts\activate.bat

安装相关的python库

# install the lastest version of atx
If feed too slow use douban pypi mirror:  -i https://pypi.doubanio.com/simple/
pip install --upgrade --pre atx
install opencv dependencies
pip install opencvcontribpython

Android测试依赖

• ADB

• ATX手机助手.apk

iOS测试依赖

• WebDriverAgent

git reset --hard a8def24ca67f8a74dd709b899c8ea539c9c488ea

你的iPhone手机需要连接到Mac上，然后Mac安装WebDriverAgent，通常对Xcode部署的人搭WDA的人会遇到不少问题，搞不定继续参考这里

WDA成功启动后，会生成一个用于ATX连接的http地址，比如http://localhost:8100

检查安装是否成功

# 查看atx版本号
python -m atx version
检查环境配置是否正常
python -m atx doctor

脚本编辑器(可选)

为了方便快速的写出脚本，提供了三个Web编辑器。

• 自带GUI

• weditor beta 针对Android和iOS原生应用快速定位元素，自动生成代码

Getting Started （必看）

• 快速入门文档
• 如何使用内置的测试报告功能
• ATX资料快速索引
• Testerhome上的ATX有关的文章列表

APIs (接口文档)

• 常用接口
• iOS的接口文档

Other (其他)

• ATX自带的命令行工具

Known Issues (常见问题)

为了避免潜在的Python编码问题，代码文件都应该用UTF-8编码格式保存。

• 测试中出现的弹窗如何处理？

• 对于python2.7 字符串前应该加上u开头，例如u'你好'

from future import unicode_literals

• 对于python3的非windows系统

export PYTHONIOENCODING=UTF-8

ATX Extentions （扩展功能）

• WebView

# coding: utf-8
	import atx
	from atx.ext.chromedriver import ChromeDriver
d = atx.connect()     driver = ChromeDriver(d).driver() # return selenium.driver instance     elem = driver.findelementbylinktext(u"登录")     elem.click()     driver.quit()

import atx
		from atx.ext.gt import GT
d = atx.connect()
gt = GT(d) 		gt.start_test('com.netease.my') # start test 		# ... do click touch test ... 		gt.stopandsave()

$ adb pull /sdcard/GT/GW/com.netease.my/