Add debug symbols from Unity

To help you to identify expensive parts of your application, add debug symbols to show function names in the Functions and Call Paths views in Streamline. This task explains how to add debug symbols from Unity.

Before you begin

  1. Ensure your application is debuggable.

  2. Ensure your Unity project supports Android. See https://docs.unity3d.com/Manual/android-sdksetup.html.

  3. Set your scripting backend to IL2CPP, which converts the scripts into a format that is supported in Streamline.

Procedure

  1. In Unity, open the Build Settings window for your Unity project, click File → Build Settings.

  2. In Platform, select Android.

  3. Set Create symbols.zip to Debugging.

  4. Select the Development Build check box.

  5. Compile the application in either Debug mode or Release mode:

    In Debug mode:

    • The Android APK contains the required debug information for Streamline.

    • If the application is built for ARM64 only, you can attach the Android APK in your Streamline capture.

    • Alternatively, you can attach the .zip file that contains the debug symbols from Unity to your Streamline capture.

    In Release mode:

    • Set Create symbols.zip to Debugging.

    • Attach the contents of the .zip file to your Streamline capture.

  6. Select any other options that are relevant to your build.

  7. Select Build.

Results

The build process generates the Android APK and a .zip file that contains the debug symbols files. Add either the APK or the contents of the debug symbols .zip file to Streamline.

Next steps

You can now add the debug symbols file when you analyze a capture of your application in Streamline. See Select images and libraries for profiling in the Arm Streamline User Guide.