TextMesh Pro Migrating from Legacy / Asset Store to Package Manager Releases

No matter what I try, following the upgrade steps fails for our project (repeated 3x now) and doesn't find any files to remap even though I'm seeing the following matching GUID values in the files themselves.

Anonymous Pro SDF.asset:

%YAML 1.1
%TAG !u! tag:unity3d.com,2011:
--- !u!114 &11400000
MonoBehaviour:
m_ObjectHideFlags: 0
m_PrefabParentObject: {fileID: 0}
m_PrefabInternal: {fileID: 0}
m_GameObject: {fileID: 0}
m_Enabled: 1
m_EditorHideFlags: 0
m_Script: {fileID: -667331979, guid: b5bd0d848a86e48409fe56688d66ecb5, type: 3}
m_Name: Anonymous Pro SDF
m_EditorClassIdentifier:
hashCode: -1168836081

PackageConversionData_Assets.json:

{
"referencedResource": "TMP_FontAsset.cs",
"target": "fileID: -667331979, guid: b5bd0d848a86e48409fe56688d66ecb5",
"replacement": "fileID: 11500000, guid: 71c1514a6bd24e1e882cebbe1904ce04"
},

GUID remapping finds no files to change even though I can see it evaluating the SDF files. The files themselves all show "The associated script cannot be loaded" error, but I don't see any related errors in the console.

No idea if it's related, but I do see two of this error in the console:

NotImplementedException: The method or operation is not implemented.
System.Environment.FailFast (System.String message) (at <a8ed250850854b439cedc18931a314fe>:0)
<Module>.o*k-lj.nkm+nl--lm*.
nl-,*nj*nj
,no-. (System.String ) (at <d7d768327f4f40bfa66e8d37bff64fd0>:0)
<Module>.l+nml.o-,jol*l
n++
n*-j+n-k-
n.,. (System.Object ) (at <d7d768327f4f40bfa66e8d37bff64fd0>:0)
System.Threading.ThreadHelper.ThreadStart_Context (System.Object state) (at <a8ed250850854b439cedc18931a314fe>:0)
System.Threading.ExecutionContext.RunInternal (System.Threading.ExecutionContext executionContext, System.Threading.ContextCallback callback, System.Object state, System.Boolean preserveSyncCtx) (at <a8ed250850854b439cedc18931a314fe>:0)
System.Threading.ExecutionContext.Run (System.Threading.ExecutionContext executionContext, System.Threading.ContextCallback callback, System.Object state, System.Boolean preserveSyncCtx) (at <a8ed250850854b439cedc18931a314fe>:0)
System.Threading.ExecutionContext.Run (System.Threading.ExecutionContext executionContext, System.Threading.ContextCallback callback, System.Object state) (at <a8ed250850854b439cedc18931a314fe>:0)
System.Threading.ThreadHelper.ThreadStart (System.Object obj) (at <a8ed250850854b439cedc18931a314fe>:0)
UnityEngine.UnhandledExceptionHandler:<RegisterUECatcher>m__0(Object, UnhandledExceptionEventArgs)

I'm not sure what else to try. I've re-run the process several times very carefully and end up stuck at this step no matter what.

Any help would be much appreciated.

 

Thanks for the Sunday reply!

I'm upgrading from Unity 2017.4.22f1 to 2019.2.0f1, and TextMesh Pro 1.0.55 to 2.0.1.

I tried upgrading from a fresh clone of our repo again. I replaced the GUID conversion files before running it the first time and that seemed to get it to recognize them, which is progress! Not sure why that didn't work before, but that likely solves my TextMesh Pro issues.

After fixing a few other broken things (minor PostProcessing API changes, DoTween and Zenject had a couple errors and needed an upgrade), it seems I'm still stuck on those DLL errors (NotImplementedException) so all my TextMesh Pro components still show as "The associated script cannot be loaded". I'll keep fighting with that next in the hope of seeing my TextMesh Pro components updated.

 

Hi Stephan, I have a live game (Storm Wars) published on 5 platforms, it's been live for a few years and is currently running on Unity 2017.4.30. Because of the new Android requirements for 64-bit builds, I am being forced to update the engine. Anyway, I have tried migrating to 2018.2.21 using this process and everything went well except for one serious problem - although the GUID remapping tool seemed to successfully identify and remap all the fonts and assets and the game is running fine, every font I have in the game now uses the default emojione sprite sheet instead of the custom ones that were assigned to the prefab. I have probably several hundred places in the game where I will need to go and reassign the sprite sheets manually unless I can find a solution to this - do you have any idea what might be happening here?

Thanks for any help!

 

Thanks Stephan, I believe that was mostly the issue. I did for whatever reason have to regenerate my text sprites because they were missing a material(?) and will have to readjust the kerning for them, but everything else looks ok. Appreciate the fast response!

 

Can anyone point me in the direction of how I change font on the fly in code please?
After a lot of searching I found this
<code>
TMP_Text tmp = this.GetComponent< TMP_Text >( );


TextMeshProFont m_FontAsset = Resources.Load("Fonts & Materials/ARIAL SDF", typeof(TextMeshProFont)) as TextMeshProFont;
tmp.font = m_FontAsset;
</code>

However I think this might be for an old build of tmpro as I get the below error. I should add I got using "TMPro"

The type or namespace name 'TextMeshProFont' could not be found (are you missing a using directive or an assembly reference?)

Thanks

 

Hi again Stephan, really appreciate the ongoing support. I love TMP but i'm still having a lot of headaches upgrading my game through successive unity versions. I did make it through 2018.2 and 2018.3 though I had to go through every single text object in the game and strip the inline graphics objects (wishing this was done automatically with the migration tool). After that, things looked great in 2018.3.1 but due to some issues with audio on Android I'm trying to upgrade again. I went to 2018.4.6f1 and now all of the fonts in the game are aligned incorrectly. Even stranger, when looking in the inspector the alignment for every font in the game shows upper left, though it's displaying like center right until I touch one of the alignment controls. I can of course go through the thousands of TMP objects and adjust them but I'm hoping there's a workaround. Has anyone else seen this problem?

 

Ok I made the changes you suggested above (the code change and added the TMP_Compatibility file) but they didn't seem to have any effect at all. Do I need to make these changes first and then try upgrading the project again from 2018.3.1->2018.4.6? Also, I would be happy to share a sample to test but I don't really know how, my assets folder alone for this game is >3.5 GB and the project folder is 14.5 GB.

 

Hi,

Okay, I followed your tutorial. This piece got me slightly confused:

Seems contradictory?
I just moved on and deleted that folder anyway.

You were not kidding when saying the updater tool would be a memory hog. I made the mistake of running it on Assets and I had to kill Unity halfway through the scan as it stalled when it reached my Scenes folder, but my computer is not very powerful either.
So I isolated the latest scene, the one I'd work from, and put it in its own folder to target it.
I'll complete further updates ad hoc if I spot issues but it seems okay, my GUI TMP is back. I'm satisfied.
Thank you.

Other subtopics now.
Must I can keep serialization to 'force text'? It seems to be a better choice if done early in a project. I'm not doing any version control though.
Also, when preparing the scene and player settings in 2017, I had switched to .NET 4.x, which was marked as experimental.
In 2019, it's back to .NET 2 standard 2.0. I also use IL2CPP. For the info, with this parameter, TMP does display the text.

Is it obligatory? Are all mobile devices capable of handling it? I ask because I'm not knowledgeable enough on this.

 

Hello,

I use I2 localization to localize text with Text Mesh Pro. But all GameObject using both are not converting to new TMP.
Others with only TMP have been converted.

I2 localization 2.8.10f1
TMP 1.4.1
Unity 2018.4.8f1

What I can do to solve this? I will not reassign manually and rollback to Unity 2017 if not possible.


[EDIT]
does not seems to be related to I2 Loclization.

I have include Prefabs folder in the search (because my game menus are Prefabs) and the converting tools convert prefabs that .unity contains instance.

But some text have a missing script instead of the new TMP_Text . Think I must reassign manually

[EDIT 2] I will try to delete prefabs of my menus before migrating.

 

Hi there! I'am trying to upgrade from 2017.4.32f to 2018.4.9f.
I've done all steps from 1st post, but can't pass through 6 point. On every "using TMPro;" i got "The type or namespace name 'TMPro' could not be found (are you missing a using directive or an assembly reference?)" error.

 

There are no other errors, except these two:"The type or namespace name 'TMPro' could not be found" and "'The type or namespace name TextMeshProUGUI' could not be found". I've done every point:close editor, delete cache folders, delete library and sln files and errors still here.

 

I deleted two global cache subfolders form your link. With new project tmp works fine. I'am using Rider.
I've tried with 2018.2, 2018.1 and 2019.2 today and got the same result.

 

I have a bunch of assets...so how i should fill bug report info so that you can identify him?

 

I had the issue that the script GUID can not be fixed by mapping tool. And it is solved by new PackageConversionData.json now.

In case no one has mentioned, I spent some time to figure out that replacing the files in AppData/Local/Unity/.. may not be enough. If you already opened your Unity project with the new TextMeshPro, you has the cache in your project/PackageCache/com.unity.textmeshpro. And you need to update the two json files in that folder.

I know it's a dumb mistake, and but I don't want anyone to waste time on this.

 

I've had a problem updating and here is my solution.

For most of the TMP files the GUID System worked. I used the Alternative GUID Mapper as well and that even did work for a few so I'm guessing the problem in my project was related to this sort of issue with Runtime GUID bound.

What I looked at in Git was the files that did convert over went from:

 m_Script: {fileID: 1453722849, guid: 89f0137620f6af44b9ba852b4190e64e, type: 3} 

GUID Mapper changed to this:

  m_Script: {fileID: 11500000, guid: f4688fdb7df04437aeb418b961361dc5, type: 3}

My project still had many prefabs and scenes with missing script errors where Text Mesh Pro UGUI's were before. When opening the problematic .prefab's with a text editor such as sublime I noticed this:

 m_Script: {fileID: 1453722849, guid: b5bd0d848a86e48409fe56688d66ecb5, type: 3}

using the same fileID:1453722849 as the TMP script that was converted before.

Knowing that 100% the original working converted prefab was using the same Text Mesh Pro UGUI I used Sublime Text to Find and Replace all instances of

m_Script: {fileID: 1453722849, guid: b5bd0d848a86e48409fe56688d66ecb5, type: 3}

With the working code:

  m_Script: {fileID: 11500000, guid: f4688fdb7df04437aeb418b961361dc5, type: 3}

Save All and Reopen project

This fixed the problem!

 

Had a similar trouble like some of you have writting in this loooooooong thread with my Visual Studio (2017 15.9.17 and 2019 16.3.7) and Unity (2018.412f1 LTS and 2018.4.11f LTS).
My steps for reproducing:

• Created a fresh unity project (C:\my-unity-app\)
• Switched to UWP
• Removed packages which are not relevant for my project. Result: only TextMesh Pro is left in the package manager
• Imported TMP Essential Ressources
• Opened C# Project
• => Visual Studio throws out a lot of errors (56 errors) in the IntelliSense output: all TMP *.cs files are missing.
• e.g.

  [Fehler] [B]Die Datei "C:\my-unity-app\Packages\com.unity.textmeshpro\Scripts\Runtime\TextMeshProUGUI.cs" konnte nicht gefunden werden[/B]

  Translation =>Could not find file.

I tried a lot of fixes including reinstalling Visual Studio, switching Visual Studio versions, reimporting packages, cleared all caches... to sum up: I spent hours without finding any solution because I did not see the obvious solution to my problem!
The *.cs-files were simply missing in the package folder (C:\my-unity-app\Packages\com.unity.textmeshpro), so I copied them and tadaaaaa... saved my day

I am not sure...
... Either in some step of the package manager process the *.cs files shall be copied from the libary-cache (e.g. C:\my-unity-app\Library\PackageCache\com.unity.textmeshpro@1.4.1)
into the package folder (e.g. C:\my-unity-app\Packages\com.unity.textmeshpro) and this did not happen....
... or my Unity Installation is broken/buggy...
... or my Visual Studio is broken/buggy...

Nevertheless, manually copying the *.cs-files solved my problem.

Keeping my fingers crossed, that this will not lead to any errors later on.

 

Hi is there a way that alignment will not reset? or the fonts?

 

Hey there. Wanted to report that this 100% worked, going from 1.0x -> 2.0. Thank you very much. I was dreading migrating.

 

Hi there !

I'm currently migrating a medium size game from Unity 2017.4 (no PackageManager) to Unity 2018.4 (TMP 1.4.1).
I followed each steps on this topic, however I had the two following issues :

- In my animation clips, bindings on "m_fontColor" property of TMP components were all lost. Bindings were pointing at "UnityEngine.MonoBehaviour" (parent) scripts instead. I made the script attached to this post to fix animation clips. Hope it can help someone else (Use this script after using TMP remaping tool).

- As JanusAnderson, many of my TextMeshProUGUI component lost alignement values. This happened for almost all disabled gameObject in my prefabs. Unfortunaterly, "m_isAlignmentEnumConverted" code modification didn't do the trick for me (even when remapping assets with modification). I tried remapping with other TMP package version (1.3, 1.0) but with the same result.

I'm currently working on this second problem.
I intend to :
- re-add "m_isAlignmentEnumConverted" field in TMP_Text before remapping (field has been removed in 1.4.1)
- add Stephan_B's "TMP_Compatibility.cs" directly in my assets folder after few modifications (package managed didn't recognized it in TMP package folder without meta file)
- Create an editor script to find TextMeshProUGUI components (disabled or not) anywhere in my scenes and prefabs,
- Fix old values (m_isAlignmentEnumConverted == false) with "TMP_Compatibility.cs".

Will tell you and share sources if it works !
If there is a more simple solution, I would also be happy to know ! Thanks

 

Hi Stephan_B,
Just tried 1.5.0-preview.8.
It seems to work like a charm ! Disabled components gets correctly converted the first time they gets enabled (at runtime or in editor).
Well done for your work and thanks for your quick answer

 

How come, when I am typing something in the Input text field, certain characters such as A, space, etc, will deselect the input field and not type in it, but other ones such as E, F, T etc will work...

Why is this happening?

Thanks

 

So the converter (GUID Remapping Tool) only fixed some of my instances of TMPro (particularly in nested prefabs). So i found a way to get it to work pretty easy. putting this out here incase anyone else gets into trouble with it

Each prefab and nested prefab has a m_Script: {fileID: 1453722849, guid: b5bd0d848a86e48409fe56688d66ecb5, type: 3}.

So pretty much crack open a prefab that the converter worked on in a text editor, and find the new "fileID" and new "guid". then crack open a prefab file in a text editor for one that didn't work and find out what the bad (old) "fileID" and "guid" are.

Pretty much you can do a find and replace in any prefab that is suffering. Possiblty even project wide. swap out the old bad one and do the new one. Honestly kinda weird that the tool didnt work for me. Seems like a straight find and replace unless theres something im missing ¯\_(ツ)_/¯
Beware that there will be different sets of fileIDs and guids if you are using like multiple componenets from TMP

 

In 1.5.0.preview.13, the GUID remapping tool fails to find old GUID references in Animator Controllers containing embedded animations. These are created automatically by the Button components when you select Animated transitions.

The fix is to modify TMP_PackageUtilities.cs and remove typeof(UnityEditor.Animations.AnimatorController) from the m_IgnoreAssetTypes list. I have confirmed this works, by making IgnoreAssetTypes list local and not static. Static variable remain unchanged unless you restart Unity, which reverts any edits to the package.

 

Thanks for the guide, just a little feedback:

Step six is a little confusing, the warning that there will be errors is good, but a little less explanation would make it clearer that you do in fact want us to delete the old folder. Also, I use the light Unity theme, and the yellow text on the GUID remapping tool is very hard to read against the default light grey.

 

Hi Stephan_B, I'm having a hard time with one of my VR projects while attempting to upgrade TMP. I've tried all the workarounds and advice listed here, but I still have scripts that are not being reassigned properly (missing script error on the game objects). I've tried using Unity 2019 and 2020 LTS with similar results. Is there a way I can get you access to the project?

 

2017 to 2019 LTS

 

Thanks Stephan, We have resolved the issue. I had another developer take a look at the issue and they decided to grab an earlier version of Unity to start with, 2017 I believe. After removing all frameworks (Oculus, SteamVR, MKGlow) then performing the steps you list here they were able to get TMP migrated and running on 2019 LTS without issue. Thank you for your time and support!

 

Hello, I'm working on a project to upgrade from an older 2016 version of TMPro to the latest, 3.0.6 in Unity.
I've managed to get everything working, but I've found some slight text-misalignment issues with some of our motion graphics.
I thought initially that the upgrade may have changed the alignment of the text. However the alignments seem to be the same. I really can't figure out why the text is slightly off. My only guess is that the shaders might be different?

I have over 100 projects to upgrade and having to go through and painstakingly find and correct minor misalignment issues would pretty much mean we stick with the older version for now.

Text Graphics in 2016, 1.0.54
https://gyazo.com/fca11dc761b99c99f9f17ef3e609cec3
https://gyazo.com/069b552bac283ce618e692f400d550ae

Text Graphics in 2021, 3.0.6
https://gyazo.com/59877d07ba1573b18ba8b4c22c898d95
https://gyazo.com/1a71db8bf11477734c6b8b9f1b158ca5

Note how the M and I are misaligned in Motivational Interviewing. However all the values in the inspectors (alignment, coordinate, etc) appear to be the same!

The way these motion graphics work is that the designers use two text objects and then align them manually. Usually they use different text objects to provide emphasis, for example they will do things like

"This isn't a ________________ decision"
"QUICK OR EASY"
And Quick or easy will be some kind of emphasis or moving text that 'slots' into the hole.

I tried running the Project Spacing Conversion tool and it didn't help.


Any help here would be appreciated!