xtd - Reference Guide  0.1.1
Modern c++17/20 framework to create console, GUI and unit test applications on Windows, macOS, Linux, iOS and android.
CMake build options

Contains xtd CMake build options.

Remarks
These options are only needed if you are not using the installation and want a custom build.

xtd build options

Option Name Type Description Default Value
XTD_BUILD_CPP_STANDARD string Choose c++ standard to build xtd projects (20 17 14 11 compiler_default) 20
XTD_BUILD_LIBRARIES_XTD_CORE bool Build xtd.core libraries ON
XTD_BUILD_LIBRARIES_XTD_DRAWING bool Build xtd.drawing libraries ON
XTD_BUILD_LIBRARIES_XTD_FORMS bool Build xtd.forms libraries ON
XTD_BUILD_LIBRARIES_XTD_TUNIT bool Build xtd.tunit libraries ON
XTD_BUILD_SHARED_LIBRARIES bool Build shared libraries OFF
XTD_BUILD_TESTS_XTD_CORE bool Build xtd.core tests OFF
XTD_BUILD_TESTS_XTD_DRAWING bool Build xtd.drawing tests OFF
XTD_BUILD_TESTS_XTD_FORMS bool Build xtd.forms tests OFF
XTD_BUILD_TESTS_XTD_TUNIT bool Build xtd.tunit tests OFF
XTD_BUILD_TOOL_GUIDGEN_COMMAND_LINE bool Build tool guidgen command line ON
XTD_BUILD_TOOL_GUIDGEN_GUI bool Build tool guidgen GUI ON
XTD_BUILD_TOOL_SLEEPFOR_COMMAND_LINE bool Build tool sleepfor command line ON
XTD_BUILD_TOOL_XTDC_COMMAND_LINE bool Build tool xtdc command line ON
XTD_BUILD_TOOL_XTDC_GUI bool Build tool xtdc GUI ON
XTD_DOWNLOAD_DOXYGEN bool Download and build doxygen from Github OFF
XTD_ENABLE_COMMAND_REFERENCE_GUIDE_GENERATOR bool Enable command Reference Guide Generator OFF
XTD_ENABLE_COVERAGE bool Enable code coverage OFF
XTD_INSTALL_EXAMPLES bool Install examples ON
XTD_INSTALL_RESOURCES bool Install resources ON
XTD_NATIVE_GRAPHIC_TOOLKIT string Choose toolkit for native drawing and forms libraries (see note 1) wxwidgets
XTD_NATIVE_OPERATING_SYSTEM string Choose Operating System for native system libraries (Windows macOS linux iOS android) The current host OS
XTD_SET_COMPILER_OPTION_WARNINGS_AS_ERRORS bool Enable compiler option warnings as errors ON
XTD_SET_COMPILER_OPTION_WARNINGS_TO_ALL bool Enable compiler option warnings to all ON

(note 1) The list of the underlying graphic toolkit depends of the operating system :

  • Windows : msw wxwidgets qt5 fltk
  • macOS : cocoa wxwidgets qt5 fltk
  • linux : gtk4 gtk3 wxwidgets qt5 fltk
Remarks
xtd use only wxwigets underlying toolkits for all platform. But in the future xtd will use specific toolkit by platform :
  • Windows : msw
  • macOS : cocoa
  • linux : gtk4

xtd user project build options

Option Name Type Description Default Value
XTD_BUILD_CPP_STANDARD string Choose c++ standard to build xtd projects (20 17 14 11 compiler_default) 20
XTD_DOWNLOAD_DOXYGEN bool Download and build doxygen from Github OFF
XTD_ENABLE_COMMAND_REFERENCE_GUIDE_GENERATOR bool Enable command Reference Guide Generator ON
XTD_SET_COMPILER_OPTION_WARNINGS_AS_ERRORS bool Enable compiler option warnings as errors OFF
XTD_SET_COMPILER_OPTION_WARNINGS_TO_ALL bool Enable compiler option warnings to all ON