Packaging an App for the HoloLens 2

Provides instructions on packaging apps for the HoloLens 2.

Choose your operating system:

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.

    hololenspluginenabled.png

  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.

    wmrpluginenabled.png

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.

    ProjectName.png

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

    CompanyName.png

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

    CompanyDistinguishedName.png

  4. Go to Project Settings > Project > Settings and enable Start in VR.

    ![](start-in-vr.png "start-in-vr.png")

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

    GenerateCertificate.png

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

    CreatePrivateKeyPassword.png

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

    BuildForEmulation.png

  8. If you are packaging for the HoloLens Device, go to Project Settings > Platforms > HoloLens > Holo Lens and select Build for HoloLens Device.

    BuildForDevice.png

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
HoloLens 2
Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss