Installing/Windows CMake

Prerequisites

• installed Visual Studio
• installed cmake for windows https://cmake.org/download/
• installed libraries (Xerces-C, Proj, GDAL, Fox)

How To

• fresh git checkout (e.g. git clone --recursive https://github.com/DLR-TS/sumo)
• start cmake gui
• select source path (e.g. C:/Users/me/sumo)
• select build path (C:/Users/me/sumo/cmake-build)
  • can be identical to source path but it is advised to separate
• Configuration (Press "Configure")
  • (Build dir should be created if necessary)
  • select compiler (default should do)
  • Lots of "red"
  • Scroll down to Xerces-C
  • Set include dir to <xercesdir>/include
  • Enter Libraries (something like <xercesdir>/lib/xerces-c3.lib and <xercesdir>/lib/xerces-c3D.lib)
  • Press "Configure" again
  • Enter dirs and libs for Proj and GDAL
  • Press "Configure" again
  • Enter dir and lib for Fox (ignore Fox-config!)
  • Press "Configure" again
  • Still lots of red can be ignored for now
• Create the Visual Studio solution (Press "Generate")
• Open C:/Users/me/sumo/cmake-build/SUMO.sln (from the explorer or by clicking on open project)
• Build the configurations you want
  • Binaries appear in C:/Users/me/sumo/bin

Additional options and fine tuning

• For a different target platform (e.g. 32bit) start cmake again, do not use Visual Studio to add a different platform
• To enable Libsumo add SWIG dir and exe for building Python and Java bindings
  • Make sure Python and a JDK are installed
  • Python will only work with the release build (unless you compile a debug version of Python yourself)
• For unit tests enable build_gtest_from_git
  • will need git in the path
  • will clone the gtest git repo
  • then enable build_gtest