HoloLens Device Quick Start

You can deploy and run an Unreal app directly on the device.

1 - Verify System Requirements

Steps

1. Verify that you have installed the necessary prerequisites to run the HoloLens 2. See HoloLens 2 Prerequisites for more information. 

2 - Required Setup

Before you can deploy an Unreal application to the HoloLens, you must configure the HoloLens and become familiar with its basic operations.

For more information on initial HoloLens setup and configuration, see Get started with HoloLens.

Steps

1. Make sure that your HoloLens is charged. 

2. If this is your first time launching the HoloLens, turn it on and proceed with the calibration process.

3. Log in with your account or create a new account.

4. On the HoloLens, open the Settings menu

   

5. Open Update & Security.

   

6. Open For developers.

   

7. Enable Use developer features.

   

8. Enable the Device Portal.

   

3 - Install a Package to the HoloLens 2

If you do not already have an app built and available for the HoloLens, see Packaging an App for the HoloLens 2 for more information on packaging an app for the HoloLens 2. 

In the steps you will load two files, an .appxbundle** file and an ** .appx file. The .appxbundle** file is the game's package. The ** .appx file is the dependency package containing supporting files for the target architecture (arm64 or x64). The dependency package only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package. If you reflash your device, you will lose everything that had been deployed to the device, including the dependency packages.  

1. In your browser, enter 127.0.0.1:10080 to open the Windows Device Portal.

   Ensure that your device is plugged into your PC over USB, and that IPOverUSB is installed from the Windows 10 SDK.

   

2. In the Windows Device Portal, select Views > Apps from the toolbar.

   

3. Click the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens.

   

4. Select the .appxbundle file to specify the package you want to install.

   

5. Select the Allow me to select optional packages option, and select Next.

   The *.appx file is the dependency package and only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package.

   

6. Select the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens.

   

7. Select the *.appx file for the platform you are targeting (x64 for the Emulator, arm64 for the device), and click Next.

   

8. Click the Install button.

   

9. Wait for the app to finish installing.

   

10. Once the app installation is complete, scroll through All Apps on the to find your app.

    

4 - On Your Own!

Try running the new Unreal app on your HoloLens.