Before an Unreal project can be distributed to users, it must be properly packaged. Follow the instructions below to build a package for the HoloLens 2.
Configure the Plugins for HoloLens
Steps
-
In your Unreal project, make sure that the HoloLens Plugin is enabled (Plugins > Augmented Reality > HoloLens). If the HoloLens Plugin is not enabled, enable it and restart the editor when prompted.
-
In your Unreal project, make sure that the Microsoft Windows Mixed Reality Plugin is enabled (Plugins > Virtual Reality > Microsoft Windows Mixed Reality). If the Microsoft Windows Mixed Reality Plugin is not enabled, enable it and restart the editor when prompted.
Install Supporting Files from the Epic Games Launcher
If this is the first time that you have built a package for the HoloLens, you may need to download supporting files from the Epic Games Launcher.
Steps
-
Go to the Library tab in the Epic Games Launcher.
-
Select the pulldown arrow next to Launch, then select Options.
-
From the Unreal Engine Installation Options menu, select HoloLens and click Apply.
Configure the Project Settings for HoloLens Packaging
Steps
-
Go to Project Settings > Project > About > Project Name and enter a project name.
-
Go to Project Settings > Project > Publisher > Company Name and enter a company name.
-
Go to Project Settings > Project > Publisher > Company Distinguished Name and enter CN= followed by the company name entered earlier.
-
Go to Project Settings > Project > Settings and enable Start in VR.
-
Go to Project Settings > Platforms > HoloLens > Packaging > Signing Certificate and select Generate new.
-
You will be prompted to create a Private Key Password. For testing purposes, click None.
-
If you are packaging for HoloLens Emulation, go to Project Settings > Platforms > HoloLens > Holo Lens and select Build for HoloLens Emulation.
-
If you are packaging for the HoloLens Device, go to Project Settings > Platforms > HoloLens > Holo Lens and select Build for HoloLens Device.
Package a Project for the HoloLens
Steps
-
Choose File > Package Project > HoloLens.
-
Enter a specific destination folder for the package (or accept the default).
-
The packaging status is displayed in the bottom right-hand of the screen. Details of the process are available in the Output Log.
Results
Once the packaging process finishes, you should see something similar to the screenshot below in your project directory. If you accepted the default destination folder, a HoloLens directory was created during the packaging process. To deploy your app, see the instructions in the HoloLens 2 Emulator Quick Start or HoloLens 2 Device Quick Start topics.
