Programming Howto:Building BCI2000: Difference between revisions
No edit summary |
No edit summary |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This document describes how to build BCI2000, i.e. how to create the BCI2000 executables from their source code. | The process of building BCI2000 from source differs between Windows and non-Windows (macOS, Linux) systems. | ||
There are step-by-step tutorials for each: | |||
* [[Programming Howto:Building and Customizing BCI2000|Building and Customizing BCI2000 for Windows systems]], | |||
* [[Programming Howto:Non:Building and Customizing BCI2000 on Non-Windows Platforms|Building and Customizing BCI2000 for macOS and Linux]]. | |||
<!-- This document describes how to build BCI2000, i.e. how to create the BCI2000 executables from their source code. | |||
==Prerequisites== | ==Prerequisites== | ||
#A C++ compiler. Currently, MSVC | #A C++ compiler. Currently, MSVC 2017 and 2019 are supported. | ||
#To build GUI-related parts of BCI2000, a recent version of Qt5 is required. Use Qt's maintenance tool to select and install a version of Qt that matches your C++ compiler. | #To build GUI-related parts of BCI2000, a recent version of Qt5 is required. Use Qt's maintenance tool to select and install a version of Qt that matches your C++ compiler. | ||
#CMake 3.11 or newer. Choose "add to path for all users" when prompted by the installer. | #CMake 3.11 or newer. Choose "add to path for all users" when prompted by the installer. | ||
| Line 12: | Line 18: | ||
#In the CMake GUI, click "Add Entry". | #In the CMake GUI, click "Add Entry". | ||
#Under Name, enter "Qt5_DIR" (case matters), and set "Type" to "PATH". | #Under Name, enter "Qt5_DIR" (case matters), and set "Type" to "PATH". | ||
#Under Value, enter the path to your Qt distribution's | #Under Value, enter the path to your Qt distribution's <tt>lib/cmake/Qt5</tt> directory. | ||
E.g., if your Qt distribution for MSVC | E.g., if your Qt distribution for MSVC 2019, 64 bit, is located under <tt>D:/Qt/5.10.1/msvc2019_64</tt>, the "Qt5_DIR" CMake variable should point to <tt>D:/Qt/5.10.1/msvc2019_64/lib/cmake/Qt5</tt>. | ||
===3. Click "Configure"=== | ===3. Click "Configure"=== | ||
From the list of compilers, choose the compiler that | From the list of compilers, choose the compiler that you would like to use. | ||
If using Qt, the compiler must match the Qt distribution chosen above. | |||
===4. Choose build options=== | ===4. Choose build options=== | ||
#Make sure that "Grouped" is checked in the GUI, and "Advanced" is unchecked. | #Make sure that "Grouped" is checked in the GUI, and "Advanced" is unchecked. | ||
| Line 24: | Line 33: | ||
===6. Build BCI2000 in full, or partially=== | ===6. Build BCI2000 in full, or partially=== | ||
In the IDE, choose which projects to build. You may right-click individual projects, or groups of projects, and choose "build" from the context menu. | In the IDE, choose which projects to build. You may right-click individual projects, or groups of projects, and choose "build" from the context menu. | ||
--> | |||
[[Category:Howto]][[Category:Development]] | [[Category:Howto]][[Category:Development]] | ||
Latest revision as of 14:38, 10 March 2025
The process of building BCI2000 from source differs between Windows and non-Windows (macOS, Linux) systems.
There are step-by-step tutorials for each: