Guide and problems with UItoolkit migration from 2022.3.xx to 6.0

[dredywko]

Hello!

There is a bunch of questions about UIToolkit:

1. Is it correct that UIToolkit in unity 2022.3.xx is different to UIToolkit in 2023 and 6.0 versions and will not getting updates to match?
2. If we start project in version 2022.3.xx and using UIToolkit and then we will want to migrate to unity 6 - how easy it will be in context of UI that we made?

Thanks!

[SimonDufour]

UI toolkit is shipped with the editor and follow the same update guidelines: fixes are done in all supported versions if possible but new features only land in newer version of the editor.

Regarding upgrading, I don’t think there was any deprecation or breaking changes, so it should be straightforward.

[antoine-unity]

Hello, you can have a look at the Unity 6 upgrade guide, which contains two topics specific to UI Toolkit.

• UxmlTraits/UxmlAttributes are deprecated and replaced as part of the Enhanced custom controls creation with UXML
• VisualElement.ExecuteDefaultAction and VisualElement.ExecuteDefaultActionAtTarget have been deprecated

[antoine-unity]

Also, a more in-depth way to look into changes is the explore the Release Notes via this tool (alpha quality).

For example, you can see the changes between 2022.3.55f1 and Unity 6000.25f1 for UI Toolkit.

To investigate potential differences/changes, filtering for “Changed”, “Deprecated” and “Removed” type of release note should give you a pretty accurate list.