2.0 Help

UWP

This page describes how to build Plasma for the Universal Windows Platform (UWP). For desktop builds, see this page.

Note that only a subset of Plasma's functionality is officially maintained and supported on UWP. In general UWP support is not a priority for us.

Prerequisites

Install the desktop Windows prerequisites.

Microsoft Visual Studio

In Visual Studio, install these additional workloads:

  • Universal Windows Platform Development

CMake

CMake is used as the build system. For UWP you need to have a custom installation.

Generate the Solution

To generate a solution for UWP, you need to pass a toolchain file to CMake. The file is located in the Plasma repository under Code/BuildSystem/CMake/toolchain-winstore.cmake.

Using the CMake GUI

  1. Start the CMake GUI application.

  2. Create a new solution by pointing Where to build the binaries to a new location.

  3. Press Configure once, a dialog will show up to choose the generator.

  4. Choose the desired Visual Studio generator at the top.

  5. Depending on your target device, choose the platform. For instance, for HoloLens 1 select Win32.

  6. At the bottom select Specify toolchain file for cross-compiling.

  7. On the next screen set the toolchain file PathToPlRepository /Code/BuildSystem/CMake/toolchain-winstore.cmake

Using the command line

Run CMake with this argument: -DCMAKE_TOOLCHAIN_FILE=PathToPlRepository /Code/BuildSystem/CMake/toolchain-winstore.cmake

Building the Code

Open the generated solution with Visual Studio and build everything.

See Also

Last modified: 09 June 2024