Windows: Show the use of "update_external_sources.bat"

This commit is contained in:
Ian Elliott 2015-07-08 15:43:03 -06:00
parent 66de8b95f0
commit a2d5da4634

View File

@ -134,7 +134,7 @@ EOF
## Windows System Requirements ## Windows System Requirements
Windows 7+ with additional, software: Windows 7+ with additional required software packages:
- Microsoft Visual Studio 2013 Professional. Note: it is possible that lesser/older versions may work, but that has not been tested. - Microsoft Visual Studio 2013 Professional. Note: it is possible that lesser/older versions may work, but that has not been tested.
- CMake (from http://www.cmake.org/download/). Notes: - CMake (from http://www.cmake.org/download/). Notes:
@ -154,25 +154,27 @@ Windows 7+ with additional, software:
- A windows batch file has been included that will pull and build the correct version. Run it from Developer Command Prompt for VS2013 like so: - A windows batch file has been included that will pull and build the correct version. Run it from Developer Command Prompt for VS2013 like so:
- update_external_sources.bat --build-glslang - update_external_sources.bat --build-glslang
- Optional Packages: Optional software packages:
- Qt 5.3 (from http://www.qt.io/download/). Notes:
- Qt 5.3 is required in order to build the Glave debugger (GUI). The Glave trace and replay tools can be built without Qt, but the debugger/GUI is built on top of Qt 5.3. Various dependencies, from the Qt package are copied to the directory where the Glave debugger and its libraries are built. In order to copy and run the debugger in another directory, these libraries must also be copied. Other notes: - Qt 5.3 (from http://www.qt.io/download/). Notes:
- While there are commercial licenses, you can also use the "Community" (free) license. - Qt 5.3 is required in order to build the Glave debugger (GUI). The Glave trace and replay tools can be built without Qt, but the debugger/GUI is built on top of Qt 5.3. Various dependencies, from the Qt package are copied to the directory where the Glave debugger and its libraries are built. In order to copy and run the debugger in another directory, these libraries must also be copied. Other notes:
- By default, the installer will select the latest version (e.g. Qt 5.4) as well as some other components. You must select "Qt 5.3"! You can have multiple versions installed (e.g. Qt 5.2.1, 5.3, and 5.4). - While there are commercial licenses, you can also use the "Community" (free) license.
- Installing Qt takes a long time. - By default, the installer will select the latest version (e.g. Qt 5.4) as well as some other components. You must select "Qt 5.3"! You can have multiple versions installed (e.g. Qt 5.2.1, 5.3, and 5.4).
- Cygwin (from https://www.cygwin.com/). Notes: - Installing Qt takes a long time.
- Cygwin provides some Linux-like tools, which are valuable for obtaining the source code, and running CMake. - Cygwin (from https://www.cygwin.com/). Notes:
Especially valuable are the BASH shell and git packages. - Cygwin provides some Linux-like tools, which are valuable for obtaining the source code, and running CMake.
- If you don't want to use Cygwin, there are other shells and environments that can be used. Especially valuable are the BASH shell and git packages.
You can also use a Git package that doesn't come from Cygwin. - If you don't want to use Cygwin, there are other shells and environments that can be used.
You can also use a Git package that doesn't come from Cygwin.
## Windows Build ## Windows Build
Cygwin is used in order to obtain a local copy of the Git repository, and to run the CMake command that creates Visual Studio files. Visual Studio is used to build the software, and will re-run CMake as appropriate. Cygwin is used in order to obtain a local copy of the Git repository, and to run the CMake command that creates Visual Studio files. Visual Studio is used to build the software, and will re-run CMake as appropriate.
Example debug build: Example debug build (e.g. in a "Developer Command Prompt for VS2013" window):
``` ```
cd GL-Next # cd to the root of the vk git repository cd LoaderAndTools # cd to the root of the Vulkan git repository
update_external_sources.bat --build-glslang
mkdir _out64 mkdir _out64
cd _out64 cd _out64
cmake -G "Visual Studio 12 Win64" -DCMAKE_BUILD_TYPE=Debug .. cmake -G "Visual Studio 12 Win64" -DCMAKE_BUILD_TYPE=Debug ..