Sane C++ Libraries
C++ Platform Abstraction Libraries
Building (Contributor)

Table of Contents

Follow this guide if you're interested in building the library to contribute (check CONTRIBUTING.md! and Coding Style) or you're simply curious to run the test suite.

Generate projects

The test suite and example projects uses the handmade / self-hosted SC::Build system, that describes builds in C++

Command-line

  • Generate projects
    • Windows: SC.bat build configure
    • Posix: SC.sh build configure
  • Open generated projects (in _Build/_Projects).
Note
Check the Tools page for more details on invoking SC.sh build.

VSCode

Under VSCode select Tasks: Run Task and choose:

  • Generate Projects

Build the test suite

Command-line

Intel Machines

  • Windows: SC.bat build compile Debug default intel64
  • Posix: SC.sh build compile Debug default intel64

Arm Machines

  • Windows: SC.bat build compile Debug default arm64
  • Posix: SC.sh build compile Debug default arm64

Visual Studio 2022

  • Open _Build/_Projects/VisualStudio2022/SCTest.sln
  • Build the default configuration target (or another one you prefer)

XCode

  • Open _Build/_Projects/XCode/SCTest.xcodeproj/project.xcworkspace
  • Build the default configuration target (or another one you prefer)

Makefile

  • Linux: cd _Build/_Projects/Makefile/linux
  • macOS: cd _Build/_Projects/Makefile/apple
  • Build Debug: make -j SCTest
  • Build Release: make -j SCTest CONFIG=Release

VScode on macOS

Under VSCode select Tasks: Run Task and choose an appropriate targets like:

  • Build SCTest Debug intel64 [1]
  • Build SCTest Debug arm64 [1]
  • Build SCTest Release intel64 [1]
  • Build SCTest Release arm64 [1]
Note
[1] Uses make and c++ command (can be switched to be clang or gcc). Builds only current host architecture (arm64 or x86_64). Still needs XCode installed for the sysroot.

VSCode on Linux

Under VSCode select Tasks: Run Task and choose an appropriate targets like:

  • Build SCTest Debug intel64 [1]
  • Build SCTest Debug arm64 [1]
  • Build SCTest Release intel64 [1]
  • Build SCTest Release arm64 [1]
Note
[1] Uses make and c++ commands. Builds only current host architecture (arm64 or x86_64).

VSCode on Windows

Under VSCode select Tasks: Run Task and choose an appropriate targets like:

  • Build SCTest Debug intel64 [1]
  • Build SCTest Debug arm64 [1]
  • Build SCTest Release intel64 [1]
  • Build SCTest Release arm64 [1]
Note
[1] Needs Visual Studio 2022 installed

Run the tests

Executables will be at _Build/_Outputs/${platform}-${arch}-${build}-${compiler}-${config}/${EXAMPLE_NAME}.
For example assuming host to be ARM64 Linux, compiling with Clang in Debug will cause the folder to be _Build/_Outputs/linux-arm64-make-clang-Debug/SCTest.

Debug the tests

Visual Studio or XCode

Running the default target should work out of the box, as paths are already generated accordingly.

VSCode on macOS or Linux

Select one of the appropriate Run and Debug configuration like:

  • SCTest intel64 [apple] (gdb) [1]
  • SCTest intel64 [apple] (lldb) [2]
  • SCTest arm64 [apple] (gdb) [1]
  • SCTest arm64 [apple] (lldb) [2]
  • SCTest intel64 [linux] (gdb) [1]
  • SCTest intel64 [linux] (lldb) [2]
  • SCTest arm64 [linux] (gdb) [1]
  • SCTest arm64 [linux] (lldb) [2]
Note
[1] Uses gdb debugger. Implicitly invokes Build SCTest Debug to build the executable.
[2] Uses lldb debugger. Implicitly invokes Build SCTest Debug to build the executable. You need CodeLLDB or similar extension installed in VSCode.

VSCode on Windows

Select one of the appropriate Run and Debug configuration like:

  • SCTest intel64 [windows] [1]
  • SCTest arm64 [windows] [1]
Note
[1] Needs Visual Studio 2022 installed

Build the documentation

The SC-build.cpp from SC::Tool downloads Doxygen and some customization themes and then builds the documentation in _Build/_Documentation.

Command-line

  • Windows: SC.bat build documentation
  • Posix: SC.sh build documentation

VSCode

Under VSCode select Tasks: Run Task and choose:

  • Build Documentation