Visual Servoing Platform  version 3.2.0 under development (2018-08-20)
Tutorial: Installation from source for UWP with Visual C++ 2017 (vc15)

In this tutorial you will learn how to build ViSP framework for Universal Windows Platform (UWP) to include ViSP functionalities in apps developments that target a wide range of devices including PC, mobile, Xbox, HoloLens, IoT, and Surface Hub.

This tutorial has been tested on Windows 10 (64 bit), with CMake 3.9.4 and Visual Studio Community 2017 and is only working since ViSP 3.0.1.

Note
Concerning ViSP installation, we provide also other Tutorials.

Install required software

  • CMake that could be download at : http://www.cmake.org. Download the latest release for Windows win64-x64 platform (at the time this tuto was written it was the file cmake-3.9.4-win64-x64.msi). To install just double click on the msi file.
  • Visual Studio Community 2017. Make sure that the Universal Windows App Development Tools are selected from the optional features list. Without these tools, you won't be able to create your universal apps. After the installation, start Visual Studio and create an empty C++ project to install the common tools for Visual C++ 2017.
Note
If you have already Visual Studio 2017 installed and don't know if the Universal Windows App Development Tools are enabled see How to add Universal Windows App Development Tools support.

After installing Visual Studio software, you need to enable your Windows 10 device for development.

Create a workspace

First create a workspace that will contain all ViSP and optional 3rd parties. This workspace is here set to C:\workspace folder, but it could be set to any other location. To create the workspace:

  • Open a cmd terminal (in your "Start" menu click on "Run" and type in cmd.exe) and run:
    C:\> mkdir C:\workspace

Get ViSP source code

There are different ways to get ViSP source code.

  • You can download the latest release as a zip or a tarball. Once visp-x.y.z.tar.gz or visp-x.y.z.zip is downloaded, uncompress the file in C:\workspace\visp\visp-x.y.z.
  • You can also download a daily snapshot. Once visp-snapshot-yyyy-mm-dd.tar.gz is downloaded, uncompress the file in C:\workspace\visp\visp-x.y.z.
  • Or you get the cutting-edge ViSP from GitHub repository using the git command line (see How to install Git):
    C:\> mkdir C:\workspace\visp
    C:\> cd C:\workspace\visp
    C:\> git clone https://github.com/lagadic/visp.git

We suppose now that ViSP source is in C:\workspace\visp\visp.

Build ViSP

Build for Windows Store 10.0

  • Configure ViSP build for Windows Store 10 targeting a x86 platform, by opening a cmd terminal and running:
    C:\> cd C:\workspace\visp
    C:\> md visp-build-vc15-uwp-ws-10
    C:\> cd visp-build-vc15-uwp-ws-10
    C:\> cmake.exe -G "Visual Studio 15 2017" -DCMAKE_SYSTEM_NAME:String=WindowsStore -DCMAKE_SYSTEM_VERSION:String="10.0" -DCMAKE_VS_EFFECTIVE_PLATFORMS:String=x86 ../visp
  • To build ViSP just double click on C:/workspace/visp/visp-build-vc15-uwp-ws-10/VISP.sln solution file. This action will open ViSP project in Visual Studio C++.
  • With Visual Studio build and install the solution. If everything goes right you will find ViSP libraries and headers in C:/workspace/visp/visp-build-vc15-uwp-ws-10/install folder.

Tips and tricks

How to add Universal Windows App Development Tools support

In case you're trying to build Windows Store and Windows Phone 10.0 projects having only default Visual Studio 2017 installation you'll likely get the following error during cmake run:

A Windows Store component with CMake requires both the Windows Desktop SDK
as well as the Windows Store '10.0' SDK. Please make sure that you have
both installed

Resolution consists in:

  • Open the Start menu ("Windows" key)
  • Select "Visual Studio Installer"
  • Under Visual Studio Community 2017 section, click on "Modify"
  • Enable "Universal Windows App Development Tools" and "Windows 8.1 and Windows Phone 8.0/8.1 Tools"