Skip to content

Latest commit

 

History

History
104 lines (68 loc) · 3.47 KB

deploy-to-desktop.md

File metadata and controls

104 lines (68 loc) · 3.47 KB
Raw
title description author ms.author ms.date ms.topic ms.custom
Deploy Unity sample to Desktop
Quickstart that shows how to get the Unity sample onto a desktop PC
christophermanthei
chmant
03/20/2020
quickstart
mode-other

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:

[!div class="checklist"]

  • 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.
    A screenshot showing the Project Settings menu with a disabled "OpenXR" setting.

Build the sample project

Standalone

  1. Open File > Build Settings.
  2. Change Platform to PC, Mac & Linux Standalone.
  3. Set Target Platform to Windows.
    A screenshot showing the Build Menu with the settings set for a standalone build.
  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.
    A screenshot showing the Build Menu with the settings set for a UWP build.
  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.
    A screenshot showing the Visual Studio configuration and debugger mode.
  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.

[!div class="nextstepaction"] Quickstart: Convert a model for rendering