1. Download Arm Performance Studio and follow the installation instructions in the Release Note .
  2. Ensure you have installed Android Debug Bridge (adb) . 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.
  3. Performance Advisor uses a Python script to connect to your device. To run this script, you will need Python 3.6 or later installed.

Build your application

The application must be compiled with debug enabled, as well as additional options to facilitate call stack unwinding by Streamline.

  • To set Unity applications to be debuggable, enable Development Build in Build settings.
  • In Android Studio, use a build variant that includes debuggable true (isDebuggable = true in Kotlin scripts) in the build configuration.
  • In Unreal Engine, open Project Settings > Project > Packaging > Project, and ensure that the For Distribution checkbox is not set.
  • For C++ or Java applications, refer to the Target setup guide for Android for instructions on how to compile your application with the right options.

To assist with readability and add context, you can optionally include annotations in your code, which are then displayed in Streamline.

Set up the Android device

  1. On the device, ensure that Developer Mode is enabled.
  2. Enable USB Debugging under Settings > Developer options. If your device asks you to authorize connection to your computer, confirm the connection.
  3. Connect the device to the host through USB and approve the debug connection on the device when prompted.
  4. 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.
  5. Install the debuggable application on the device.