Building with CMake's standalone client (cmake-gui)

Please ensure that you have installed:

• Microsoft Visual Studio 2019 (you will get the Visual C++ compiler along with it)
• CMake

Also ensure that you have a local copy of the dhart repository.

0. Opening cmake-gui

Open the CMake (cmake-gui) application. (Hit the Windows key, and type 'CMake')

1. Browse source...

Hit the 'Browse Source...' button to the right of the
'Where is the source code:' text field.

2. Selecting the source code directory

In the window that appears (titled 'Enter Path to Source'),
navigate to the local copy of dhart on your machine.

Then, navigate to the 'src' subdirectory. Click 'Select Folder'.
The 'Where is the source code' field should read:
C:/[YOUR_PATH_HERE]/dhart/src

3. Browse build...

Hit the 'Browse Build...' button to the right of the
'Where to build the binaries:' text field.

4. Selecting the build directory

In the window that appears (titled 'Enter Path to Build'),
navigate to the local copy of dhart on your machine.

Then, navigate to the 'build' subdirectory. Click 'Select Folder.'
The 'Where to build the binaries' field should read:
C:/[YOUR_PATH_HERE]/dhart/build

5. Confirming your configuration

Hit the 'Configure' button in the left-center area of the cmake-gui window.

6. Selecting compiler options

In the dialogue box that appears,
for the 'Specify the generator for this project' dropdown box, ensure that 'Visual Studio 16 2019' is selected.

Ensure that the 'Use default native compilers' radio button is selected. Do not fill in the remaining text fields.

Then, click 'Finish'.

7. Building the repository/choosing a build version

As stated previously, there are two build versions for dhart:

• x64-Debug
  
• x64-Release
  

CMake will build the project.
Note: The build will appear to fail at first.
The remainder of the directions for this step will rectify this,
and you will also be able to select your desired build version.

In the center of the cmake-gui window, you will see
a 'Name' and 'Value' table, in red highlighting.

Next to 'CMAKE_CONFIGURATION_TYPES', click the text field
that resides underneath the 'Value' column.

To select the build version,
change the selected field to Debug, for the x64-Debug version,
or Release, for the x64-Release version, whichever is desired.

Then, click 'Configure'.

The build files generated by CMake will reside in
C:/[YOUR_PATH_HERE]/dhart/build