-
-
Notifications
You must be signed in to change notification settings - Fork 109
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: reformat docs to look good with mddocs
- Loading branch information
1 parent
72a15b5
commit 585bef3
Showing
2 changed files
with
45 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,59 +1,75 @@ | ||
| --- | ||
| title: Webdriver Agent Signing | ||
| title: WebdriverAgent Signing with Xcode | ||
| hide: | ||
| - navigation | ||
| --- | ||
|
|
||
| The Appium device farm now allows you to manage devices readl 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: | ||
| ## 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](https://github.com/DanTheMan827/ios-app-signer/releases) | ||
|
|
||
| ## Download Webdriver Agent .ipa | ||
| ## 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](https://github.com/AppiumTestDistribution/appium-device-farm/raw/main/WDA.ipa). Save the file to your Mac machine. | ||
|
|
||
| ## Creating Provisioning profile | ||
|
|
||
| 1. Open Xcode and sign in with your Apple ID. | ||
|  | ||
| Open Xcode and sign in with your Apple ID. | ||
|
|
||
| 2. click the `+` icon to add a new account | ||
|  | ||
|  | ||
|
|
||
| 3. Select `Apple ID` from the options and click `Continue` | ||
|  | ||
| click the `+` icon to add a new account | ||
|
|
||
| 4. Log in with your existing Apple ID or click `Create Apple ID` to create a new Apple account. | ||
|  | ||
|  | ||
|
|
||
| 5. Once logged in successfully, you should see your account added to the account list. | ||
|  | ||
| Select `Apple ID` from the options and click `Continue` | ||
|
|
||
| 6. Now, create the provisioning profile for re-signing the WDA. Open `Xcode > File > New > Project`. | ||
|  | ||
|  | ||
|
|
||
| 7. Select any app type from the list. Choosing `App` is recommended for simplicity. | ||
|  | ||
| Log in with your existing Apple ID or click `Create Apple ID` to create a new Apple account. | ||
|
|
||
| 8. 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. | ||
|  | ||
|  | ||
|
|
||
| 9. 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. | ||
|  | ||
| Once logged in successfully, you should see your account added to the account list. | ||
|
|
||
| 10. 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. | ||
|  | ||
|
|
||
| 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. | ||
|
|
||
| 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. | ||
|
|
||
| 11. 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. | ||
|  | ||
|
|
||
| 12. 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. | ||
| 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. | ||
|
|
||
|  | ||
|
|
||
| 13. 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. | ||
| ## 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. | ||
|
|
||
|  | ||
|
|
||
| 14. 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. | ||
|  | ||
| 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. | ||
|
|
||
|  |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters