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.

click the + icon to add a new account

Select Apple ID from the options and click Continue

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

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

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

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

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.

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.

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.

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."

This will create a new file in the output directory.

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.

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.

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.

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 or Provide a provision profile then run the command.

appium plugin run device-farm prepare-wda --wda-project-path=<path-to-WDA-project> --mobile-provisioning-file=<path-to-provision-profile>

You should have all the provision certificates installed on your machine before building the WebDriverAgent from source. For Xcode versions 15 or below, ensure they are located in:

~/Library/MobileDevice/Provisioning\ Profiles

For Xcode versions 16 and above, place them in:

~/Library/Developer/Xcode/UserData/Provisioning\ Profiles