Profile an Android application

Overview Before you begin Configure your device Connect Streamline to your device Choose a counter template Capture a profile Analyze your capture Disconnect Streamline from your target Next steps
Single Page

Connect Streamline to your device

Arm provides a Python script, gator_me.py that installs a daemon, gatord, on your device. Streamline uses this daemon to connect to unrooted Android devices and collect data. Follow these steps to run the script so that Streamline can communicate with your device.

  1. On your host machine, navigate to the Streamline installation directory, <install_dir>/streamline/gator/ where you will find the gator_me.py script.
  2. Run the gator_me.py script with the --daemon option, to supply the path to the gatord binary that will be installed on the device. For example: 
    python3 gator_me.py --daemon ../bin/arm64/gatord
    There are two versions of the gatord, for 32-bit or 64-bit architectures, located in the following directories:
    • <install_dir>/streamline/bin/arm64/ for Armv8 64-bit architectures.
    • <install_dir>/streamline/bin/arm/ for 32-bit architectures.
  3. The script will return a numbered list of the Android package names for the debuggable applications that are installed on your device. Enter the number of the package you want to profile.

    Alternatively, if you know the Android package name of the app you want to profile you can specify it when running the script, using the --package option.

    python3 gator_me.py --package com.mycompany.myapp --daemon ../bin/arm64/gatord

    IMPORTANT: When you've finished capturing data from this device, switch back to the terminal running the gator_me.py script and press any key to terminate it. The script kills all processes that it started and removes gatord from the target.

  4. Launch Streamline:
    1. On Windows, from the Start menu, navigate to the Arm Mobile Studio folder, and select the Streamline shortcut.
    2. On macOS, go to the <install_dir>/streamline folder, and double-click the Streamline.app file.
    3. On Linux, go to the <install_dir>/streamline folder, and run the Streamline file:
      cd <install_dir>/streamline
       ./Streamline
  5. Use the Start tab in Streamline to select your device. Select Or, choose an existing target, then select your device from the list.
    Connect to your device in Streamline
  6. Before starting the capture, choose Configure Counters to choose a counter template.

Previous Next