Common WebDriverAgent installation issues
The following are some common issues you may encounter when installing WebDriverAgent.
Unrecognized device​
Cause​
Your connected iOS device is not recognized.
Remedy​
Reconnect the device, then click Trust on the device for the connected machine.
Failed to install the WebDriverAgent​
Cause​
WebDriverAgent installation failed.
Remedy​
Try the following workarounds:
-
Add read, write, and execute permissions to the
.appiumfolder.sudo chmod -R 777 ~/.appium -
Reinstall Appium 3 and the XCUITest driver.
npm i --location=global appium@3.0.0
appium driver install xcuitest@7.21.1
No provisioning profile​
Cause​
No provisioning profile is available for signing WebDriverAgent.
Remedy​
Make sure you have installed the provisioning profile and certificates on your machine.
To view your installed certificates, refer to Apple Developer documentation: View a signing certificate.
To view your provisioning profiles, go to ~/Library/MobileDevice/Provisioning Profiles.
Don't see your identities​
Cause​
Invalid trust settings prevent your identities from appearing.
Remedy​
Make sure the Apple Worldwide Developer Relations Certificate Authority is added to the login keychain.
Issue when using Xcode 14.x with Appium 1.x​
Cause​
You are using Xcode 14.x with Appium 1.x.
Remedy​
Refer to Unable to execute tests with iOS on macOS Ventura and XCode 14.x.
codesign wants to sign using key <keyname> in your keychain​
Cause​
The certificate access control is not configured correctly.
Remedy​
Configure the certificate access control to allow all applications to access the key.
