| 
									
										
										
										
											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. |