INSTALL.md (1598B)
1 # Build instructions for libcubeb 2 3 You must have CMake v3.14 or later installed. 4 5 1. `git clone --recursive https://github.com/mozilla/cubeb.git` 6 2. `cd cubeb` 7 3. `cmake -B ./build .` 8 4. `cmake --build ./build` 9 5. `cd build && ctest` 10 11 # Windows build notes 12 13 Windows builds can use Microsoft Visual Studio 2015, Microsoft Visual Studio 14 2017, or MinGW-w64 with Win32 threads (by passing `cmake -G` to generate the 15 appropriate build configuration). 16 17 ## Microsoft Visual Studio 2015 or 2017 Command Line 18 19 CMake can be used from the command line by following the build steps at the top 20 of this file. CMake will select a default generator based on the environment, 21 or one can be specified with the `-G` argument. 22 23 ## Microsoft Visual Studio 2017 IDE 24 25 Visual Studio 2017 adds in built support for CMake. CMake can be used from 26 within the IDE via the following steps: 27 28 - Navigate to `File -> Open -> Cmake...` 29 - Open `CMakeLists.txt` file in the root of the project. 30 31 Note, to generate the build in the cubeb dir CMake settings need to be updated 32 via: `CMake -> Change CMake Settings -> CMakeLists.txt`. The default 33 configuration used by Visual Studio will place the build in a different location 34 than the steps detailed at the top of this file. 35 36 ## MinGW-w64 37 38 To build with MinGW-w64, install the following items: 39 40 - Download and install MinGW-w64 with Win32 threads. 41 - Download and install CMake. 42 - Run MinGW-w64 Terminal from the Start Menu. 43 - Follow the build steps at the top of this file, but at step 4 run: 44 `cmake -G "MinGW Makefiles" ../cubeb` 45 - Continue the build steps at the top of this file.