【亲测免费】 iOS-Tagent 使用指南

一、项目目录结构及介绍

iOS-Tagent 是一个基于 Facebook 的 WebDriverAgent 二次开发的项目，专门设计来适配 Airtest 项目。其目录结构精心组织以支持 iOS 自动化测试需求。以下是关键组件的简介：

• WebDriverAgent: 包含 WebDriverAgent 的核心代码，用于构建 WebDriver 服务器。

  • WebDriverAgentLib: WebDriverAgent 的库文件，实现设备控制的核心逻辑。
  • WebDriverAgentRunner: 测试运行器，负责在真实设备上启动自动化测试。
  • WebDriverAgentTests: 包含测试用例，验证 WebDriverAgent 功能。

• Configurations: 配置相关文件夹，可能存放特定环境下的配置设置。

• Fastlane: 用于自动化发布流程的工具集，简化 Xcode 构建和部署步骤。

• Scripts: 启动脚本和其他辅助脚本的存储位置。

• ci-jobsci-jobs: 与持续集成相关的作业配置。

• LICENSE 和 PATENTS: 项目许可和专利信息文件。

• README.md: 项目的主要读我文件，提供了快速入门指导。

• Gemfile: Ruby 库依赖声明，用于 Fastlane 等工具的管理。

二、项目启动文件介绍

主要入口点

项目启动的关键在于通过 Xcode 编译并运行 WebDriverAgentRunner 工程，这实际上并不直接有一个单一的“启动文件”，而是通过以下步骤间接启动：

1. 打开 iOS-Tagent 在 Xcode 中。
2. 选择目标设备（通过顶部菜单的产品->目的地选择你的iPhone）。
3. 运行产品 -> Test 来启动测试，实质上是启动了 WebDriverAgent 服务。

WebDriverAgent的启动逻辑

WebDriverAgent 的启动逻辑主要位于其内部的主类初始化和测试用例执行过程中，这些逻辑分散在多个 .swift 文件中，特别是在处理远程命令和服务监听部分。

三、项目的配置文件介绍

Main Configuration Files

• WebDriverAgent.xcodeproj: Xcode 工程文件，包含了所有构建和编译设置，是项目配置的核心。

• WebDriverAgentLib/Info.plist: 控制台应用的信息描述文件，定义了应用的基本属性，如 bundle ID、显示名称等。

• Info.plist (在 WebDriverAgentRunner 中): 类似于上述，但特指 WebDriverAgent 的测试运行器部分，用于指定测试应用的相关信息。

• .gitignore: 版本控制忽略文件，排除不需要跟踪的文件类型。

环境特定配置

在实际部署和定制时，配置可能还涉及到修改 Fastlane 相关的配置文件（如果使用）、私有头文件路径、以及环境变量的设定。虽然没有直接列出具体的配置文件，但通过修改 Xcode 工程的 Build Settings 或者直接编辑相关脚本，可以实现对项目的特定配置调整。

为了确保项目顺利运行，还需关注与 Airtest IDE 集成所需的代理配置（例如 iproxy 或 wdaproxy 的设置），这部分配置虽不直接存在于项目内部，但对于完整的工作流至关重要。

---

此文档为简要介绍，具体实施细节及深入了解各组件功能，建议参考项目内的 README 文件和官方文档进行详细学习和实践。