Skip to content

Latest commit

 

History

History
46 lines (28 loc) · 2.28 KB

BUILDING.md

File metadata and controls

46 lines (28 loc) · 2.28 KB

Building font-render-tester

Requirements

Font-Render-Tester is written in C++ and the build script is set to expect C++23 level of feature set. At the moment only Visual Studio 2022 is extensively compiled against. If you are using other compilers and have issues with, please feel free to report an issue or submit a pull request.

In order to compile with Visual Studio 2022, it must be setup with C++ features. Make sure to install Desktop development with C++ workload.

This project requires CMake and VCPKG Library Manager. Please follow the installation instruction of each tools.

Also, the environment VCPKG_ROOT is needed and it should point to the root directory of VCPKG (eg. c:\vcpkg)

Building with IDE

Visual Studio Code

Microsoft's CMake Tools Extension is recommended.

You should be able to open the project in Visual Studio Code and it will automatically setup anything needed, given that you have the C++ extension installed.

Upon the configure step at the first, the IDE will ask for the configure preset to use. Please select the default preset as it will setup build to use VCPKG.

Visual Studio 2022

In Visual Studio 2022, use Open a local folder or File->Open->Folder... in order to open the project.

Upon opening the project, Visual Studio will configure the project. This includes downloading any dependencies the project needs.

After the configure step is done, you should be able to run or debug the project right away.

Building with command line

  1. Change directory into the source directory.

  2. Run the following command:

    $ cmake --preset=default

    This will create a build directory call build and configure the project inside that directory.

    The configuring process includes downloading dependencies from the VCPKG repository and building those dependencies. This will take a while.

  3. To build the project, run the following command:

    $ cmake --build ./build --config=Release

The executable files, along with required dll files and font files will be created at <source_dir>/build/Release.