Connect Streamline to your device

Use the Start view to connect Streamline to an Android device and application that you want to collect data from.

Before you begin

Before you can connect Streamline to a device, ensure you have followed the steps in Set up your device.

Procedure

  1. Launch Streamline.

  2. In the Start view, select Android (adb) as your device type, then select your device from the list of detected devices. If you do not see your device in the list, check that it is connected properly through USB. See Set up your device for more information.

  3. Wait a few moments for the list of available packages to populate, then select the package you want to profile from the list of packages available on the selected device.

    Note

    • To enable the Start capture button when you select a non-debuggable package for profiling, you must be running a development device with root access.

    • Applications must have at least one MAIN or launchable activity.

  4. Optionally, enter arguments for activities that require additional configuration, or for activities that cannot be listed in the table:

    1. Select the Override activity check box, and enter a suitable name for the activity.

    2. In the Arguments text box, enter the arguments that you want to run on the selected package.

      You can enter multiple arguments passed on a single line. See valid argument options in https://developer.android.com/tools/adb#IntentSpec.

      If the arguments are valid, when you click Start capture, the arguments are stored in history so that you can select them again from a drop-down menu. A maximum of 10 arguments are stored before they are overwritten.

      Example of arguments to run on the selected package.

  5. Select the counter template that you want to use to review performance of your CPU and GPU:

    • To use the most appropriate counter template for your Arm GPU, select the Capture Arm GPU profile checkbox.

    • To use the default counter template, which captures basic information such as CPU and memory usage, but no GPU data, clear the Capture Arm GPU profile checkbox.

      Note

      If your device does not contain an Arm GPU, the Capture Arm GPU profile checkbox is disabled.

    • To use a different counter template, see Choose a counter template.

Next steps

For more information about how to capture a profile, see Capture a profile.