Programming Howto:Configure BCI2000 for Compilation
Back
To this howto's overview page.
Run the CMake GUI
Double-click "Configure.sh.cmd" in your BCI2000 build directory.
Tell CMake which Qt installation to use
Click "AddEntry" in the CMake window ...
- Note that checking of "Advanced" in Cmake is optional and does not impact the compilation
... and enter the path to a Qt directory that is consistent with the compiler you are going to use. Use CMAKE_PREFIX_PATH as the name for the new entry. Be aware that the entry's name is case sensitive. Be sure to download the correct version of Qt for the build version you plan to use, and verify the compatibility of the versions of Qt and Visual Studio used.
Visual Studio and Qt Compatibility | |||||
---|---|---|---|---|---|
Visual Studio 2017 | Qt 5.12.12 | ||||
Visual Studio 2019 | Qt 5.15.2 | ||||
Visual Studio 2022 | Qt 6.2.4 |
Note that BCI2000 is most frequently tested using Visual Studio 2019 and Qt 5.15.2, and that the table above shows the suggested versions of Visual Studio and Qt to use together. Also note: Qt versions built for Visual Studio 2019 are compatible with Visual Studio 2022 as well.
Perform the configuration step
In the CMake window, click "Configure" ...
... and choose a generator that is consistent with your compiler, and with the Qt directory chosen above. Then click "Finish" to perform the configuration step.
You will see a list of targets scrolling by, and a number of new entries in the variable list at the top of the window, marked in red.
Choose build options
Make sure the "Grouped" checkbox is checked, and configure the build by customizing values in the "BUILD" ...
... "EXTENSIONS" group,
... and "USE" group. Make sure to uncheck USE_APPLICATION_BUNDLES to avoid problems with compiling. Then, click "Generate" to create build files.
When CMake displays its "Generating done" message, ...
... your BCI2000 build directory will now contain a VisualStudio solution file, as well as a number of additional CMake-generated files.
Next step
As a next step, learn how to compile BCI2000.