Important

Before upgrading Better UI in your project, make sure you have a backup of the current state of your project (If you use source control, make sure everything is committed. If not using source control, make a copy of your Assets folder).


Upgrade

In version 2.4 the folder structure slightly changed. Therefore, it is recommended to do a clean import:

  1. Open an empty Scene (File -> New Scene).
  2. Close all Better UI Tool windows -- especially the "Pick Resolution" Window.
  3. Delete the folder Assets/TheraBytes/BetterUI (but don't delete Assets/TheraBytes/Resources as there are your configurations for the project stored)
  4. Follow the Installation Guide.


Troubleshooting


If upgraded from a version prior to Better UI 2.3:

  • If you see a compile error, delete the editor file

TheraBytes/BetterUI/Editor/Scripts/BetterScrollRect

  • The spacing for existing BetterScrollRects might be overwritten after importing the Better UI (if upgraded from a version prior to v2.3).
    Please check your BetterScrollRects before importing and assign the right values again after import.
  • Any Better(Raw)Images with a Grayscale material assigned will not appear grayscale after import.
    Change the Material to something else and back to Grayscale to fix it.
    If this does not fix it, delete

TheraBytes/Resources/Materials

and try the material change again.

  • Unity 5.4 is not officially supported anymore. The minimum Unity version for Better UI is 5.5.
    Most features will also work with Unity 5.4 though. If you are upgrading a Unity 5.4 project, do not import the shader files of Better UI 2.3.



Note that Better UI 2.4 is the last version which supports Unity 5. From the next version on the minimum supported Unity version will be the LFS version which is still supported by Unity themselves.