XCUITest 自动化应用深度进阶

关键字：XCUITest，iOS 自动化，自动化集成，网络请求解决方案，参数传递

一、将封装好的 XCUITest 结果给第三方执行（不提供源码）

以一个完整的xcodebuild test ... 命令为例, 执行过程包含了 [xcodebuild build-for-testing ...] 和 [xcodebuild test-without-building ...] 两个环节。
而连接这两个环节的配置文件就是 xctestrun 文件。

下面来看一个实例

* xcodebuild build-for-testing -scheme SingleUITestUITests -destination 'platform=iOS,id=xxx-xxx' -workspace SingleUITest.xcworkspace -derivedDataPath '/Users/lipeng/Desktop/buildResult'

其中 xxx-xxx 是你的iOS真机设备的 udid,
-derivedDataPath 参数指定了编译结果的输出目录。
那么我们来看下编译结果：

XCUITest build 结果.png

入口文件：xctestrun 文件

利用下面这个命令

* xcodebuild test-without-building -xctestrun SingleUITestUITests_iphoneos14.0-arm64.xctestrun -destination 'platform=iOS,id=xxx-xxx'

-xctestrun 传入的就是入口文件，一定要写对地址，最好是完整路径，防止出错。

就可以单独控制 uitest 的执行过程了。
那么无需源码。只要把相关文件：
Products 文件夹下面的 xctestrun 文件和 Debug-iphoneos 文件夹下面的 xxx.app 文件（此处是SingleUITest.app 和 SingleUITestUITests-Runner.app）发送给第三方即可执行 UI 自动化。

二、XCUITest 启动传参

如果在 UITest代码中，需要通过一些参数来判断走哪些代码。或者说通过启动传入测试时候需要的一些账户数据等等。
就要设计一种方案，来读取命令行传入的参数。

1.XCUITest 执行过程中可以读取哪里传入的信息

上一个环节中提到的 xctestrun 文件中有一组命令行参数，见下图红色框：

传参入口.png

向这个数组中加入 String value, 就可以在 XCUITest 工程中读取到参数数组从而完成传参过程。

print("CommandLine 参数：", CommandLine.arguments)

传参结果可以取到一个数组，就能拿到自定义的参数啦。

2.向 xctestrun 文件中写入自定义信息

PlistBuddy 工具是 macOS 预置的一种处理 plist 文件的工具，实测可以完美处理 xctestrun 格式的文件。
通过 Xcode 打开 xctestrun 格式的文件，可以发现：
文件的组织形式就是键值对的标签嵌套文本格式，基本同 plist 文件如出一辙。

plist文件就是iOS、macOS等工程都会用到的一种信息描述文件（可以理解为一种配置文件）
plist 文件样例：

一个简单的 plist 文件.png

xctestrun 文件样例：

一个简单的 UITest 的 xctestrun 文件.png

修改 xctestrun 文件的操作代码样例

# 修改
/usr/libexec/PlistBuddy -c 'Set :$key string "value" ' info.plist

# 删除
/usr/libexec/PlistBuddy -c 'Delete :$key' info.plist

# 增加
/usr/libexec/PlistBuddy -c 'Add :$key string "value"' info.plist

例子：

/usr/libexec/PlistBuddy -c "Add :'SingleUITestUITests:CommandLineArguments:phone' string 'ThisVVVvalue'" SingleUITestUITests_iphoneos14.0-arm64.xctestrun

phone 关键字无效，因为只能有value这样的key来表示顺序.

硬核技能

3. 在 UITest bundle 中引入网络请求库（进行网络请求等）

UITest target 有着自己的 info.plist 文件，来控制其 Runner 自身的各种权限。
如果我们直接在 XCUITest 代码中进行网络访问，在请求回调之后，在命令行输出大概率会看到以下报错：

NSURLConnection finished with error - code -1001

当然 code 在 1000 左右波动也是这个意思。

网络错误.png

接下来需要允许我们的 UITest target 向用户申请网络访问权限：

UITest网络请求.png

此时回到手机上，如果看到弹出网络权限申请，给予权限。

接下来就可以顺利进行网络请求了。

此处提供一段 swift 版本的网络请求代码（未使用第三方库）

var url: NSURL = NSURL(string: "http://YOUR_INTERFACE_URL_HERE")!
let request: NSURLRequest = NSURLRequest(url: url as URL)

NSURLConnection.sendAsynchronousRequest(request as URLRequest, queue: OperationQueue.main, completionHandler:{
    (response, data, error) -> Void in
    print("✅✅✅")
    if ((error) != nil) {
        // 错误处理
        print(error)
    }else{
        // 解析返回数据
        print(data)
        print(data?.debugDescription)
        let resultStr =   String.init(data: data!, encoding: .utf8)
        print("接口返回数据: \(resultStr!)")
    }

不出意外的话，你会拿到接口返回的 json 数据啦！

撒花~