1. Overview
Zoho QEngine supports iOS testing on both physical devices and simulators. Simulators create virtual devices on the user’s computer, enabling testing without a physical device. This provides a flexible environment for thorough mobile application testing.
Setting up for testing requires having Xcode installed on the test machine to support both simulator and physical device environments. Additionally, Zoho QEngine’s local agent should be in place to manage device connections and enable efficient testing workflows.
For physical device testing, Zoho QEngine adheres to Apple’s strict security requirements, including code signing. Each device must be registered in the certificate signing request and provisioning profile, ensuring that the app is authenticated and can only run on specified devices. Testing with simulators, however, is easily accessible through Xcode, allowing seamless testing without the need for physical devices. 2. Prerequisites
2.1 System requirements
Note: If you're using a non-macOS machine, options to run Xcode include using cloud-based macOS services (such as MacStadium or MacinCloud) or running a macOS virtual machine on supported hardware. Be mindful of Apple's licensing terms when considering options like virtual machines or Hackintosh setups.Hardware requirements
Processor: Intel-based Mac or Apple silicon (M1 and newer chips) is supported.
RAM: A minimum of 8 GB of RAM is recommended, although 16 GB or more is ideal for better performance, especially when running simulators.
Storage: Xcode is a large application (typically 12–15 GB). Ensure you have at least 30–40 GB of free storage to accommodate Xcode, associated tools, and any project files.
2.2 Download and install Xcode
You can download and install Xcode from the official Apple website or directly from the App Store.
Once installed, check for any software updates in your Mac’s System Settings to ensure everything is up to date, especially the command line tools.
![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note: If the command line tools aren’t already installed, open Xcode and go to Settings > General. From there, check for updates and ensure the checkbox for command line tools is selected.
2.3. Download and install the agent
3. Connect your physical device with the agent
Step 1: Generate the certificate signing request and provisioning profile
To enable Zoho QEngine to install and run tests on your physical device, you need permissions from Apple, which require a certificate signing request and provisioning profile.
Open the certificate in Keychain Access on your machine. Verify the certificate's validity. If it’s marked as Not Trusted, navigate to Trust > Get Info in Keychain Access and set it to Use System Defaults.
Note: Save the certificate and provisioning profile in the Zoho QEngine dependency folder on your machine. This is a required setup to ensure Zoho QEngine can access these files during test execution.
Step 2: Connect your device to your machine and Zoho QEngine agent
To physically connect your device with Zoho QEngine, follow these steps:
Link your device to the machine where the Zoho QEngine agent is installed, either via cable or by ensuring both devices are on the same Wi-Fi network.
Enable Developer Mode on the device:
Go to Settings > Privacy & Security > Developer Mode.
![](https://help.zoho.com/galleryDocuments/edbsnb808470941bb11fe4ad6415524ba5a3b62d32cbeed1329aedc235eb9192efa188fb127550e60b762c71a2aa7683ed6f3?inline=true)
Toggle Developer Mode on. Your device may restart to apply this setting.
![](https://help.zoho.com/galleryDocuments/edbsn38d00aee24ed902362e1d39a8859ad0386df975fbaa27ea07b57536e6098e9f6536f5baa795308aa7b66c3bfdce08deb?inline=true)
Step 3: Enable developer options
- Once Developer Mode is enabled, go to Developer Options on your device.
![](https://help.zoho.com/galleryDocuments/edbsn10ddc19a6d2a39aef8f50bdfb0c602418faa24fed0ad8ad5f8b60dec0b2730e8e733feaaf5fdb27d719d258484e27754?inline=true)
- Enable UI Automation to allow Zoho QEngine to interact with the device’s UI elements during testing.
![](https://help.zoho.com/galleryDocuments/edbsn80eb05783059d40c8ea8cb8c734a625ac8cd0fbedf03780a1aeacbdcdda56fff5bc4f3ece3cc901882afea0c59b4af23?inline=true)
Step 4: Configure iOS settings in Zoho QEngine
Next, configure iOS settings in Zoho QEngine to recognize your device with the following steps:
Navigate to iOS Settings and click + Add Code Sign-In.![](https://help.zoho.com/galleryDocuments/edbsnd9c65b6e092421d69254833e2db462c09dd6cba8498429942fbe11effc2180bb34ebab48015791eff6b22da704364209?inline=true)
Provide a name for the configuration, enter the Certificate Name and Profile Path, and the location of the saved provisioning profile. Then select the desired device(s) from the dropdown list, which shows available agents and connected devices.
![](https://help.zoho.com/galleryDocuments/edbsnb075f410c81b1be20e9ce5db31e13666a1c6c57e4f0e647e5a28df70e16e3e9274a881f137ef81af4163c4e39a8cc1b4?inline=true)
Notes
- Ensure the certificate and provisioning profile are saved in the Zoho QEngine dependency folder to streamline configuration.
- A single provisioning profile is mapped to a single agent. Each provisioning profile is associated with a single agent, so make sure to assign the correct one.Click Create to finalize the configuration.
![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note: The format for the provisioning profile should follow the structure "com.zoho". Double-check that both the certificate and provisioning profile are up to date and verified for validity before proceeding.
4. Connect your virtual device with the agent
To use your virtual devices for automated testing, ensure that Xcode is installed on your machine, along with the required simulators.
Step 1: Set up the simulators
Xcode includes default simulator configurations. You can use these or create custom simulators if needed.
Option 1: Set up in Xcode
Open Xcode and go to Window > Devices and Simulators.
![](https://download-accl.zoho.com/webdownload?x-service=writer&event-id=oegvqd5253e9a7f7a405c9abbc48cecf7c005&x-cli-msg={"imgurl":"r-oegvqd5253e9a7f7a405c9abbc48cecf7c005-c3996b1ab0644ffa87c9609f1f5b737bh2iqd1e8syfj","rid":"oegvqd5253e9a7f7a405c9abbc48cecf7c005","module":"image"})
In the Simulators tab, click the + icon to add a new simulator.
![](https://help.zoho.com/galleryDocuments/edbsna4c14119a53b5a791387bcb3b6948a4aaa7a682ee65f7177ac6a8332a8955b91332e1ea411018219008ba965d1533fac?inline=true)
Give the simulator a name and select the desired device type and OS version.
![](https://help.zoho.com/galleryDocuments/edbsn912f1dfb9a8c72bb4436f34efc599779cb339b32b3cf522a6d8adb157a0f2e23a8f79df7519f518dd3247c9e2fa7bbdd?inline=true)
Click Create to finalize the setup.
Option 2: Set up in the Simulator application
Open the Simulator application on your Mac.
Go to File > New Simulator.
![](https://help.zoho.com/galleryDocuments/edbsn484bd7afdeefd63e415ed88dfac87df7122ac2ba468af02d61a87003d7ed9f2729b420426ee5707a691a15eeac2fc40d?inline=true)
Provide a name, choose the device type, and select the OS version.
![](https://help.zoho.com/galleryDocuments/edbsn321efc8681da3afd4c44858729f02441183d702cd7bc402448e4b1b7b71eac3f8b83409451e68cc3520a364de92e3a30?inline=true)
Click Create.
Step 2: Connect your simulators with the Zoho QEngine agent
To connect your simulators with Zoho QEngine:
Open the Simulator application on your Mac. This action automatically connects all available simulators with the Zoho QEngine agent.![](https://help.zoho.com/galleryDocuments/edbsnc7dbbe007721d388969b094e613da2b8a7a7ee600537e4b768402d577412fd35bf46481378862eec6411bd7b34cf45e8?inline=true)
6. What's Next
Previous step
To get started, it's helpful to familiarize yourself with testing on your iOS devices. Refer to the Understand Mobile Testing document to learn more. Next step
After configuring your desired devices to link physical devices and simulators to the local agent, you can use these configurations to perform iOS testing with Zoho QEngine. You can create test cases by using the recorder for quick generation or write them easily using Editor or Builder modes.