Skip to content

Commit cd08715

Browse files
committed
Update the migration/upgrade notes with correct instructions on how to upgrade between MRTK versions.
#5770 The existing instructions weren't quite complete, because when you approached step #6 (re-adding MRTK objects to the scene) there is a strong likelihood that the profiles (and other assets outside of the MRTK) haven't been refreshed in the asset database. As a result, doing things like adding the MRTK to the scene and picking a profile wouldn't pick up existing profiles (because the asset database wouldn't have the correct information.) This requires forcing Unity to regenerate its asset database - the easiest way to do this is just to close it and delete the Library/ folder (which causes an asset database refresh) See #5770 (comment) for alternatives considered
1 parent 89fb1f9 commit cd08715

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

Documentation/ReleaseNotes.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,9 @@ For the smoothest upgrade path, please use the following steps.
5050
> [!Note]
5151
> If additional extensions had been installed, they may need to be re-imported.
5252
- (Optional) Examples
53-
1. For each scene in the project
53+
1. Close Unity and Delete the **Library** folder. This step is necessary to force Unity to refresh its
54+
asset database and reconcile existing custom profiles.
55+
1. Launch Unity, and for each scene in the project
5456
- Delete **MixedRealityToolkit** and **MixedRealityPlayspace**, if present, from the hierarchy
5557
- Select **MixedRealityToolkit -> Add to Scene and Configure**
5658

0 commit comments

Comments
 (0)