Upload symbol files through the Unity Dashboard

Upload symbol files through the Unity Dashboard to help diagnose issues in your project.

阅读时间3 分钟

最后更新于 3 个月前

Debugging symbols help you to better diagnose and fix problems. If your project is missing symbols, then these symbols might be missing from native crash reports. To fix this issue, you can manually add application symbol files to your project through the Unity Dashboard.

注意

You can also upload debugging symbols through CI/CD pipelines.

Upload symbol files to Diagnostics

To upload symbols, follow these steps:

In the Unity Dashboard, open your project.
In your project overview, select View Diagnostics.
Select Debugging Symbols.
Select Upload symbol file, and then choose a file from your device.

When you upload new symbols, there is a short period between the upload and when they are available for use. Wait at least five minutes before submitting a new crash. When they have been processed, any new reports should be generated with the proper symbolication.

Find missing iOS/macOS application symbols

When you build your application using Xcode, iOS/macOS places the symbols in a debug symbol file (dSYM) folder with a name similar to the following:

~/Library/Developer/Xcode/DerivedData/<build id>;/Build/Products/<build type>/appname.dSYM

A dSYM file is an Executable and Linkable Format (ELF) file that contains DWARF (debugging with attributed record formats) debug information for your application. DWARF is a debugging file format that supports source-level debugging.

To verify that the dSYM contains the correct UUID, run the

dwarfdump

command, and replace

appname

with the name of your application’s dSYM:

dwarfdump -u appname.dSYM/Contents/Resources/DWARF/appname

The following shows sample output from

dwarfdump

UUID: 5EEDCCD2-38E7-3E52-81EC-B90C7BCD6D91 (armv7) appname.dSYM/Contents/Resources/DWARF/appname

UUID: 583173FD-6697-3E3C-90DC-EA9147563A5B (arm64) appname.dSYM/Contents/Resources/DWARF/appname

注意

Dwarfdump is an application that prints DWARF information in a human-readable format. The output of dwarfdump reports the UUID in upper-case and with dashes. UUIDs are often displayed as all lower-case with no dashes. Either format can represent a UUID. For example,

5EEDCCD2-38E7-3E52-81EC-B90C7BCD6D91

and

5eedccd238e73e5281ecb90c7bcd6d91

represent the same UUID.

After you locate the correct dSYM folder, zip the entire folder and upload it to Diagnostics.

iOS, Bitcode, and the App Store

When you build your iOS app with Bitcode enabled and submit it to the App Store, Apple post-processes your build and creates a new binary. The new binary has a new UUID and a new corresponding dSYM. In this case, you must download the dSYM from iTunes Connect. It’s available in iTunes Connect at My Apps > Activity > All Builds > (choose your build).

When you upload your app to the App Store, check Include bitcode for iOS content and Upload your app’s symbols to receive symbolicated reports from Apple to enable the App Store to generate a new dSYM with the correct symbols.

After you download the new dSYM, verify that the UUID is correct using dwarfdump. Zip the file and upload it to Diagnostics.

For more information on symbolication, refer to Symbolicating Crash Reports (Apple).

注意

When you upload a new dSYM ID, reports aren't re-symbolicated. You must submit a new crash to generate a report using the new symbols.

文档

Development

User Acquisition

Monetization

工业

文档