Lines Matching full:build
1 # Build Instructions
7 - [Build Instructions](#build-instructions)
12 - [Build Requirements](#build-requirements)
20 - [Build and Install Directory Locations](#build-and-install-directory-locations)
26 - [Build Options](#build-options)
29 - [Windows Build - Microsoft Visual Studio](#windows-build---microsoft-visual-studio)
32 - [Build the Solution From the Command Line](#build-the-solution-from-the-command-line)
33 - [Build the Solution With Visual Studio](#build-the-solution-with-visual-studio)
38 - [Linux Build](#linux-build)
41 - [Build the Project](#build-the-project)
43 - [WSI Support Build Options](#wsi-support-build-options)
49 - [MacOS build](#macos-build)
70 This repository contains the source code necessary to build the desktop Vulkan
81 ## Build Requirements
117 required to build the loader.
124 To build the tests, pass both `-D UPDATE_DEPS=ON` and `-D BUILD_TESTS=ON` options when generating t…
134 System/language package managers have to build on multiple different platforms and compilers.
140 ### Build and Install Directory Locations
142 A common convention is to place the `build` directory in the top directory of
143 the repository and place the `install` directory as a child of the `build`
150 to gather and build the dependent repositories mentioned above.
170 cmake -S . -B build -D UPDATE_DEPS=On
171 cmake --build build
176 To manually update the dependencies you now must create the build folder, and
177 run the update deps script followed by the necessary CMake build commands:
180 mkdir build
181 cd build
184 cmake --build .
201 the build files.
224 cmake -S . -B build -D LOADER_CODEGEN=ON
225 cmake --build . --target loader_codegen
228 ### Build Options
230 When generating build files through CMake, several options can be specified to
231 customize the build.
237 | BUILD_WSI_XCB_SUPPORT | Linux | `ON` | Build the loader with the XCB entry p…
238 | BUILD_WSI_XLIB_SUPPORT | Linux | `ON` | Build the loader with the Xlib entry …
239 | BUILD_WSI_WAYLAND_SUPPORT | Linux | `ON` | Build the loader with the Wayland ent…
240 | BUILD_WSI_DIRECTFB_SUPPORT | Linux | `OFF` | Build the loader with the DirectFB en…
241 | BUILD_WSI_SCREEN_QNX_SUPPORT | QNX | `OFF` | Build the loader with the QNX Screen …
243 | USE_GAS | Linux | `ON` | Controls whether to build assembly fi…
244 | USE_MASM | Windows | `ON` | Controls whether to build assembly fi…
258 …ific version information for the Loader DLL. Format is "major.minor.patch.build". …
283 ### Windows Build - Microsoft Visual Studio
286 files. Then either run CMake with the `--build` option to build from the
295 mkdir build
296 cd build
298 cmake --build .
308 create a build directory and generate the Visual Studio project files:
311 mkdir build
312 cd build
316 > repository. If you place your build directory someplace else, you'll need to
336 the build directory.
338 At this point, you can build the solution from the command line or open the
341 #### Build the Solution From the Command Line
343 While still in the build directory:
345 cmake --build .
347 to build the Debug configuration (the default), or:
349 cmake --build . --config Release
351 to make a Release build.
353 #### Build the Solution With Visual Studio
356 build folder. You may select "Debug" or "Release" from the Solution
357 Configurations drop-down list. Start a build by selecting the Build->Build
363 the primary build artifacts to a specific location using a "bin, include, lib"
368 with the `CMAKE_INSTALL_PREFIX` variable when first generating the project build
371 You can build the install target from the command line with:
373 cmake --build . --config Release --target install
375 or build the `INSTALL` target from the Visual Studio solution explorer.
389 sudo apt-get install git build-essential libx11-xcb-dev \
392 ### Linux Build
395 CMake with the `--build` option or `make` to build from the command line.
400 mkdir build
401 cd build
410 create a build directory and generate the make files.
413 mkdir build
414 cd build
420 > repository. If you place your `build` directory someplace else, you'll need
423 Use `-D CMAKE_BUILD_TYPE` to specify a Debug or Release build.
438 #### Build the Project argument
440 You can just run `make` to begin the build.
442 To speed up the build on a multi-core machine, use the `-j` option for `make`
443 to specify the number of cores to use for the build. For example:
449 cmake --build .
453 #### WSI Support Build Options
456 display servers: Xcb, Xlib, and Wayland. It is recommended to build the
458 usability across Linux platforms. If it is necessary to build these modules
464 Installing the files resulting from your build to the systems directories is
471 directory is still `build`, you can execute:
476 specified when creating the build files with CMake:
485 install to `/tmp/build` instead of `/usr/local`, on your CMake command line
488 -D CMAKE_INSTALL_PREFIX=/tmp/build
491 `/tmp/build`. This may be useful for collecting the artifacts and providing
497 `/tmp/build` causes the loader to search
498 `/tmp/build/etc/vulkan/explicit_layer.d` and
499 `/tmp/build/share/vulkan/explicit_layer.d` for the layer JSON files. The
502 searching the two locations under `/tmp/build`.
537 Finally, build the repository normally as explained above.
562 ### MacOS build
578 mkdir build
579 cd build
583 To speed up the build on a multi-core machine, use the `-j` option for `make`
584 to specify the number of cores to use for the build. For example:
592 mkdir build-xcode
593 cd build-xcode
597 Within Xcode, you can select Debug or Release builds in the project's Build
602 Fuchsia uses the project's GN build system to integrate with the Fuchsia platform build.
611 QNX is using its own build system. The proper build environment must be set
616 It will build the ICD loader for all CPU targets supported by QNX.
644 To build tests, make sure that the `BUILD_TESTS` option is set to true. Using
648 tests. To run the tests, change the directory to that of the build direction, and