Upgrading your Uploader projects to Unity 2019.2

This build is now live, so the preview has been taken down. Use the official Altspace build on the Oculus Store, Steam, or Windows Store instead.

Original Announcement

Hi everyone! You may have heard by now, AltspaceVR is updating to Unity 2019.2! This means a couple things for you world-builders:

Upgrade Instructions

If you have a kit or template project in Unity 2018.1, follow these instructions to update and upload in Unity 2019.2:

  1. Make sure you’re running Uploader v0.8.3 or later. The in-editor version number has always read “1.0.0”, so if you don’t remember updating since it came out in November, you’ll need to update it:
    1. Download the latest Uploader package from here.
    2. Open your project (in Unity 2018.1), and delete the Assets/Altspace and Assets/Plugins directories.
    3. Import the new Uploader package (Assets > Import Package > Custom Package…).
    4. Restart Unity.
  2. Close Unity if you have it running.
  3. Create a copy of your project folder. This will save you a lot of time if you plan on updating the 2018.1 assets during the preview, and also serves as a backup in case the upgrade fails.
  4. Install Unity 2019.2.12f1:
    1. Go to the Unity Download Archive, scroll down to Unity 2019.2.12, and download it either via the Hub, or directly, as it suits you.
    2. Make sure when you install it, you also install Android Build Support, or you won’t be able to build/upload Android bundles.
  5. Open your project in Unity 2019.2.12f1. It will warn you that it has to upgrade the project, but click “Confirm”.
  6. Wait while Unity upgrades all your assets and meta files.
  7. If you get any “blank errors” in the console after you import your project, you may be hitting a Unity bug. To fix this, close Unity, open the file C:\Program Files\Unity\Hub\Editor\2019.2.12f1\Editor\Data\Tools\RoslynScripts\unity_csc.bat in a text editor, change “csc” to “csc.exe” in line 3, and save. Reopen Unity, and the error should be gone.
  8. Build your asset bundles like normal for kits or templates.

Congratulations, you’ve updated your project to Unity 2019.2!

Troubleshooting

My assets uploaded correctly but I do not see them in my world

This can happen if your world data has cached your old assets. You can force-clear this by performing a space reset (via Ctrl+Shift+R in the client) or by editing any of the world’s data (such as its name or description) from the website, and then leaving/re-entering the world.