Building PCoIP Virtual Channel Plug-In Samples¶
Use CMake (Cross-Platform Make) to build the sample plug-ins for Windows, macOS, or Linux. CMake is an open-source, cross-platform family of tools designed to build, test, and package software.
You can download the latest version of CMake for platform specific installation file from www.cmake.org.
Info
Microsoft Visual Studio is required for building the plug-ins.
You can use CMake to configure and generate platform and compiler specific build files and build the target plug-ins on the chosen platforms.
Building the plug-ins for other platforms requires the SCons software construction tool. SCons requires Python and GCC compiler or a corresponding toolchain that supports the pthreads
library (for the operating system primitives used in the plug-ins).
Using CMake to Configure and Generate Platform and Compiler Build Files¶
The following image shows the configuration information for CMake with Microsoft Visual Studio on Windows:
You can configure other platforms in a similar way to take the source codes and generate the build files in the designated binaries folder. It is possible to configure CMake on the command-line user interface. For more information, see the CMake documentation.
Completing the CMake process
You must first Configure, and then Generate a two-pass routine to complete the CMake process.
To build the target plug-ins on your chosen platform, build the plug-in with the designated compiler from the output build files folder.
Binary compatibility for Windows plug-ins
For Windows Clients, ensure that the PCoIP Virtual Channel plug-ins are built as 64-bit .dlls
with Visual Studio Code 2015 or later.
For Windows Agents, if the PCoIP Virtual Channel plug-ins are built with a version of Visual Studio earlier than 2015, ensure that the required re-distributables are installed.
Binary compatibility for macOS plug-ins
To maintain binary compatibility, ensure that PCoIP Virtual Channel plug-ins on macOS are built as 64-bit dylibs
with Xcode 5.0 or above.