文档

​
​

Development

User Acquisition

Monetization

工业

Unity Cloud

Get Started

Asset Manager SDKs and services

Open Unity Dashboard

Unity Cloud

此页面不支持所选语言。
​
​
Unity Dashboard
  • Accounts
  • Organizations
  • Projects
  • Products
  • Billing
Developer Data
  • Introduction to the Developer Data Framework
  • Get started
  • View Diagnostics for your project
    • Access Diagnostics
    • View events leading to a crash
    • Manage reports
      • Set up custom reports
      • Test reports
      • Debugging symbols
        • Introduction to debugging symbols
        • Upload symbol files through the Unity Dashboard
        • Upload debugging symbols from CI/CD pipelines
        • Runner examples for uploading debugging symbols through CI/CD pipelines
        • Troubleshooting symbol file uploads from CI/CD pipelines
        • Symbol file uploads API reference
    • Diagnostics page reference
  • Privacy and consent
Unity Asset Manager
  • What's new
  • Asset Manager web
  • Asset Store
  • Manage Assets in the Editor
  • Unity Version Control
  • Developer documentation
Unity Pipeline Automation
  • About
  • Get started
  • Pipelines
  • Automations
  • Monitor jobs
  1. Unity Cloud Documentation
  2. Developer Data framework

Symbol file uploads API reference

Find variables and flags you can use to call the API directly or build custom integrations to upload debugging symbols.
阅读时间2 分钟
最后更新于 3 个月前

If you want to call the Unity Services API directly or build a custom integration to upload debugging symbols, then use the following information to set the required variables and flags.
注意
You can also upload debugging symbols through CI/CD pipelines.

Environment variables

Environment variables are automatically set by the upload scripts. If you want to build a custom integration, then you must set the following variables before you run
usymtool
.

Variable

Required

Value

USYM_UPLOAD_AUTH_TOKEN
YesThe
AuthToken
value from the token API response
USYM_UPLOAD_URL_SOURCE
Yes
https://perf-events.cloud.unity3d.com/url
LZMA_PATH
No (auto-set by the script)Path to Unity's bundled
lzma
binary. Required by
usymtool
on Unity 6.2 and earlier for symbol compression. Starting with Unity 6.3,
usymtool
uses built-in gzip compression and this variable is ignored. The script sets this automatically.

Usymtool flags

Use the following flags to customize how the
usymtool
script operates and which files it uploads.

Flag

Required

Description

-symbolPath
YesSets the path to the directory or file that contains the debug symbols to upload.
-il2cppOutputPath
NoSets the path to the IL2CPP-generated C++ output directory, which enables C# line number mapping.
-il2cppFileRoot
NoSets the root path to the IL2CPP files as compiled into the native binary. If blank, it matches on the full paths from
-il2cppOutputPath
.
-forceUpload
NoReuploads files even if they already exist in storage.
-filter
NoProcesses only files whose names match a regular expression.
-excludeFilter
NoSkips files whose names match a regular expression.
-log
NoSets the log file path. This path defaults to
~/Library/Logs/Unity/symbol_upload.log
on macOS, and to
%LOCALAPPDATA%\Unity\Editor\symbol_upload.log
on Windows.

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • Environment variables

    • Usymtool flags


报告此页面的问题