Microsoft Visual Studio

2017 (and 2013, 2015)

For Visual Studio 2017 a ready-to-use solution is provided. It contains:

  • essentials - source code of the essentials library

  • essentials_unit_tests - source code of the unit tests

  • build - folder containing the property sheets for the projects

  • essentials.sln - the solution file that contains the two projects mentioned above

  • license folder - the licenses in pdf formats (German and English versions of private/scientific and commercial licenses)

To use the provided solution:

  • Open the solution $EDIR\essentials\essentials.sln with Microsoft Visual Studio 2017.

  • [optional] In order to use essentials with C++03 support, you need to build essentials with the preprocessor macro SX_CPP03_BOOST set and also provide paths to the boost headers and libraries in the project settings (see instructions below).

  • Choose the configuration you want to build essentials for and build the project.
    The available default configurations are:

    • Debug - VS 2017

    • Debug - VS 2015

    • Release - VS 2017

    • Release - VS 2015

    • Debug C++03

    • Release C++03

  • [optional] If you want to use essentials with C++03 and/or you want to run the unit tests, you have to configure where Boost is located on your system. If you only want to use the essentials library with C++11 you can omit this step.
    Change BOOST path in the property sheet 'use_boost'

    • Go to 'Property Manager'

    • open property sheet 'use_boost'

    • Go to 'User Macros'

    • set BOOST_PATH and BOOST_LIB_PATH accordingly to your system. BOOST_PATH needs to points to the directory containing boost include folder and BOOST_LIB_PATH needs to point to the directory containing the boost libraries.

    • Press 'OK' to save the changes.

  • Build the solution essentials or the essentials library project

  • The default output location is the folder $EDIR\essentials\$(Platform)\$(Config).

After the build the essentials library can be integrated into your projects.