Setup iOS Test Automation on Windows using TestProject

TestProject enhances Appium’s driver and enables you to run iOS test automation on Windows operating system, without the need for macOS or Xcode!
The first thing you have to do is to get a TestProject account, no worries – it’s free! Then, you’ll have to follow this step-by-step tutorial to setup your iOS settings, and you’ll be good to go to start your iOS test automation projects.

---

Tutorial Overview

1. Step 1 – Prerequisites
2. Step 2 – Get your Apple’s Developer Program Team ID
3. Step 3 – Create a Certificate Signing Request (CSR)
4. Step 4 – Create your Mobile Provisioning Profile
5. Step 5 – Record or Develop iOS Test Automation using TestProject

Let’s get started!

---

Step 1 – Prerequisites

1.1. You need the TestProject Agent to be installed and running on your computer.
1.2. You must have an active Apple Developer Account (Notice that this is not the same as Apple ID).

Step 2 – Get Your Apple’s Developer Program Team ID

The first thing you need to do is to provide your Apple’s Developer Program Team ID from Apple Developers Portal. The Team ID is a 10-character string that’s generated by Apple to uniquely identify your team. You can get it by following these steps: 

2.1. Click on “Membership”:

*Note that you have to have the “Apple Developer Program” label (as seen in the image above). If you don’t have this label, it means that you only have a simple Apple ID and that you do not have an Apple Developer Program subscription (As required in the prerequisites above in step 1.2). 

2.2. Copy your Team ID:

2.3. Open another tab with your TestProject account, click on your name at the upper right corner, click on “Account” and then click on “iOS” in the setting’s left menu (you will reach this page). Enter the Team ID you copied from Apple Developer Account’s Membership screen (step 2.2 above):

Step 3 – Create a Certificate Signing Request (CSR)

In order to sign the driver with your certificate, you need to create a Certificate Signing Request (CSR).

3.1. On TestProject’s iOS settings page, generate a new “Certificate Signing Request (CSR)”, by clicking “Generate new” and download a certificate signing request file:

 

3.2. Go back to Apple Developers Portal and upload the CSR file generated by TestProject (in step 3.1 above). First, you need to click on “Certificates, IDs & Profiles”:

3.3. Then, click on the “plus” icon at the upper right side of the screen:

3.4. Then, choose “iOS App Development” and click “Continue”:

 

3.5. Now, upload the CSR file generated by TestProject (in step 3.1 above):

3.6. Download the certificate:

3.7. You should be able to see your certificate on the list below:

3.8. Now, you have to upload the certificate generated by Apple to TestProject. Head back to TestProject’s iOS settings page, and click “Upload New” in the “Certificate” section:

 

Step 4 – Create your Mobile Provisioning Profile

Back in the Apple Developer Portal, you need to complete the provisioning process. The provisioning profile is used by Apple to list the eligible devices where the driver can be installed.

4.1.  Under “Profiles”, click on the “plus” icon:

4.2. Click on “iOS App Development” and click “Continue”:

4.3.  Now you need to choose the App ID.
*Important: Make sure to choose the “Wildcard” option.

Then, click “Continue”:

Only in case you don’t have a “Wildcard” option in the dropdown (as seen in the image above), you will need to create the Wildcard App ID manually by completing the steps described here: https://blog.testproject.io/2019/01/29/create-wildcard-app-id-ios/.

4.4. Select the certificate you have created in step 3.7 above, and click “Continue”:

4.5. Select your devices and click “Continue”:

4.5.1.To add a device, you will need the device UDID:

1. Head over to the TestProject platform agents page: https://app.testproject.io/#/agents​

2. At the agent’s page, click on your agent.

      3. Click on Devices

​

   Here you can see Previously/Current connected devices and Simulators.

   You can now copy the UDID to the clipboard.

4.6. Give your profile a name, and click “Generate”:

4.7. Now you need to download the newly generated provisioning profile:

4.8. Now, go back to TestProject’s iOS settings page, under “Provisioning Profile”, click “Upload new” and upload the provisioning file you have downloaded in step 4.7 above.

 

That’s it!  😉 
If you’ve followed all of the steps above, you should see a toast popup in TestProject’s Platform informing you that the provisioning has been completed successfully, and you will see a list of all eligible devices you can use with TestProject for your iOS test automation (on ALL operating systems, even iOS on Windows!).

If you see a toast with an error, go over this guide again and check the most common errors:

1. The certificate you uploaded to TestProject was not the one that was generated using TestProject CSR (Certificate Signing Request). Go back to step 3.
2. You selected the wrong App ID (You must choose the Wildcard option). Go back to step 4.3.
3. The provisioning profile you uploaded does not contain the certificate that was generated using TestProject’s CSR. Go back to step 4.4.

 

Step 5 – Record or Develop iOS Test Automation using TestProject

With TestProject you can record your iOS tests from a Windows machine, or you can develop your tests using TestProject’s Java, Python or C# SDKs. Either way, we’ve got you completely covered!

So, what are you waiting for?
Go ahead and start testing your iOS Apps!  😎

 

For any questions or assistance, feel free to leave a comment below or contact us using one of our support channels:

1. TestProject’s in-app chat
2. Active forum
3. Email us at [email protected]