adb
is available with the Android SDK platform tools, which are installed as part of Android Studio. Alternatively, you can download them separately as part of the Android SDK platform tools.Edit your PATH
environment variable to add the paths to the Streamline and Mali Offline Compiler executables. This is so that you can run Streamline’s Streamline-cli -pa
command and Mali Offline Compiler’s malioc
command from any directory. This step is not necessary on Windows, as this is done automatically when Arm Performance Studio is installed.
On macOS, edit your /etc/paths
file to add the following paths:
/<installation_directory>/streamline
/<installation_directory>/mali_offline_compiler
On Linux, edit your PATH
environment variable to add the paths to the Performance Advisor executable. Add this command to the .bashrc
file in your home directory, so that this environment variable is set whenever you initialize a shell session.
PATH=$PATH:/<installation_directory>/streamline
PATH=$PATH:/<installation_directory>/mali_offline_compiler
The application must be compiled with debug enabled, as well as additional options to facilitate call stack unwinding by Streamline.
Build settings
.debuggable true
(isDebuggable = true
in Kotlin scripts) in the build configuration.Project Settings > Project > Packaging > Project
, and ensure that the For Distribution
checkbox is not set.To assist with readability and add context, you can optionally include annotations in your code, which are then displayed in Streamline.
On the device, ensure that Developer Mode is enabled.
Enable USB Debugging
under Settings > Developer options
. If your device asks you to authorize connection to your computer, confirm the connection.
Connect the device to the host through USB and approve the debug connection on the device when prompted.
To test the connection, run the adb devices
command in a command terminal. If successful, this returns the ID of your device:
adb devices
List of devices attached
ce12345abcdf1a1234 device
If you see that the device is listed as unauthorized
, try disabling and re-enabling USB Debugging
on the device, and accept the authorization prompt to enable connection to the computer.
Install the debuggable application on the device.