Instructions to build standalone executable

  1. Download and Install Unity Hub:
  2. Ubuntu: https://forum.unity.com/threads/unity-hub-v2-0-0-release.677485/
  3. Windows: https://unity3d.com/get-unity/download

  4. Download and Install Unity 2019.1.10f1:

  5. Ubuntu: https://beta.unity3d.com/download/f007ed779b7a/UnitySetup-2019.1.10f1
  6. Windows: https://unity3d.com/get-unity/download/archive

  7. Download and Install Node.js

  8. Make sure you have git-lfs installed before cloning this repository.

    • Instructions for installation are here
    • Verify installation with: $ git lfs install > Git LFS initialized.
  9. Clone simulator from GitHub:

    git clone --single-branch https://github.com/lgsvl/simulator.git

  10. Run Unity Hub

  11. In the Projects tab, click Add and select the folder that the Simulator was cloned to

  12. In the Installs tab, click Locate and choose the Unity launcher in the Unity2019.1.10f1 folder

  13. In the Projects tab, verify that the Simulator is using Unity Version 2019.1.10f1 from the dropdown

  14. Double-click the name of the project to launch Unity Editor

  15. Open a terminal window

  16. cmd.exe on Windows
  17. Terminal on Linux

  18. Navigate to the WebUI folder of the Simulator project

  19. Window ex. C:\Users\XXX\Documents\Simulator\WebUI
  20. Linux ex. /home/XXX/Projects/Simulator/WebUI
  21. Where XXX is the user profile

  22. Run npm install to install dependencies, do this only once or if dependencies change inside packages.json file

  23. Run Build WebUi... in Unity: Simulator -> Build WebUI...

  24. Open Build... in Unity: Simulator -> Build...

  25. Check the Environments and Vehicles that should be generated as AssetBundles

  26. They will be located in a folder called AssetBundles in the folder selected as the build location
  27. These may also be built separately from the Simulator. In this case they will be put into the AssetBundles folder of the project

  28. (Optional) Click Build to only build the assetbundles. Load the LoaderScene.unity and click the Play button at the top of the editor to start the simulator.

  29. Select the Target OS for the build

  30. Verify Build Simulator is checked for the Simulator to be built

  31. Select a folder that the simulator will be built in

  32. (Optional) Check Development Build to create a Development Build

  33. Click Build

Test Simulator top#

  1. Ubuntu - Install Vulkan userspace library
sudo apt-get install libvulkan1
  1. Double-click the Simulator.exe that was built

  2. Select graphics options then press Ok

  3. Click Open Browser

  4. In the Maps tab, Add new map with the URL to an environment assetbundle

  5. ex. C:\Users\XXX\Desktop\Simulator\AssetBundles\environment_borregasave

  6. In the Vehicles tab, Add new vehicle with the URL to a vehicle assetbundle

  7. ex. C:\Users\XXX\Desktop\Simulator\AssetBundles\vehicle_jaguar2015xe

  8. (Optional) Add a manual control "sensor" to the vehicle to enable driving

  9. Click the wrench icon next to the vehicle name
  10. In the text box insert [{"type": "Manual Control", "name": "Manual Car Control"}]

  11. In the Simulations tab, Add new simulation with the added map and vehicle

  12. Press the Play button

  13. The Unity window should now show a vehicle in the built environment