使用 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
网友评论