10分钟上手iOS-Tagent：从安装到第一个自动化测试用例实战

【免费下载链接】iOS-Tagent iOS support agent for automation 项目地址: https://gitcode.com/gh_mirrors/io/iOS-Tagent

iOS-Tagent是一款强大的iOS自动化测试支持工具，能够帮助开发者快速实现iOS应用的自动化测试。本文将带你在10分钟内完成从环境搭建到运行第一个自动化测试用例的全过程，让你轻松掌握iOS自动化测试的核心技能。

准备工作：环境与工具安装

在开始使用iOS-Tagent之前，需要确保你的开发环境满足以下要求：

• 安装Xcode（推荐最新版本）
• 安装Node.js（v14及以上版本）
• 准备一台运行iOS 10.0及以上的设备或模拟器

首先，克隆iOS-Tagent仓库到本地：

git clone https://gitcode.com/gh_mirrors/io/iOS-Tagent
cd iOS-Tagent

然后安装项目依赖：

npm install

配置项目：设置Bundle ID与签名

成功安装依赖后，需要配置项目的Bundle ID和签名信息。使用Xcode打开项目：

open WebDriverAgent.xcodeproj

在Xcode中，选择项目导航器中的"WebDriverAgent"，然后依次选择"WebDriverAgentLib"目标和"Build Settings"选项卡，找到"Product Bundle Identifier"并修改为你自己的唯一标识符。

接下来，选择"WebDriverAgentRunner"目标，进入"General"选项卡，勾选"Automatically manage signing"，并选择你的开发团队。

连接设备：建立与iOS设备的通信

将iOS设备通过USB连接到电脑，或启动iOS模拟器。在设备上，需要信任开发者证书：

1. 打开"设置"应用
2. 进入"通用" > "描述文件与设备管理"
3. 选择你的开发者证书并点击"信任"

然后，运行以下命令启动WebDriverAgent服务器：

npm run start

服务器启动后，你将看到类似以下的输出：

Server started at http://127.0.0.1:8100

在设备上，你会看到WebDriverAgent应用已安装并运行。现在，你可以通过浏览器访问上述地址来验证连接是否成功。

编写第一个自动化测试用例

iOS-Tagent提供了丰富的API来控制iOS设备和应用。下面我们编写一个简单的测试用例，打开设备上的"计算器"应用并执行简单的计算。

创建一个新的测试文件test/functional/first-test.js，内容如下：

const { default: wd } = require('wd');
const driver = wd.promiseChainRemote('localhost', 8100);

async function runTest() {
  try {
    await driver.init({
      platformName: 'iOS',
      deviceName: 'iPhone',
      app: 'com.apple.calculator'
    });
    
    // 点击数字1
    await driver.elementByAccessibilityId('1').click();
    // 点击加号
    await driver.elementByAccessibilityId('+').click();
    // 点击数字2
    await driver.elementByAccessibilityId('2').click();
    // 点击等号
    await driver.elementByAccessibilityId('=').click();
    
    // 获取结果
    const result = await driver.elementByAccessibilityId('Result').text();
    console.log('计算结果:', result); // 应该输出3
    
    await driver.quit();
  } catch (err) {
    console.error('测试失败:', err);
    await driver.quit();
  }
}

runTest();

运行测试用例并查看结果

执行以下命令运行测试用例：

node test/functional/first-test.js

你将看到设备上的计算器应用自动打开，并执行1+2=3的操作。测试完成后，终端会输出计算结果。

为了更直观地查看测试过程，你可以使用iOS-Tagent提供的inspector工具。运行以下命令启动inspector：

npm run inspector

这将打开一个网页界面，你可以在其中查看设备屏幕、元素层次结构，并生成测试代码。

常见问题与解决方案

在使用iOS-Tagent的过程中，你可能会遇到一些常见问题：

1. 连接问题：如果无法连接设备，请确保设备已信任开发者证书，并且WebDriverAgent服务器正在运行。

2. 签名问题：如果遇到签名错误，请检查Xcode中的签名设置，确保选择了正确的开发团队。

3. 版本兼容性：确保你的Xcode版本与iOS设备版本兼容。你可以在WebDriverAgent.xcodeproj/project.pbxproj文件中查看项目的兼容性设置。

如果你遇到其他问题，可以查阅项目的Introduction/question.md文件，其中包含了常见问题的解答。

总结与下一步学习

通过本文的介绍，你已经成功完成了iOS-Tagent的安装、配置，并运行了第一个自动化测试用例。iOS-Tagent提供了强大的自动化测试能力，能够帮助你提高测试效率，确保应用质量。

接下来，你可以深入学习以下内容：

• 探索更多API：查看WebDriverAgentLib/Commands/目录下的文件，了解iOS-Tagent提供的所有命令。
• 编写复杂测试用例：结合test/functional/目录下的示例，编写更复杂的测试场景。
• 集成到CI/CD流程：参考azure-templates/目录下的配置文件，将iOS-Tagent集成到你的持续集成流程中。

希望本文能够帮助你快速上手iOS-Tagent，享受自动化测试带来的便利！

【免费下载链接】iOS-Tagent iOS support agent for automation 项目地址: https://gitcode.com/gh_mirrors/io/iOS-Tagent