기술 자료

​
​

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
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • Environment variables

    • Usymtool flags


이 페이지의 문제 보고