During the build process, Unity removes unused or unreachable code through a process called managed code stripping, which can significantly decrease your application’s final size. Managed code stripping removes code from managed assemblies, including assemblies built from the C# scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary in your project, assemblies that are part of packages and plugins, and assemblies in .NET Framework.
Unity uses a tool called the Unity linker to perform a static analysis of the code in your project’s assemblies. The static analysis identifies any classes, portions of classes, functions, or portions of functions that can’t be reached during execution. This analysis only includes code that exists at build time because code generated at runtime doesn’t exist when Unity performs the static analysis.
You can configure the level of code stripping Unity performs for your project in the Unity Editor. You can also provide annotations in the form of attributes or a special XML configuration file to instruct the Unity linker about which parts of your code base to preserve.
Topic | Description |
---|---|
Managed code stripping and the Unity linker | Understand how the Unity linker analyzes and marks elements of your code before stripping. |
Configure managed code stripping | Configure managed code stripping in the Unity Editor and understand what Unity does at each stripping level. |
Preserving code using annotations | Use annotations in the form of C# attributes or a link.xml file to specify which parts of your code the Unity linker should not strip. |
Link XML formatting reference | Understand how to format a link.xml file, including supported XML elements and attributes and examples of their usage. |
Unity linker marking rules reference | Understand the marking rules the Unity linker applies at each managed stripping level to determine which parts of your code assemblies to strip. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.