# iOS 应用程序测试器 (AXe CLI) ## 概述使用 AXe 测试和自动化 iOS 模拟器应用程序，AXe 是一种命令行工具，利用 Apple 的辅助功能 API 进行编程模拟器控制。 ax 作为单个二进制文件运行，无需服务器设置。 ## 何时使用 * 自动化 iOS 模拟器 UI 交互以进行测试 * 审核辅助功能标签和 VoiceOver 描述 * 录制测试执行视频 * 编写可重复测试场景的脚本 * CI/CD 管道 iOS 测试集成 ## 先决条件 * 安装了 Xcode 的 macOS * iOS 模拟器（包含在 Xcode 中） * 自制程序（用于安装） ## 安装酿造水龙头卡梅伦库克/斧头酿造安装斧头验证安装：斧头——帮助 ## 快速入门 1.找到你的模拟器UDID：斧头列表模拟器 2. 点击一个坐标：斧头水龙头 -x 200 -y 400 --udid 3. 检查辅助功能元素： ax 描述-ui --udid ## 命令参考 ### 模拟器发现 # 列出所有可用的带有 UDID 的模拟器斧头列表模拟器 ### 触摸互动 # 点击坐标斧头点击 -x 100 -y 200 --udid # 滑动手势斧头滑动 --start-x 100 --start-y 500 --end-x 100 --end-y 200 --udid # 低级触摸事件 ax 触地 -x 100 -y 200 --udid 斧头触摸 -x 100 -y 200 --udid ### 预设手势 # 滚动斧头手势向上滚动 --udid 斧头手势向下滚动 --udid 斧头手势向左滚动 --udid 斧头手势向右滚动 --udid # 边缘滑动（用于导航）斧头手势从左边缘滑动 --udid 斧头手势从右边缘滑动 --udid 斧头手势从顶部边缘滑动 --udid 斧头手势从底部边缘滑动 --udid ### 文本输入 # 直接输入文字斧头类型“你好世界！” --udid # 从标准输入输入（对于密码/敏感数据有用）回声“秘密”|斧头类型 --stdin --udid # 从文件中输入斧头类型 --file input.txt --udid ### 硬件按钮 # 主页按钮斧头按钮主页 --udid # 锁定/电源按钮斧头按钮锁 --udid # 长按（例如 Siri）斧头按钮锁定 --duration 2.0 --udid # 侧边按钮斧头按钮侧 --udid #苹果支付斧头按钮 apple-pay --udid ### 辅助功能检查 # 描述所有UI元素（全屏） ax 描述-ui --udid # 描述特定点的元素 ax 描述-ui --point 100,200 --udid ### 视频录制 # 录制到MP4文件 ax record-video --udid --fps 15 --output test-recording.mp4 # 流视频（用于 ffmpeg 管道） ax 流视频 --udid --fps 30 --format ffmpeg | ffmpeg -i - 输出.mp4 # 以 MJPEG 格式传输 ax 流视频 --udid --fps 10 --format mjpeg > stream.mjpeg ### 时序控制所有命令都支持排序延迟： # 行动前等待 ax tap -x 100 -y 200 --pre-delay 1.0 --udid # 执行后等待 ax tap -x 100 -y 200 --post-delay 0.5 --udid # 综合延迟斧头类型'文本' --pre-delay 0.5 --post-delay 1.0 --udid ## 辅助功能测试工作流程 ### 1\.审计全屏 # 获取所有辅助功能元素 ax 描述-ui --udid >accessibility-audit.txt 检查输出： * 缺少 `accessibilityLabel` 值 * 通用标签，如“按钮”或“图像” * 缺少复杂操作的“accessibilityHint” * 不正确的“accessibilityTraits” ### 2\.基于点的检查 # 检查特定元素 ax 描述-ui --point 200,400 --udid ### 3\. VoiceOver 模拟脚本 #!/bin/bash UDID =“您的模拟器_UDID” # 浏览应用程序元素斧头手势从左边缘滑动 --udid $UDID --post-delay 1.0 ax 描述-ui --udid $UDID 斧头点击 -x 200 -y 400 --udid $UDID --post-delay 0.5 ax 描述-ui --udid $UDID ## 自动化示例 #!/bin/bash UDID =“您的模拟器_UDID” # 登录流程自动化 echo "开始登录测试..." # 点击电子邮件字段斧头水龙头-x 200 -y 300 --udid $UDID --post-delay 0.3 # 输入电子邮件斧头类型'test@example.com'--udid $UDID --post-delay 0.3 # 点击密码字段斧头水龙头-x 200 -y 380 --udid $UDID --post-delay 0.3 # 输入密码（出于安全考虑，来自标准输入）回显“密码123”|斧头类型 --stdin --udid $UDID --post-delay 0.3 # 点击登录按钮斧头水龙头-x 200 -y 480 --udid $UDID --post-delay 2.0 # 验证结果 - 检查预期元素 ax 描述-ui --udid $UDID | grep -q "欢迎光临" && echo "登录成功" ## CI/CD 集成 # GitHub 操作示例 - 名称：运行 iOS UI 测试运行：| # 启动模拟器 xcrun simctl 启动“iPhone 15” UDID=$(xcrun simctl 列出设备 | grep "iPhone 15" | grep -oE '[A-F0-9-]{36}') # 安装应用程序 xcrun simctl install $UDID ./build/MyApp.app xcrun simctl 启动 $UDID com.example.myapp # 运行斧头测试 ax 描述-ui --udid $UDID >accessibility-report.txt # 记录测试斧头记录视频 --udid $UDID --fps 10 --输出 test.mp4 & 视频_PID=$! # 运行自动化脚本 ./test-scripts/login-flow.sh $UDID 杀死$VIDEO_PID ## 故障排除 ###“找不到模拟器” # 确保模拟器已启动 xcrun simctl 启动“iPhone 15” # 获取正确的UDID 斧头列表模拟器 ###“权限被拒绝” # 在系统偏好设置中授予可访问权限 # 安全与隐私 > 隐私 > 辅助功能 ### 命令没有响应 # 确保应用程序在前台 xcrun simctl launch # 在命令之间添加延迟 ax tap -x 100 -y 200 --post-delay 1.0 --udid ## 最佳实践 * 在命令之间始终使用 `--post-delay` 以确保可靠性 * 将UDID存储在脚本的环境变量中 * 在操作之前和之后使用 `describe-ui` 来验证状态 * 测试运行时录制视频以供调试 * 通过标准输入管道传输敏感文本，而不是命令行参数 * 作为 CI/CD 管道的一部分运行可访问性审核

iOS应用测试仪

包含技能