Exporting and building a Unity Visual Studio solution
If your app doesn't need the system keyboard, our recommendation is to use D3D so that your app uses slightly less memory and a faster launch time. However, if you're using the system keyboard through the TouchScreenKeyboard API, you need to export the project as XAML.
How to export from Unity
Build settings in Unity editor
- When you're ready to export your project from Unity, open the File menu and select Build Settings...
- Select Add Open Scenes to add your scene to the build.
- In the Build Settings dialog, choose the following options to export for HoloLens:
- Platform: Universal Windows Platform and be sure to select Switch Platform for your selection to take effect.
- SDK: Universal 10.
- UWP Build Type: D3D.
- Optional: Unity C# Projects: Checked.
Checking this box allows you to:
- Debug your app in the Visual Studio remote debugger.
- Edit scripts in the Unity C# project while using IntelliSense for WinRT APIs.
- From the Build Settings... window, open Player Settings...
- Select the Settings for Universal Windows Platform tab.
- Expand the XR Settings group.
- In the XR Settings section, check the Virtual Reality Supported checkbox to add a new Virtual Reality Devices list and confirm "Windows Mixed Reality" is listed as a supported device.
- Return to the Build Settings dialog.
- Select Build.
- In the Windows Explorer dialog that appears, create a new folder to hold Unity's build output. Generally, we name the folder "App".
- Select the newly created folder and select Select Folder.
- Once Unity has finished building, a Windows Explorer window will open to the project root directory. Navigate into the newly created folder.
- Open the generated Visual Studio solution file located inside this folder.
When to re-export from Unity
Checking the C# Projects checkbox when exporting your app from Unity creates a Visual Studio solution that includes all your Unity script files. Having all your scripts in one place lets you iterate without re-exporting from Unity. However, if you make changes to your project that aren't just changing the contents of scripts, you'll need to re-export from Unity. Some examples of times you need to re-export from Unity are:
- You add or remove assets in the Project tab.
- You change any value in the Inspector tab.
- You add or remove objects from the Hierarchy tab.
- You change any Unity project settings
Building and deploying a Unity Visual Studio solution
The remainder of building and deploying apps happens in Visual Studio. You will need to specify a Unity build configuration. Unity's naming conventions may differ from what you're used to in Visual Studio:
|Debug||All optimizations off and the profiler is enabled. Used to debug scripts.|
|Master||All optimizations are turned on and the profiler is disabled. Used to submit apps to the Store.|
|Release||All optimizations are turned on and the profiler is enabled. Used to evaluate app performance.|
Note, the above list is a subset of the common triggers that will cause the Visual Studio project to need to be generated. In general, editing .cs files from within Visual Studio won't require the project to be regenerated from within Unity.
If you find that edits to your .cs files aren't being recognized in your Visual Studio project, ensure that Unity C# Projects is checked when you generate the VS project from Unity's Build menu.