Helper script

To help simplify your CI steps, we've created an example Python script that you can modify and run as part of your CI workflow, to capture performance data automatically from an Android device, with Arm Mobile Studio professional edition. This script generates the headless Streamline capture and handles starting and stopping of the application (steps 2 to 6 under Configure CI commands).

Download the helper script

Modify this script to set the following values:

  1. Set DEVICE_NAME to the ID of the current device. You can discover this using the adb devices command in a terminal.
  2. Modify the command-line options for GATORME_COMMAND to:
    1. Specify the name of the testcase application with --package
    2. Specify the name and location of the resulting capture file with --headless
    3. The script assumes that lwi_me.py, gator_me.py, gatord, libGLES_layer_lwi.so and the configuration file for this device, configuration.xml are in the current working directory. If they are not, modify the filenames to add the full paths.
    4. To use the correct Python command on macOS or Linux, comment out "py" and "-3" and uncomment "python3":
      # "py", "-3",
       "python3",
    5. Add any other command-line options you require for this run, such as the build name, timestamp or any frame capture options. For the full list of available command-line options refer to The lwi_me.py script options in the Performance Advisor user guide.
  3. Modify the ADB command-line options for APPLICATION_ADB_COMMAND, to specify the application to run.
  4. Set APPLICATION_EXIT_PATTERN to the logcat pattern emitted by the application when it finishes running the testcase. This is used to stop the application. Alternatively, if you've configured your application to exit at the end of the scenario, set this to None.
Previous Next