Upload debug files for crash analytics
Updated: Dec 19, 2024
If you have the debuggable library files (also known as debug symbol files) for your Meta Quest app, you can upload them to see symbolicated stack traces in the
Crash Analytics dashboard.
Where are the debug symbol files?
Debug symbol files are saved in your project folders when you build your APK files. They typically match the filename pattern *.so, *.sym.so, or *.dbg.so, and these are the files we use in Crash Analytics to symbolicate stack traces. For example, if the library your project creates is called libunity.so, the symbolicated version of it might have the same name, libunity.so, or it might be named libunity.sym.so or libunity.dbg.so.
Engine | Location of debug symbol files |
---|
Native | projectFolder/obj/local/armeabi-v7a/ |
Unity | IL2CPP projects: projectFolder\Temp\StagingArea\libs\armeabi-v7a\ mono projects: C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\armeabi-v7a\ |
Unreal | projectFolder\Binaries\Android\projectName_Symbols_v1\projectName-arm64 |
Warning:
Don't change the name of the debug symbol files. Crash analytics uses filename matching to match the library name in your app with the matching debug symbol file ending in .so, .sym.so, or .dbg.so. These are the only allowable filename extensions for debug symbol files.If these debug symbol files have been deleted since the last time you built the project, it is sometimes possible to rebuild them, provided that you have changed absolutely nothing in the project since the time you uploaded the app into a release channel. Even a small difference can create a mismatch between an uploaded app binary and the rebuilt debug symbol files, which can result in missing symbols in stack traces.
Caution:
Do not close the Unity Editor until after you copy all the debug symbol files to a permanent location, because closing the editor might delete them.Uploading debug symbol files for new builds
You can upload debug symbols at the same time as you upload a new binary build using Unity, Unreal, or the Oculus Platform Command Line Utility.
Unity: Debug symbols for new builds
The OVR Platform Tool in Unity is configured to automatically upload debug symbols for your app whenever you upload an APK file to a release channel. The
Debug Symbols Directory defaults to the standard symbol path for your project built with IL2CPP scripting backend. If your project is built using the Mono scripting backend, you can select the relevant symbol path. For more information, see
Upload App to the Store.