2020-01-10 04:59:53 +00:00
|
|
|
# Build instructions for libcubeb
|
|
|
|
|
2022-08-05 07:28:17 +00:00
|
|
|
You must have CMake v3.14 or later installed.
|
2020-01-10 04:59:53 +00:00
|
|
|
|
2022-08-05 07:28:17 +00:00
|
|
|
1. `git clone --recursive https://github.com/mozilla/cubeb.git`
|
|
|
|
2. `cd cubeb`
|
|
|
|
3. `cmake -B ./build .`
|
|
|
|
4. `cmake --build ./build`
|
|
|
|
5. `cd build && ctest`
|
2020-01-10 04:59:53 +00:00
|
|
|
|
|
|
|
# Windows build notes
|
|
|
|
|
|
|
|
Windows builds can use Microsoft Visual Studio 2015, Microsoft Visual Studio
|
|
|
|
2017, or MinGW-w64 with Win32 threads (by passing `cmake -G` to generate the
|
|
|
|
appropriate build configuration).
|
|
|
|
|
|
|
|
## Microsoft Visual Studio 2015 or 2017 Command Line
|
|
|
|
|
|
|
|
CMake can be used from the command line by following the build steps at the top
|
|
|
|
of this file. CMake will select a default generator based on the environment,
|
|
|
|
or one can be specified with the `-G` argument.
|
|
|
|
|
|
|
|
## Microsoft Visual Studio 2017 IDE
|
|
|
|
|
|
|
|
Visual Studio 2017 adds in built support for CMake. CMake can be used from
|
|
|
|
within the IDE via the following steps:
|
|
|
|
|
|
|
|
- Navigate to `File -> Open -> Cmake...`
|
|
|
|
- Open `CMakeLists.txt` file in the root of the project.
|
|
|
|
|
|
|
|
Note, to generate the build in the cubeb dir CMake settings need to be updated
|
|
|
|
via: `CMake -> Change CMake Settings -> CMakeLists.txt`. The default
|
|
|
|
configuration used by Visual Studio will place the build in a different location
|
|
|
|
than the steps detailed at the top of this file.
|
|
|
|
|
|
|
|
## MinGW-w64
|
|
|
|
|
|
|
|
To build with MinGW-w64, install the following items:
|
|
|
|
|
|
|
|
- Download and install MinGW-w64 with Win32 threads.
|
|
|
|
- Download and install CMake.
|
|
|
|
- Run MinGW-w64 Terminal from the Start Menu.
|
2022-08-05 07:28:17 +00:00
|
|
|
- Follow the build steps at the top of this file, but at step 4 run:
|
|
|
|
`cmake -G "MinGW Makefiles" ../cubeb`
|
2020-01-10 04:59:53 +00:00
|
|
|
- Continue the build steps at the top of this file.
|