Versions Compared

Version Old Version 2 New Version Current
Changes made by

Maeva Rondeau

Maeva Rondeau

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

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

Preparation

...

Expand
titleComplete files
Info

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 (Android).

You will need some information to launch functional journey analysis on local device :

Modification of config.yml file

Edit the config.yml file you have used for test, fill or replace :

  • ${PHONE_IP} by your phone's IP address

  • ${PHONE_PORT} by 5555

  • ${PRIVATE_TOKEN} by your token. To find your token, go to the your 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
    ipFilters:
    apple: true

Info

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

Modification of job.yml file

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

  • ${APP_NAME} by the name of your application.

  • ${APP_VERSION} by the name of your version.

  • In the testFiles field, enter the path to your test scenario

  • ${MONITORED_PACKAGE} by the name of your application package. If you are measuring on a website, write "com.android.chrome".

  • ${PAUSEDURATION} by 30000 (30000 milliseconds, i.e. 30 seconds)

  • ${PAUSEAFTERLOAD} by 1000 (1000 milliseconds, i.e. 1 second)

  • online=true

  • skipsetupphone=false

  • tcpdump=true

  • iterations=3

Note

To launch final measurements, take care about these parameters in job.yml :

  • iterations: 3

  • online: true

  • config-skipsetupphone: false

  • PAUSEDURATION: 30000

  • PAUSEAFTERLOAD: 1000

  • tcpdump:true

Launch a functional journey analysis on a local Android device

Launch of a functional journey on a local device needs :

...

Expand
titleConnect smartphone in adb WiFi

Activate ADB Wifi

  • Connect your device through USB

  • Verify ADB connection :

Code Block
adb kill-server
adb devices
Info

adb kill-server is not mandatory, but restart adb helps to prevent connection problems.

  • The device should be detected. If it’s the first connection, a pop-up Allow USB debugging?should appear on device. Click on Allow:

  • Run the following command to enable network connection:

Code Block
adb tcpip 5555

  • Disconnect USB cable from your device

  • Run the following command to establish network connection:

Code Block
adb connect [IP]:5555
Info

Please replace [IP] with the device IP address which can be found in the phone connection settings.

  • Run the following command to verify network connection:

Code Block
adb devices

You should see your device now identified with its IP.

Note

Please disconnect the device from the USB cable to avoid altering the energy measurements by supplying power from the PC.

Test launch

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

...

  • During the measurement execution and until measurement end:

    • Don’t close terminal

    • Don’t interact with device. Check device screen to see the measure running.

Results

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

...