...
- Cygwin. Some packages to make sure are installed are:
openssh
zip
unzip
make
(needed to compile media)makedepend
(needed for media)- Optional:
git
- Microsoft Visual Studio 20172019, either Professional or Community edition. The
Desktop development with C++
workload is required at most, but it may be possible to install individual components to satisfy the requirements. - Microsoft DirectShow header files – If you build media you will need the DirectShow header files from the Microsoft Windows SDK v7.1, installed in its default location of "C:\Program Files\Microsoft SDKs\Windows\v7.1".
...
You will likely need to set the following env variables to point to your VS 2017 2019 installation, since Microsoft no longer sets such variables. This presumes that:
- You installed JDK N in
C:\Program Files\Java\jdk-N
where N is the JDK version. - You installed the Community edition of Visual Studio 2017 2019 in
C:\Program Files (x86)\Microsoft Visual Studio\20172019\Community
. If this isn't set correctly, you might see an error during the build saying thatvcvars32.bat
is missing. - The folder name under
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC
is14.11.25503
. If this isn't set correctly, you might see an error during the:graphics:compileDecoraNativeShadersWin
build task saying thatcl.exe
is missing. If you update VS, the folder name might change and you'll have to reconfigure the variable.
You should adjust these as needed for your system.
Code Block |
---|
export VS150COMNTOOLS="C:\\Program Files (x86)\\Microsoft Visual Studio\\20172019\\Community\\VC\\Auxiliary\\Build" export JAVA_HOME="C:/Program Files/Java/jdk-N" export MSVC_VER=14.11.25503 |
Note the use of the double backslash in the VS150COMNTOOLS
env var. This is needed because the cygwin shell uses the '\' as an escape character. With JAVA_HOME
it is easier to just set it using forward slashes (although backslashes are fine as long as you escape them).
...
The initial build process that generates the needed resources is done by the \buildSrc
folder. On Windows, it tries to locate all the needed tools and write their paths to the \build\windows_tools.properties
file. Sometimes it fails and the file is left blank, which results in various path-not-found errors, e.g., on WINSDK_DIR
. This means that you will have to define these paths manually. For your convenience, here is a ready file from Win10 with VS2017 VS2019 Community edition. You will need to correct the user name and possibly the version numbers, but it should give an idea of what the build looks for:
Code Block | ||||
---|---|---|---|---|
| ||||
WINDOWS_VS_DEVENVDIR=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE WINDOWS_VS_DEVENVCMD=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/devenv.com WINDOWS_VS_VCINSTALLDIR=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC WINDOWS_VS_VSINSTALLDIR=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community WINDOWS_VS_MSVCDIR=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC WINDOWS_VS_INCLUDE=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/include;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.16.27023/include.28.29910/include;C:/Program Files (x86)/Windows Kits/NETFXSDK/4.8/include/um;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/ucrt;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/shared;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/um;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/winrt;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/cppwinrt;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/include;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.16.27023/include28.29910/include;C:/Program Files (x86)/Windows Kits/NETFXSDK/4.8/include/um;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/ucrt;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/shared;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/um;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/winrt;C:/Program Files (x86)/Windows Kits/10/include/10.0.1776319041.0/cppwinrt WINDOWS_VS_LIB=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/lib/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/lib/x64;C:/Program Files (x86)/Windows Kits/NETFXSDK/4.8/lib/um/x64;C:/Program Files (x86)/Windows Kits/10/lib/10.0.1776319041.0/ucrt/x64;C:/Program Files (x86)/Windows Kits/10/lib/10.0.1776319041.0/um/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/lib/x86;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.16.2702328.29910/lib/x86;C:/Program Files (x86)/Windows Kits/NETFXSDK/4.8/lib/um/x86;C:/Program Files (x86)/Windows Kits/10/lib/10.0.1776319041.0/ucrt/x86;C:/Program Files (x86)/Windows Kits/10/lib/10.0.1776319041.0/um/x86; WINDOWS_VS_LIBPATH=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/lib/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/lib/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/lib/x86/store/references;C:/Program Files (x86)/Windows Kits/10/UnionMetadata/10.0.1776319041.0;C:/Program Files (x86)/Windows Kits/10/References/10.0.1776319041.0;C:/Windowswindows/Microsoft.NET/Framework64/v4.0.30319;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/ATLMFC/lib/x86;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/lib/x86;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/lib/x86/store/references;C:/Program Files (x86)/Windows Kits/10/UnionMetadata/10.0.1776319041.0;C:/Program Files (x86)/Windows Kits/10/References/10.0.1776319041.0;C:/Windowswindows/Microsoft.NET/Framework/v4.0.30319; WINDOWS_VS_PATH=;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/Common7/IDE/Extensions/Microsoft/IntelliCode/CLI;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.1628.2702329910/bin/HostX64/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/VC/VCPackages;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensions/Microsoft/TestWindow;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensions/Microsoft/TeamFoundation/Team Explorer;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/MSBuild/15.0Current/bin/Roslyn;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Team Tools/Performance Tools/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Team Tools/Performance Tools;C:/Program Files (x86)/Microsoft Visual Studio/Shared/Common/VSPerfCollectionTools/vs2019/x64;C:/Program Files (x86)/Microsoft Visual Studio/Shared/Common/VSPerfCollectionTools/vs2019/;C:/Program Files (x86)/Microsoft SDKs/Windows/v8v10.1A0A/bin/NETFX 4.5.18 Tools/x64/;C:/Program Files (x86)/Windows Kits/10/bin/10.0.17763.0/x64HTML Help Workshop;C:/Program Files (x86)/WindowsMicrosoft Visual KitsStudio/102019/bin/x64Community/Common7/IDE/CommonExtensions/Microsoft/FSharp/;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/MSBuildCommon7/15.0Tools/bindevinit;C:/Program Files (x86)/Windows Kits/Microsoft.NET10/Framework64bin/v410.0.19041.303190/x64;C:/Program Files (x86)/MicrosoftWindows Visual StudioKits/201710/Community/Common7/IDE/bin/x64;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/Tools//MSBuild/Current/Bin;C:/windows/Microsoft.NET/Framework64/v4.0.30319;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Tools/MSVC/14.16.27023/bin/HostX86/x86Common7/IDE/;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDETools/VC/VCPackages;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensionsExtensions/Microsoft/IntelliCode/TestWindowCLI;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/VC/Common7Tools/IDE/CommonExtensions/Microsoft/TeamFoundation/Team ExplorerMSVC/14.28.29910/bin/HostX86/x86;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/MSBuildCommon7/15.0IDE/binVC/RoslynVCPackages;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Team Tools/Performance Tools/Common7/IDE/CommonExtensions/Microsoft/TestWindow;C:/Program Files (x86)/Microsoft Visual Studio/Shared/Common/VSPerfCollectionTools/2019/Community/Common7/IDE/CommonExtensions/Microsoft/TeamFoundation/Team Explorer;C:/Program Files (x86)/Microsoft SDKs/Windows/v8.1A/bin/NETFX 4.5.1 Tools/ Visual Studio/2019/Community/MSBuild/Current/bin/Roslyn;C:/Program Files (x86)/WindowsMicrosoft Visual KitsStudio/102019/bin/10.0.17763.0/x86Community/Team Tools/Performance Tools;C:/Program Files (x86)/Windows Kits/10/bin/x86Microsoft Visual Studio/Shared/Common/VSPerfCollectionTools/vs2019/;C:/Program Files (x86)/Microsoft Visual StudioSDKs/2017Windows/Communityv10.0A/MSBuildbin/15.0/binNETFX 4.8 Tools/;C:/Windows/Microsoft.NET/Framework/v4.0.30319Program Files (x86)/HTML Help Workshop;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensions/Microsoft/FSharp/;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/Tools/devinit;C:/Program Files/Java/jdk-12 (x86)/Windows Kits/10/bin/server10.0.19041.0/x86;C:/Program Files/Java/jdk-12/bin (x86)/Windows Kits/10/bin/x86;C:/Program Files/Java/jdk-12/bin (x86)/Microsoft Visual Studio/2019/Community/MSBuild/Current/Bin;C:/windows/Microsoft.NET/Framework/v4.0.30319;C:/Program Files (x86)/NVIDIA Corporation/PhysX/CommonMicrosoft Visual Studio/2019/Community/Common7/IDE/;C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem/Program Files (x86)/Microsoft Visual Studio/2019/Community/Common7/Tools/;C:/WINDOWSUsers/System32runneradmin/WindowsPowerShellbootjdk/v1jdk-15.0.2/bin;C:/Users/Nirrunneradmin/build-tools/apache-ant-1.10.5/bin;C:/Users/Nir/apache-maven-3.5.0runneradmin/cygwin/cygwin64/bin;C:/Program Files/TortoiseHg/;$JAVA_HOMEUsers/runneradmin/cygwin/cygwin64/bin;C:/Program Files/Microsoft SQL Server/110/Tools/Binn/PowerShell/7;C:/Users/runneradmin/.dotnet/tools;C:/Program Files/MongoDB/Microsoft SQL Server/120/Tools/Binn/4.4/bin;C:/Program Files/PuTTY/aliyun-cli;C:/WINDOWS/System32/OpenSSH/vcpkg;C:/Program Files/Hugocf-cli;C:/Program Files (x86)/TortoiseGitNSIS/bin;C:/Program Files/GitMercurial/cmd;C:/Usershostedtoolcache/Nirwindows/AppData/Local/Microsoft/WindowsApps;;C:/Dev/eclipse jfx;;stack/2.5.1/x64;C:/tools/ghc-9.0.1/bin;C:/Program Files/dotnet;C:/mysql-5.7.21-winx64/bin;C:/Program Files/R/R-4.0.4/bin/x64;C:/SeleniumWebDrivers/GeckoDriver;C:/Program Files (x86)/sbt/bin;C:/Rust/.cargo/bin;C:/Program Files (x86)/GitHub CLI;C:/Program Files/Git/bin;C:/Program Files (x86)/pipx_bin;C:/hostedtoolcache/windows/go/1.15.8/x64/bin;C:/hostedtoolcache/windows/Python/3.7.9/x64/Scripts;C:/hostedtoolcache/windows/Python/3.7.9/x64;C:/hostedtoolcache/windows/Ruby/2.5.8/x64/bin;C:/Program Files/Java/jdk8u282-b08/bin;C:/npm/prefix;C:/Program Files/Microsoft SDKs/Azure/Azure Dev Spaces CLI;C:/Program Files/Microsoft SDKs/Azure/Azure Dev Spaces CLI/;C:/Program Files (x86)/Microsoft SDKs/Azure/CLI2/wbin;C:/ProgramData/kind;C:/windows/system32;C:/windows;C:/windows/System32/Wbem;C:/windows/System32/WindowsPowerShell/v1.0/;C:/windows/System32/OpenSSH/;C:/ProgramData/Chocolatey/bin;C:/Program Files/Microsoft/Web Platform Installer/;C:/Program Files/Docker;C:/Program Files/PowerShell/7/;C:/Program Files/dotnet/;C:/Program Files/Microsoft SQL Server/130/Tools/Binn/;C:/Program Files/Microsoft SQL Server/Client SDK/ODBC/170/Tools/Binn/;C:/Program Files (x86)/Windows Kits/10/Windows Performance Toolkit/;C:/Program Files (x86)/Microsoft SQL Server/110/DTS/Binn/;C:/Program Files (x86)/Microsoft SQL Server/120/DTS/Binn/;C:/Program Files (x86)/Microsoft SQL Server/130/DTS/Binn/;C:/Program Files (x86)/Microsoft SQL Server/140/DTS/Binn/;C:/Program Files (x86)/Microsoft SQL Server/150/DTS/Binn/;C:/Program Files/nodejs/;C:/ProgramData/chocolatey/lib/pulumi/tools/Pulumi/bin;C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.3/bin;C:/Program Files/Microsoft Service Fabric/bin/Fabric/Fabric.Code;C:/Program Files/Microsoft SDKs/Service Fabric/Tools/ServiceFabricLocalClusterManager;C:/Program Files/OpenSSL/bin;C:/Strawberry/c/bin;C:/Strawberry/perl/site/bin;C:/Strawberry/perl/bin;C:/Program Files/Git/cmd;C:/Program Files/Git/mingw64/bin;C:/Program Files/Git/usr/bin;c:/tools/php;C:/Program Files (x86)/sbt/bin;C:/Program Files/TortoiseSVN/bin;C:/SeleniumWebDrivers/ChromeDriver/;C:/SeleniumWebDrivers/EdgeDriver/;C:/Program Files/CMake/bin;C:/Program Files/Amazon/AWSCLIV2/;C:/Program Files/Amazon/SessionManagerPlugin/bin/;C:/Program Files/Amazon/AWSSAMCLI/bin/;C:/Program Files (x86)/Google/Cloud SDK/google-cloud-sdk/bin;C:/Program Files (x86)/Microsoft BizTalk Server/;C:/Users/runneradmin/AppData/Local/Microsoft/WindowsApps;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/Llvm/bin;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/CMake/bin;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/Ninja;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/Common7/IDE/VC/Linux/bin/ConnectionManagerExe;C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/Llvm/x64/bin;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/CMake/bin;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/Ninja;C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7/IDE/CommonExtensionsVC/MicrosoftLinux/CMake/CMake/bin;bin/ConnectionManagerExe WINDOWS_VS_VER=150 WINDOWS_VS_VC_TOOLS_INSTALL_DIR=C:/Program Files (x86)/Microsoft Visual Studio/20172019/Community/Common7VC/IDETools/CommonExtensions/Microsoft/CMake/NinjaMSVC/14.28.29910 WINDOWS_VS_VER=150_VC_TOOLS_REDIST_DIR=C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Redist/MSVC/14.28.29910 WINDOWS_SDK_DIR=C:/Program Files (x86)/Windows Kits/10 WINDOWS_SDK_VERSION=10.0.1776319041.0 |
Mac
You will need macOS 10.12 (Sierra) or later.
...