关键字: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 参数指定了编译结果的输出目录。
那么我们来看下编译结果:
入口文件: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 文件中有一组命令行参数,见下图红色框:
向这个数组中加入 String value, 就可以在 XCUITest 工程中读取到参数数组从而完成传参过程。
print("CommandLine 参数:", CommandLine.arguments)
传参结果可以取到一个数组,就能拿到自定义的参数啦。
2.向 xctestrun 文件中写入自定义信息
PlistBuddy 工具是 macOS 预置的一种处理 plist 文件的工具,实测可以完美处理 xctestrun 格式的文件。
通过 Xcode 打开 xctestrun 格式的文件,可以发现:
文件的组织形式就是键值对的标签嵌套文本格式,基本同 plist 文件如出一辙。
-
plist文件就是iOS、macOS等工程都会用到的一种信息描述文件(可以理解为一种配置文件)
plist 文件样例:
xctestrun 文件样例:
修改 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 左右波动也是这个意思。
接下来需要允许我们的 UITest target 向用户申请网络访问权限:
此时回到手机上,如果看到弹出网络权限申请,给予权限。
接下来就可以顺利进行网络请求了。
此处提供一段 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 数据啦!
撒花~