How to Build the Software

[!SUMMARY] This page explains how to:

  • Build the project for various target platforms, including
    • Windows
    • Meta Quest
    • WebGL
    • Linux Dedicated Server
Important

Anywhere Academy uses Unity's build profiles to manage the build settings for individual platforms.

To learn more about build profiles, see Unity's documentation: https://docs.unity3d.com/6000.3/Documentation/Manual/build-profiles.html

This guide contains a step by step guide to build for every targeted platform.

Before building any version of the software, check if the scene list is set up properly.

  1. Open Build Profiles Page (File → Build Profiles)
  2. Find and verify the Scene List

How to Build for Windows

  1. Open Project Settings (Edit → Project Settings)
  2. Navigate to the XR Plug-in Management tab
  3. Verify that the settings are setup proper for you
  4. Open Build Profiles Page (File → Build Profiles)
  5. Find the Windows (VR & NonVR) Build Profile
  6. Adjust player settings as needed
    1. Version Number
    2. Graphics API
    3. etc.
  7. Hit Switch Platform or Build

How to Build for Meta Quest

Building for Meta Quest Series is similar to building for Windows. Since Meta Quest uses an Android based OS, the Meta Quest (VR) Build Profile is based on Android settings. Therefore, we need to keep track of the bundle identifier in addition to versioning settings.

  1. Open Project Settings (Edit → Project Settings)
  2. Navigate to the XR Plug-in Management tab
  3. Verify that the settings are setup proper for you
  4. Open Build Profiles Page (File → Build Profiles)
  5. Find the Meta Quest (VR) Build Profile
  6. Adjust player settings as needed
    1. Version Number
    2. Bundle Identifier
    3. Graphics API
    4. etc.
  7. Hit Switch Platform or Build
Note

Anywhere Academy uses the following mapping between version number and bundle identifier to avoid confusion:

Version $X.Y.Z$ becomes bundle identifier $X \cdot 10000 + Y \cdot 100 + Z$.

Example Version 2.5.17 becomes bundle identifier 20517.

How to Build for WebGL

Unity allows to optimize either build time or performance when building for WebGL. As WebGL should run on devices without GPU and older devices, the web version of Anywhere Academy is optimized for performance. To allow efficient development iteration, there are two build profiles for WebGL in the project: Web (NonVR) and Web Productive (NonVR), with the former being optimized for build time, the latter for performance. Use them as you like.

Caution

The WebGL Build profiles use individual player settings. This requires additional consideration with version numbers and other settings that need to be copied from the global player settings.

  1. Open Build Profiles Page (File → Build Profiles)
  2. Find the correct WebGL Build Profile
  3. Adjust player settings as needed
    1. Version Number
    2. etc.
  4. Hit Switch Platform or Build

How to Build a Dedicated Linux Server

Anywhere Academy uses a headless dedicated Linux server for its multiuser functionalities. Most scenes will not work without being connected to a server.

  1. Open Build Profiles Page (File → Build Profiles)
  2. Find the Linux Server Build Profile
  3. Adjust global player settings as needed
    1. Version Number
    2. etc.
  4. Hit Switch Platform or Build