Installing Mobile Object Spy Components

Qualitia Mobile object spy contains multiple components. You must complete the installation procedure to you start adding objects for mobile automation test cases.

You can install both the components mentioned below on the same machine or different machines based on the requirements.

Before you start Installations

Before you start installing Mobile Object Spy Agent or Mobile Object Spy Server, you must first configure the Mac or Windows machine to work with real devices, emulators, or simulators.

On Mac, you must have

XCode
Appium Dependencies
Java 8 - Oracle JDK / Open JDK

On your Windows machine, you must have

Android Studio (for emulators only)
Intel® HAXM (for emulators only)
Java 8 - Oracle JDK / Open JDK
Set the system environment variables

For more information on the same, please to the Prerequisites, Privileges and Configurations section.

Installing Mobile Object Spy Server

You must first install Qualitia Mobile Object Spy server on any machine in the network. This can be any Windows or Mac system. An ideal agent system is a Mac machine having Android Studio for emulators and Xcode for simulators. However, you may have separate machines (Windows and Mac) for emulators and simulators.

All the Qualitia clients should have access to port 4001 from the machine where you are installing Qualitia Mobile Object Spy server.

To install Mobile Object Spy Server:

Navigate to the folder where you have downloaded Qualitia Installlables.
Open Mobile Object Spy Server Folder.
Do one of the following:
1. If you are installing it on Mac, copy the .dmg file to any temporary location.
2. If you are installing it on Windows, copy the Setup.exe file to any temporary location.
Follow the onscreen instructions and complete the installation procedure.
To confirm the installation, go to services console and check whether the Qualitia.Mobile.Service is running (for Windows only)
or
You can try accessing Mobile Object Spy Server using Server URL in any browser.
Server URL is a combination of hostname/IP of the machine where Qualitia Object Spy server is installed along with the port 4001.
Sample URL may look like: http://192.168.25.77:4001 or http://localhost:4001.

Installing Mobile Object Spy Agents

After you install Qualitia Mobile Object Spy server, you can install Mobile Object Spy agent and connect mobile devices or create simulators/emulators to identify and add objects from Mobile applications.

This can be any Windows or Mac system with all the prerequisites installed for mobile application testing.

All Qualitia clients should have access to port 4001 from the machine where you are installing Qualitia Mobile Object Spy server.

You can install multiple mobile object spy agents (on different machines in the same network) connecting to single mobile object spy server.

Installing Mobile Object Spy Agent on Windows

Navigate to the folder where you have downloaded Qualitia Installlables.
Open Mobile Object Spy Agent Folder.
Copy the setup.exe file to any temporary location.
Double-click the setup.exe to install.
Follow the onscreen instructions and complete the installation procedure.
You can now access and launch Mobile Object Spy agent from system tray.
View image
To confirm the installation, go to services console and check whether the Qualitia.MobileAgent.Service is running (for Windows only)
or
You may hit the Qualitia Mobile Object Spy server URL in any available browser to confirm the installations.
Mobile Object Spy Server URL is a combination of hostname/IP of the machine where Qualitia Object Spy server is installed along with the port 4002.
Sample URL may look like: http://192.168.25.77:4002 or http://localhost:4002.

Installing Mobile Object Spy Agent on Mac

Navigate to the folder where you have downloaded Qualitia Installlables.
Open Mobile Object Spy Agent Folder.
Copy the .dmg file to any temporary location on the machine where you want to install this agent.
Double-click the .dmg to install.
Follow the onscreen instructions and complete the installation procedure.
Post installation, you can access the agent using icon from the top menu bar.

Configuring Mobile Object Spy Agents

After you install Mobile Object Spy agents, you must configure them to connect to Mobile Object Spy server you installed earlier. Multiple agents can connect to a single Mobile Object Spy server.

Configuring Mobile Object Spy Agent on Windows

After you install the Mobile Object Spy agent, you must configure it to connect to the mobile object spy server.

Post this configuration, all the existing Android virtual devices (emulators) get connected to this agent automatically.

To Configure Mobile object spy agent:

Launch Mobile Object Spy agent from system tray.
View image

You will get the following information from system/IT administrator.
Enter Keychain Path.
It is a path to the private development key exported from the system keychain.
Enter Keychain Password for authenticating to Keychain Path mentioned above.
Enter the Keystore Password.
Enter the absolute path to the chromedriver executable file which will be used while test case executions on mobile devices.
Enter the path to the directory where you have stored the chromedriver to be used test case executions on mobile devices.
Click Save.
On the subsequent screen, enter Mobile Object Spy Server URL.
Server URL is a combination of hostname/IP of the machine where Qualitia Mobile Object Spy server is installed along with the port 4001.
Sample URL may look like: http://192.168.25.66:4001 or http://localhost:4001 (if the mobile object spy server is installed locally).

Configuring Mobile Object Spy Agent on Mac

After you install the Mobile Object Spy agent, you must configure it to connect to the mobile object spy server. After this configuration, all the existing Android virtual devices (emulators) get connected to this agent automatically.