Connect Streamline to your device
Arm provides a Python script,
gator_me.py that installs an agent,
gatord, on your device. This enables Streamline to connect to unrooted Android devices and collect data. Follow these steps to run the script and connect Streamline to your device.
- On your host machine, navigate to the Streamline installation directory,
<install_dir>/streamline/gator/where you will find the
- Run the
gator_me.pyscript with the
--daemonoption, to supply the path to the
gatordbinary that will be installed on the device. There are two versions of
gatord, for 32-bit or 64-bit architectures, located in the following directories:
<install_dir>/streamline/bin/arm/for 32-bit architectures.
<install_dir>/streamline/bin/arm64/for Armv8 64-bit architectures.
python3 gator_me.py --daemon <install_dir>/streamline/bin/arm64/gatord
- 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.
gator_me.pyscript does the following:
- Kills and removes
gatordand removes any counter configuration file that was previously created.
- Enables perf profiling.
gatordto the target.
gatordinside the Android application sandbox.
- Configures port forwarding.
- Waits for you to configure and perform the capture in Streamline.
- When the capture is complete, it kills and removes
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
python3 gator_me.py --package com.mycompany.myapp --daemon <install_dir>/streamline/bin/arm64/gatord
- Kills and removes
- Launch Streamline:
- On Windows, from the Start menu, navigate to the Arm Mobile Studio folder, and select the Streamline shortcut.
- On macOS, go to the
<install_dir>/streamlinefolder, and double-click the
- On Linux, go to the
<install_dir>/streamlinefolder, and run the
- In the target name field, enter localhost:8080. This value is the local TCP port that is specified in the