Building PCIT Project Software

These are the building instructions for the PCIT Project software.

Requirements

• git
• Premake5 (5.0-beta4 or later)
• A version of MSVC, GCC, or Clang that is C++20 compliant
• Either Microsoft Visual Studio (v143 or later), or GNU Make
• CMake (3.20.0 or later)
• Python (3.8 or later)

Building LLVM

At the moment, PCIT relies on LLVM, so we need to build LLVM first.

1) Create a directory on your computer

  All LLVM source code and build results will go in this directory. The needed files will be moved from this directory once the process is completed (and the rest deleted), so this directory can go wherever you like.

2) Get the scripts

  There is a GitHub repository that contains the scripts required to download the LLVM Project source code and build it. The script for Windows systems can be found here, and the script for Unix systems can be found here. Get the correct script for your machine, and put it in the directory you created in step 1.

3) Run

  Run the script. This script will clone the PCIT fork of LLVM, and compile it. This took my Windows computer 2+ hours to run and resulted in 88.6GB of storage space used (although only 9.3GB is needed to be kept). It is recommended to have at least 32GB of addressable memory.

4) Finishing up

  Once the script has completed, you will see three directories within the one created in step 1: build, llvm-project, and output. You may delete build and llvm-project if you wish, as they are not needed to build PCIT.

Building PCIT-CPP

Now that we have build LLVM, we can build PCIT.

1) Clone the repository

git clone https://github.com/PCIT-Project/PCIT-CPP.git --recursive

  The --recursive argument is required to also clone the Evo standard library. LLVM and Evo are the only dependencies that PCIT-CPP has.

2) Add directory for LLVM

  Inside the /PCIT-CPP/dependencies/, add the directory LLVM_build

3) Add LLVM

  Within the output directory discussed in step 4 of Building LLVM, there should be a number of directories. Copy or move /output/include/ and /output/lib/, into the directory created in step 1 of Building PCIT-CPP.

4) Configuring PCIT build system with Premake5

  Premake is a build system configurator, so Premake5 is used to configure the build system. For more information, you can run premake5 --help. Navigate to the main directory of the PCIT-CPP repository, and select one of the following methods of running Premake5:

Using Microsoft Visual Studio:

premake5 vs2022

Using GNU Make:

premake5 gmake --cc=[COMPILER]

  Replace "[COMPILER]" with one of the following options

• clang
• gcc
• mingw
• msc-v143

5) Build

Using Microsoft Visual Studio:

  Open PCIT-CPP.sln in Visual Studio, set the build configuration to ReleaseDist, and compile.

Using GNU Make:

make configuration=releasedist_linux

6) Done!

  The generated output is in ./build/[Windows|Linux]/ReleaseDist/bin/. Enjoy PCIT!

Next Steps

Now that you have successfully built the PCIT Project software, maybe check out one of our tutorials.