Quickstart: Deploy Unity sample to Desktop

This quickstart covers how to deploy and run the quickstart sample app for Unity to a desktop PC.

In this quickstart, you learn how to:

• Build the quickstart sample app for desktop
• Deploy the sample to a PC
• Run the sample on a PC

Prerequisites

In this quickstart, we deploy the sample project from Quickstart: Render a model with Unity.

Make sure your credentials are saved properly with the scene and you can connect to a session from within the Unity editor.

Disable virtual reality support

Only flat desktop apps are currently supported on desktop so VR support has to be disabled.

Standalone

In the standalone build VR support is automatically disabled. No steps are needed here.

Universal Windows Platform (UWP)

1. Open Edit > Project Settings...
2. Select XR Plugin Management in the menu to the left.
3. Select the Universal Windows Platform settings tab.
4. Disable OpenXR.
   

Build the sample project

Standalone

1. Open File > Build Settings.
2. Change Platform to PC, Mac & Linux Standalone.
3. Set Target Platform to Windows.
   
4. Select Switch Platform.
5. When pressing Build (or 'Build And Run'), you're asked to select some folder where the .exe should be stored.

UWP

1. Open File > Build Settings.
2. Change Platform to Universal Windows Platform.
   
3. Select Switch Platform.
4. When pressing Build (or 'Build And Run'), you're asked to select some folder where the solution should be stored.

Build the Visual Studio solution

Standalone

Building in standalone mode doesn't produce a Visual Studio solution, but instead a simple .exe file. No second building step is necessary here.

UWP

1. Open the generated Quickstart.sln with Visual Studio.
2. Change the configuration to Release and x86.
3. Switch the debugger mode to Local Machine.
   
4. Build the solution.

Launch the sample project

Standalone

Run the .exe file, which was produced in the build step.

UWP

Start the Debugger in Visual Studio (F5). It automatically deploys the app to the PC.

The sample app should launch and then start a new session. After a while, the session is ready and the remotely rendered model will appear in front of you. If you want to launch the sample a second time later, you can also find it from the Start menu now.

Next steps

In the next quickstart, we'll take a look at converting a custom model.

Quickstart: Convert a model for rendering