Install Streamline

This topic describes how to install Arm® Streamline Performance Analyzer as part of Arm Performance Studio.

About this task

If you are using Streamline as part of Arm Development Studio, see the instructions about installing and configuring Arm Development Studio in the Arm Development Studio Getting Started Guide

Before you begin

  • Download the free Arm Performance Studio install package for your platform at Downloads.

Procedure

  1. Install:

    • On 64-bit Windows:

      Arm Performance Studio is provided with an installer executable. Double-click the .exe file and follow the instructions in the Setup Wizard.

    • On macOS:

      Arm Performance Studio is provided as a dmg package. To mount the package, double-click the dmg package and follow the instructions. For easy access, the directory tree copies to the Applications folder on your local file system.

    • On Linux:

      Arm Performance Studio is provided as a gzipped tar archive. Use a recent version (1.13 or later) of GNU tar to extract the tar archive to your preferred location:

      tar xvzf Arm_Performance_Studio_<version>_linux.tgz

  2. Ensure you have installed Python 3.8, or later. Python is used to run the streamline_me.py script, which configures and collects data for headless captures on Android devices.

  3. Install Android Debug Bridge (adb). Arm Performance Studio uses the adb utility to connect to the target device.

    The adb utility is in the Android SDK platform tools, which are installed as part of Android Studio.

    You can also download the latest version of adb from the Android SDK platform tools site.

    Note

    Streamline uses the system adb path. To use a different adb path, replace the ADB Path in Window > Preferences > Streamline > External Tools.

  4. Add the path to the Android SDK and Python executables to your PATH environment variable.

Next steps

  1. To launch Streamline:

    • On 64-bit Windows:

      Open the Windows Start menu, navigate to the Arm Performance Studio <version> folder, and select the Arm Streamline <version> shortcut.

    • On macOS:

      Navigate to the <installation_directory>/streamline folder, and open the Streamline.app file.

    • On Linux:

      Navigate to the location where you extracted the package, go to the Streamline directory, and run the Streamline file:

      cd <install_location>/streamline
./Streamline

Note

If you are running Streamline on the command line, you can use the Streamline-cli script to run without triggering any GUI elements.

  1. Set up your target for Streamline:

  2. Profile your application: