1. 前期检查

必备：Ios 真机、开发者账号（或者证书）、良好的数据线

其他：

• Ios 真机信任此调试电脑

• Ios 真机已注册进入开发者账号

• XCode version 9.0 and above.

• iOS version 11.0 and above.

1. Macaca 环境配置

参考Macaca配置环境页，配置 Ios 真机测试环境，步骤大致包括：

• 请安装 Xcode9 或者更高版本
• 请安装 usbmuxd 以便于通过 USB 通道测试 iOS 真机

$ brew install usbmuxd

• 请安装 ideviceinstaller 用来给真机安装 App。

$ brew install ideviceinstaller

• 应用中如含有 WebView，请安装 ios-webkit-debug-proxy

$ brew install ios-webkit-debug-proxy

• 请安装 carthage 来构建 Macaca XCTestWD.

$ brew install carthage

• 安装带 TEAM_ID 的 Macaca-ios

$ DEVELOPMENT_TEAM_ID=TEAM_ID npm i macaca-ios -g

查看 TEAM_ID 的方法，确保已经有开发者账号（或者证书）的情况下，已经将 XCTestWD 安装到真机的情况下查看，TEAM_ID。在 XCTestWD 项目中如下可查看 TEAM_ID：

• Macaca-doctor：用 Macaca-doctor 确保环境安装正确

$ npm i macaca-cli -g
$ macaca doctor

​

1. 下载XCTestWD项目，并将其装入真机

• Carthage 构建

  carthage update --platform iOS
  

• XCTestWD 安装，打开/XCTestWD/XCTestWD.xcodeproj

1. 导入开发者账号（证书）
2. Run Test 将 XCTestWDUITest 装入真机：

1. 在测试脚本中配置真机测试参数

例子：

• 如果真机中有相应的测试 app，参数中app 可注释
• 确保 udid 对应真机已连入电脑，并信任此电脑
• 确保测试 App bundle ID 一致

1. 测试

例子:

platform=ios macaca run --verbose --reporter macaca-reporter -d ./mobile-app-sample.test.js

​

常见问题：

• 提示有关 ios-deploy 找不到请安装ios-deploy

npm install -g ios-deploy

• xcode 中如果提示 XCTestWD.framwork 找不到或出错，请删除 XCTestWD.franwork 重新执行 Run Test

• 其他问题或者讨论 请到github macaca ios 真机测试 issue