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.