Skip to content

WebdriverAgent Signing with Xcode

The Appium device farm now allows you to manage devices real IOS devices on non-Mac systems, including Raspberry Pi. To optimize its functionality, you need to re-sign the WebDriver agent with your provisioning profile and upload it to the device farm. The device farm will handle all the internal configuration. Below are the steps needed to sign the WebDriver agent.

Prerequisite

  1. A Mac machine with Xcode and Xcode command line tools installed
  2. A valid Apple account (with or without a developer program subscription)
  3. The iOS Resigner app for re-signing the WDA IPA, which you can download from iOS Resigner GitHub

Download WebdriverAgent app

The Appium device farm has already built a WDA IPA file for you to download and use for signing. You can obtain the IPA file from the Appium Device Farm GitHub repository. Save the file to your Mac machine.

Creating Provisioning profile

Open Xcode and sign in with your Apple ID.

xcode

click the + icon to add a new account

Xcode create account

Select Apple ID from the options and click Continue

Xcode sign in

Log in with your existing Apple ID or click Create Apple ID to create a new Apple account.

Xcode account

Once logged in successfully, you should see your account added to the account list.

Xcode account list

Now, create the provisioning profile for re-signing the WDA. Open Xcode > File > New > Project.

Xcode create project

Select any app type from the list. Choosing App is recommended for simplicity.

Xcode select app

Enter a Project Name and a valid Organization Identifier. It can be any value, but ensure it is unique. Select the Apple account you logged in with from the Team dropdown. After entering the details, click Next and choose a folder to create the project.

Xcode org id

Once the project is created, click on the Project Name in the left pane and select the Signing & Capabilities tab. You should see Xcode Managed Profile listed under Provisioning Profile.

xcode signing

You can also check if the provisioning profile is created in the ~/Library/MobileDevice/Provisioning Profiles directory. Once the provisioning profile is present, you have successfully created it and can now use it to sign the WDA file.

Resigning WDA .ipa

To re-sign the IPA, open the iOS Resigner app that you previously downloaded. Select the WDA IPA file that you downloaded as the input file. Choose your Apple account from the Signing Certificate dropdown. In the Provisioning Profile dropdown, select the provisioning profile you created earlier.

Ios resign

After entering all the details, click "Start" and select a folder to save the resigned IPA file. Ensure you save it with the name wda-resign.ipa and click "Save."

ios wda sign

This will create a new file in the output directory.

ios wda sign

Uploading signed WDA in device farm

Once the WebDriver agent is successfully re-signed, it needs to be uploaded to the Appium device farm. Open the device farm using the server URL in your browser, switch to the Apps section, and click the Upload Apps button.

df app upload

Choose the resigned IPA named wda-resign.ipa and click "Upload." You should see a success popup indicating the file upload was successful. That's it! You are now ready to use real iOS devices with the device farm.

df upload success

How do I build WebDriverAgent from source?

The plugin has in build script that can help you build the WDA IPA to test on real devices. set MOBILE_PROVISION_PATH to environment.

Run the command below to build the WebDriverAgent from source.

appium plugin run device-farm prepare-wda
The above script will pick WebDriverAgent project installed globally from xcuitest-driver.

If you want to provide the custom path of WebDriverAgent project then set WDA_PROJECT_PATH to environment.

You should have all the provision certificates installed on your machine to build the WebDriverAgent from source in path.

~/Library/MobileDevice/Provisioning\ Profiles