ATX自动化测试工具使用教程

1. 项目介绍

ATX（AutomatorX）是一款由网易游戏团队开发的手机自动化测试工具，支持iOS和Android平台的原生应用、Web应用及游戏的自动化测试。它使用Python语言编写测试用例，结合图像识别和控件定位技术，让自动化测试更加高效。同时，ATX还提供了专用的IDE来帮助快速编写脚本。

2. 项目快速启动

环境准备

• Python 2.7 或 3.6
• Android 4.4+，iOS 9.0+（需配合Mac使用）
• adb 版本 1.0.36 或更高

安装步骤

1. 准备Python虚拟环境

   pip install virtualenv
   virtualenv venv
   

2. 激活虚拟环境

   • Linux或Mac:

     source venv/bin/activate
     

   • Windows:

     venv\Scripts\activate.bat
     

3. 安装ATX

   pip install --upgrade --pre atx
   

4. 安装opencv依赖

   pip install opencv_contrib_python
   

Android测试依赖

• 安装ADB

  • WindowsADB安装指南

  • Mac上的adb通过命令行安装

    brew install android-platform-tools
    

• 安装ATX手机助手.apk

  python -m atx install atx-assistant
  

iOS测试依赖

• 安装WebDriverAgent

  下载WebDriverAgent后，切换到指定的版本：

  git reset --hard a8def24ca67f8a74dd709b899c8ea539c9c488ea
  

  将iPhone连接到Mac上，然后安装WebDriverAgent。具体操作可能遇到问题，可参考相关文档。

检查安装

• 查看ATX版本号

  python -m atx version
  

• 检查环境配置是否正常

  python -m atx doctor
  

3. 应用案例和最佳实践

（此处添加具体的应用案例和最佳实践，例如如何编写测试脚本，如何使用图像识别定位元素等。）

4. 典型生态项目

（此处添加与ATX相关的典型生态项目，例如基于ATX的图像识别库、输入法项目等。）