Appium自动化 iOS17无法启动被测APP的解决办法
使用 appium:usePreinstalledWDA 或者 appium:prebuiltWDAPath
一、环境准备
已安装Appium2
根据官方描述,对于iOS17+的设备,需要Xcode15+、XCUITest driver v7.5.0或以上版本
1、查看当前Xcode版本为15.0,不需要升级。
2、执行命令 appium driver list ,查看当前 XCUITest driver 版本:
XCUITest driver需要升级。
1)执行命令 appium driver update xcuitest 升级XCUITest driver,升级失败,提示有大版本更新
2)根据提示加入 --unsafe 参数。完整升级命令:appium driver update --unsafe xcuitest
(注意:大版本升级有风险,升级需谨慎)
二、修改wda项目配置,编译wda
1、XCUITest driver升级完成后,打开xcode重新手动配置好wda。(注:可执行命令 appium driver run xcuitest open-wda 快速打开wda进行配置)
1)由于不需要测试tv设备,删除tvOS相关文件,删除一些测试用例,仅保留部分文件(如下图所示)
2)依次点击每个文件,在Signing & Capabilities选项卡中,勾选 Automatically manage signing,选择team(此处使用的是免费的Apple开发者账号的Team),设置Bundle Identifier(把原有的"facebook"改为任意名称,保证唯一性即可,如果有冲突会导致编译失败)
2、由于使用的是免费的Apple开发者账号,Provisioning Profile有效期为 7 天,决定自己管理wda,以便在检测到Provisioning Profile过期时重新编译
1)执行以下命令编译wda。(首次编译可手动编译,后续可在代码中执行此命令进行编译)
xcodebuild build-for-testing -project /Users/xxx/.appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj -derivedDataPath appium_wda_ios -scheme WebDriverAgentRunner -destination generic/platform=iOS -allowProvisioningUpdates
xxx为当前系统用户,用实际用户名进行替换;自定义derivedDataPath,编译的wda会保存在此目录的相关路径下(以下使用的是相对路径,会在当前执行命令的目录下生成一个appium_wda_ios文件夹)。看到** TEST BUILD SUCCEEDED **,编译成功。
2)展开appium_wda_ios目录如下图,可看到embeded.mobileprovision文件
3)打开文件,主要关注以下两项,date项为Provisioning Profile有效期。ProvisionedDevices一项包含相关设备udid。
后续使用时,可通过代码解析此文件,检测是否过期,是否包含当前设备,若未过期且包含当前连接的设备,则无需每次测试时都重新编译
三、设置desired capabilities(以下代码仅涉及相关配置项,实际执行测试可自行增删配置项)。
重点关注红框标注的配置项
use_prebuilt_wda会使用预先编译好的wda;derivedDataPath指明编译wda的相关路径;prebuiltWDAPath指明编译成功的wda安装包路径
四、小结
至此可在iOS17的设备正常启动待测APP了。总结一下,必要的步骤是:
1、升级Xcode至15.0或以上版本
2、升级XCUITest driver至7.5.0或以上版本
3、修改wda项目配置,执行命令编译wda(每次升级XCUITest driver后,都需要重新进行此操作)
4、配置desired capabilities,设置好3个相关选项:derivedDataPath、prebuiltWDAPath、use_prebuilt_wda
5、后续使用时,若Provisioning Profile过期,则需重新执行命令编译wda