Launch local test (iOS)

update 25 nov 2024

In this section, you will find how to launch a functional journey analysis on a local ios device as it has been described in the Getting started part.

1 Preparation
2 Complete files
3 Launch a functional journey analysis on a local iOS device

Preparation

Settings

In the display options :

Configure brightness adaptation in manual mode
Set phone sleep timer to maximum

In the language settings :

If possible, set the language to ‘English - United Kingdom’

Validate access to your application

On your local smartphone, check that you can use your application correctly: the mobile application reaches all your servers, and your web application accesses all your web services, which are necessary for it to work properly.

[Optional] Create an application on the Greenspector Studio

If it is not done and you want to save measures on the web interface, create an application on Greenspector Studio

Go to the Applications menu
Click on New Analysis
Enter needed information
Validate

Complete files

To launch tests, the testrunner executable needs config and job files. For more information about the content of these files, check the section Complementary files (iOS)

Modification of config.yml file

Edit the config.yml file you have just downloaded, replace :

${PHONE_UDID} by the UDID of your device. You can find it with the idevice_id command.
${PHONE_NAME} by the name of your device. For example, you can choose the version of your iPhone (ex : iPhone 14).
${GREENSPECTOR_CORE_SERVER_URL} by https://core-saas-prod.greenspector.com
${PRIVATE_TOKEN} by your token. To find your token, go to your account

Modification of job.yml file

Edit the job.yml file you have just downloaded, replace :

${APP_NAME} by the name of your application.
${APP_VERSION} by the tested version (date, app version, other).
In the testFiles field, enter the path to your test scenario
${PAUSEDURATION} by 1000 (1000 ms, i.e. 1 second)
${PAUSEAFTERLOAD} by 1000 (1000 ms, i.e. 1 second)

Launch a functional journey analysis on a local iOS device

Launch of a functional journey on a local device needs :

GDSL script
job.yml & config.yml
iPhone connected to the wifi network of the PC

Connect the iPhone via USB:

Connect the iPhone to the PC with a USB cable
If you have a pop-up on your phone to trust your computer, accept it
Run the following command to verify that the libimobiledevice library detects the iPhone:

idevice_id

The UDID of the device should appears.

Test launch

Testrunner is now ready to be launched. Simply launch it to start a test:

Go in the folder where job and config files are located
Launch the following command in the terminal

testrunner

Testrunner automatically recognizes config.yml and job.yml.

If different names or path are used, please specify them with: testrunner -c path/myconfig.yml -j path/myjob.yml

During the test execution and until test end:
- Don’t close terminal
- Don’t interact with device. Check device screen to see the test running.

Results

The Testrunner prompts the result at the end of the test. In case of failure, error’s line is given to help to adapt GDSL file. Results are available:

In your working directory with greenspector/dd-mm-yyyy XXhXXm/tests-results/results.txt
On Greenspector Studio if online is true in job.yml.

Version change

It is possible to change version of results of measure as many times as needed. It can be a date, a new version of the application or website, a different journey, a functionality test, different test conditions, etc.

Change in job.yml :

${APP_VERSION} by the tested version.

If you registered measures are stored online on Greenspector Studio by online=true in job.yml, versions, versions are visible in the Meter tab.