Packaging an App for the HoloLens 2

Provides instructions on packaging apps for the HoloLens 2.

Windows
MacOS
Linux

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

  1. 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.

  2. 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

  1. Go to the Library tab in the Epic Games Launcher.

    Launcher.png

  2. Select the pulldown arrow next to Launch, then select Options.

    LauncherOptionsButton.png

  3. From the Unreal Engine Installation Options menu, select HoloLens and click Apply.

    UEInstallationOptionsMenu.png

Configure the Project Settings for HoloLens Packaging

Steps

  1. Go to Project Settings > Project > About > Project Name and enter a project name.

  2. Go to Project Settings > Project > Publisher > Company Name and enter a company name.

  3. Go to Project Settings > Project > Publisher > Company Distinguished Name and enter CN= followed by the company name entered earlier.

  4. Go to Project Settings > Platforms > HoloLens > Packaging > Signing Certificate and select Generate new.

  5. You will be prompted to create a Private Key Password. For testing purposes, click None.

  6. If you are packaging for HoloLens Emulation, go to Project Settings > Platforms > HoloLens > Holo Lens and select Build for HoloLens Emulation.

  7. 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

  1. Choose File > Package Project > HoloLens.

    PackageProjectForHoloLens.png

  2. Enter a specific destination folder for the package (or accept the default).

  3. The packaging status is displayed in the bottom right-hand of the screen. Details of the process are available in the Output Log.

    PackagingProjectStatus.png

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.

DefaultFolderContents.png

Tags
Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback