******************************* Migration from v2.0.x to v3.0.x ******************************* This migration guide helps upgrading a Unity SDK v2.0.x to a 3.x.x version. This isn't an exhaustive guide, as there are different difficulties and combinations of difficulties depending on each project. This is more a guide help get in the right direction. The `change log `_ and the `FAQ `_ are also useful resources. Questions can still be asked a `dev-support@asmodee.net `_. If you are starting a project from scratch, follow the `Getting Started `_ guide instead. Clean up ======== Remove these folders before re-importing: * ``\Assets\AsmodeeNet`` * ``\Assets\Plugins\AsmodeeNet`` * ``\Assets\Samples`` TextMesh Pro ============ Since **TextMesh Pro** became free, it stopped being distributed as source code to be distributed as a ``.dll`` file instead. This new version breaks the GUID of **ALL** previous components. Unfortunately, it's also impossible to have both versions of TextMesh Pro next to each other in the same project. So if you have already integrated the source code version of TMP in your project, you will have to replace all your old texts UI elements by the new ones. There is no automatic solution to solve this, as old and new elements have a lot of divergent parameters, fonts must be re-rendered, etc. Best HTTP ========= Best HTTP must be updaded to the latest version, especially to fix an bug that prevented requests to survive asynchronous scene transitions (which is default in the ``CoreApplication`` ``SceneTransitionManager``). CoroutineManager ================ The ``CoroutineManager`` and its derivative classes have been removed. Replace all instances of: .. code:: csharp CoroutineManager.StartCoroutine(...) by: .. code:: csharp using AsmodeeNet.Foundation; // ... CoreApplication.Instance.StartCoroutine(...) More info on ``CoreApplication`` in the `CoreApplication reference `_. Cross Promotion =============== Replace the old ``CrossPromo`` prefab by the new one. This implies to re-bind functions like ``ShowMoreGamesPopup`` on `More Games` buttons. RestAPI ======= The ``RestAPI`` class is no more, you can now call endpoints from new classes implementing them. Check `How to use the REST API `_ and the `list of endpoints `_ for more info.