Now that you have seen an example Streamline capture, you can use it with your own application.

Build your application

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

The Target setup guide for Android provides appropriate instructions for C++ or Java applications.

These settings are enabled as default within Unity when Development Build is selected in Build settings.

You can optionally provide annotations to your code which will be displayed in the Streamline report, to assist readability of the report.

Open-source projects

Arm provides open-source projects that can be used by application developers as part of their development.

Set up Android device

Ensure that Developer Mode is enabled, then enable USB Debugging under Settings > Developer options.

Connect the device to the host through USB and approve the debug connection when prompted.

If the connection is successful, running the adb devices command on the host returns the ID of your device, and you can run adb shell.

Install the debuggable application.

Unity applications

To set Unity applications to be debuggable, enable Development Build in Build Settings. Image Alt Text: Build Settings

Unity Build Settings

Connect to the device

In the Streamline Start view, select Android (adb) as your device type, then select your device from the list of detected devices. Image Alt Text: Connect to device

Connect to the device

This will install the gatord daemon and connect to the device.

Wait for the list of available packages to populate, then select the one you wish to profile from the list of available packages on the selected device.

Select an appropriate counter template for the GPU present in your device.

Set location to store data (optional)

Navigate to Window > Preferences > Data Locations, and configure location to store data. New reports will be created in the topmost folder specified.

Profile application

Click on Start capture to start capturing profile data from the target.

Start the application on the device, and interact as desired for the profiling run you wish to do.

When satisfied, simply click on Stop capture in upper-right of screen. Image Alt Text: Stop capture

Stop Capture

Streamline will stop capturing data, remove the daemon, and process the captured data.

Double-click on the capture to display in the timeline.

Back
Next