Launch local test (iOS)

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 App

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

• Go to the Applications menu

• Click on Add an application

• Enter a name, a first version and description (not obligatory)

• Validate

Complete files

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://app.greenspector.com

• ${PRIVATE_TOKEN} by your token. To find your token, go to https://app.greenspector.com, click on your name at the top right, then click on the “Preferences” menu.

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:

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

• 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.

Open

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 https://app.greenspector.com/app/list by online=true in job.yml, versions, versions are visible in the Meter tab.