[Cloud Build] Fix TextMeshPro Visual Glitches in Automated Builds
Solution
Unity 2021.x - Unity 6.3.x
Published Thu, Mar 26
TextMeshPro text elements appear correctly within the Unity Editor and local builds but exhibit visual inconsistencies when processed through Unity Cloud Build. Previous attempts to rectify this, such as explicitly including TMP shaders or modifying text component settings, have not resolved the discrepancy.
Resolve TextMeshPro display inconsistencies in Unity Cloud Build by aligning Unity editor versions and adjusting Anisotropic Textures to Per Texture in the Quality Settings.
Align the local Unity Editor version precisely with the Unity Cloud Build target version. Version discrepancies often lead to divergent asset processing, Shader compilation, and runtime behaviors. Cloud Build utilizes a specific editor version; if this differs from your local environment, TextMeshPro assets, particularly font atlases and materials, may be processed inconsistently, causing visual glitches. Ensure all team members operate on the identical editor version to prevent further variations.
- Open the Unity Cloud Build dashboard and confirm the Unity Version matches your
ProjectVersion.txtprecisely. - Navigate to
Edit>Project Settings>Qualityto access global texture overrides. - Locate the Anisotropic Textures setting and set it to
Per Textureso individual font assets control their own sampling. - Verify that your
TMP Essential Resourcesare correctly tracked in version control and not excluded by a.gitignoreorunitycloudbuildsettingsfile.
Additional Tips
- Force-include the
TextMeshPro/Mobile/Distance Fieldshader inProject Settings>Graphicsif text disappears entirely in cloud artifacts. - Ensure the Anisotropic Textures level on the specific
TextMeshProatlas texture is set to a value greater than 1 to maintain clarity at oblique angles.
Related Posts Haven't quite found a solution to your problem? We think these posts might help you.
Content inspired by a Unity discussion post.