Launch manual measures (Android)

update 11 DEC 2024

In this section, you will find how to use the Test Runner in freerunner mode. It allows to run measurement steps for a duration of time, while you use the application you want to monitor.

Preparation

Device configuration with the Checklist Android device configuration
Validated access to your application or your website
Created application on 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
Choose the “Functional journey” mode
Enter needed information
Validate

Complete configuration files

Run the following command to initialise the configuration files config.yml and job.yml:

./testrunner freerunner init

The executable suggest a path to create these files. Press Enter.
The executable offer 2 connection modes (usb and wifi). Write the number that corresponds to the mode you want, and press Enter. The configuration files have been generated.

Modification of config.yml file

Complete the following fields:

target:
- serial: Identifier of the device (in case of usb connection)
- ip: IP address of the device (in case of wifi connection)
- paths:
  - adb: Path to the adb executable. Simply write "adb" if this command is already in your environment variables.
  - aapt: Path to the aapt executable. Simply write "aapt" if this command is already in your environment variables.
greenspector:
- server: https://core-saas-prod.greenspector.com
- token: Your token. To find your token, go to the Greenspector interface, click on your initials in the top right-hand corner, then click on "Account".
tcpdump:
- gatewayIP: IP of the gateway used to filter data
- networkInterface: Network interface used to detect data (wlp2s0...)
- keepPcap: true If true, it keeps the pcap file at the end of the measures

Go on Collect of data via network probe to have more details on tcpdump module and configure it.

Modification of job.yml file

Complete the following fields:

greenspector:
- application:
  - name: Name of your application
  - version: Tested version (date, app version, other)
job:
- monitoredPackages: Name of your application package. If you are measuring on a website, write "com.android.chrome".
- stepName: Name of the measurement step
- duration : Duration of the measurement step

Launch manual measurements on a local android device

Run one of the commands below:

./testrunner freerunner start # Using the parameters in the job.yml file
./testrunner freerunner start --duration 1m30s --stepName "Nouveau nom" # Replacing parameters

You can start manual actions on the device as soon as you see the message below:

============================================== 
YOU CAN START YOUR MANUAL TESTS ON THE DEVICE 
==============================================

You can stop these actions as soon as you see the message below: