diff options
Diffstat (limited to 'INSTALL.md')
-rw-r--r-- | INSTALL.md | 54 |
1 files changed, 21 insertions, 33 deletions
@@ -1,36 +1,24 @@ # Build instructions for libcubeb -Note Also:Cubeb does not currently build under Cygwin, but this is being worked on. - -0. Change directory into the source directory. -1. Run |autoreconf --install| to generate configure. -2. Run |./configure| to configure the build. -3. Run |make| to build. -4. Run |make check| to run the test suite. - -# Debugging - -Debugging tests can be done like so: - -```libtool --mode=execute gdb test/test_tone``` - -# Windows build prerequisite, using `msys2` - -Cubeb for Windows uses win32 threads - -- Download and install `msys2` 32-bits from <https://msys2.github.io>. Let it - install in `C:\msys32`. -- Download and install `7z` from <http://www.7-zip.org/>. -- Run `msys2` (a shortcut has been added to the start menu, or use the `.bat` - script: `C:\msys32\mingw32_shell.bat`), and issue the following commands to - install the dependencies: -``` -pacman -S git automake autoconf libtool m4 make pkg-config gdb -``` -- Download a `mingw` compiler with the WIN32 thread model [here](http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/4.9.2/threads-win32/sjlj/i686-4.9.2-release-win32-sjlj-rt_v3-rev0.7z/download). `msys2` does not have `mingw` builds with win32 threads, -so we have to install another compiler. -- Unzip the compiler, and copy all folders in `C:\msys32\opt` -- Exit the `msys2` shell, and run `C:\msys32\autorebase.bat` (double clicking - works). -- Open an `msys2` shell and follow the build instructions. +You must have CMake v3.1 or later installed. + +1. `git clone https://github.com/kinetiknz/cubeb.git` +2. `mkdir cubeb-build` +3. `cd cubeb-build` +3. `cmake ../cubeb` +4. `cmake --build .` +5. `ctest` + +# Windows build notes + +Windows builds can use Microsoft Visual Studio 2015 (the default) or MinGW-w64 +with Win32 threads (by passing `cmake -G` to generate the appropriate build +configuration). 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. +- Follow the build steps above, but at step 3 run: + `cmake -G "MinGW Makefiles" ..` +- Continue the build steps above. |