Use this guide to create your first High Fidelity build for Windows 64-bit.
This guide will help you create your first High Fidelity build if you’re using a system with Windows 64 bit.
To successfully build High Fidelity, check out the system requirements.
We are now using Visual Studio 2017 and Qt 5.9.1. If you are upgrading from Visual Studio 2013 and Qt 5.6.2, do a clean uninstall of those versions before going through this guide.
The prerequisites will require about 10 GB of space on your drive.
To create your High Fidelity build you’ll need to download and install:
1. Visual Studio 2017
If you don’t have Community or Professional edition of Visual Studio 2017, download Visual Studio Community 2017.
When selecting components, check "Desktop development with C++." Also check "Windows 8.1 SDK and UCRT SDK" and "VC++ 2015.3 v140 toolset (x86,x64)" on the Summary toolbar on the right. In the end, your screen should look like this:
Download and install the latest version of CMake 3.9. Download the file named win64-x64 Installer from the CMake Website. Make sure to check "Add CMake to system PATH for all users" when prompted during installation.
Download and install the Qt Online Installer. While installing, deselect components so that your window looks like this:
Note: Installing the Sources is optional but recommended if you have room for them (~2GB).
The next thing you need to do is set the Qt environment variables. Go to "Control Panel > System > Advanced System Settings > Environment Variables > New..." (or search “Environment Variables” in Start Search). Then, setup your Qt variables.
Download and unzip the VCPKG repository into
Follow the instructions in the readme to bootstrap vcpkg using a Developer Command Prompt.
Set an environment variable VCPKG_ROOT to the location of the cloned repository. Go to "Control Panel > System > Advanced System Settings > Environment Variables > New..." (or search “Environment Variables” in Start Search). Then, setup your vcpkg variables:
Close and re-open any command prompts after setting the environment variable so that they will pick up the change.
Using a Developer Command Prompt, run the following command in your %VCPKG% directory:
vcpkg install openssl:x64-windows
Run Command Prompt from Start and run the following commands:
cd "%HIFI_DIR%" mkdir build cd build cmake .. -G "Visual Studio 15 Win64"
%HIFI_DIR% is the directory for the highfidelity repository.
Follow these steps to make your build:
%HIFI_DIR%\build\hifi.slnusing Visual Studio.
Create another environment variable (Just like how you created the Qt-variable).
In Visual Studio, go to the Apps folder in the Solution Explorer. Right-click interface and select Set as Startup Project. Then, you can navigate to Run Debug > Start Debugging.
Now, you should have a full build of High Fidelity and be able to run the Interface using Visual Studio. Please check our documentation for more information regarding the programming workflow.
You can also run Interface by launching it from command line or File Explorer from
If you face any problems once you start trying to generate build files using CMake, there are couple of things you could try to solve any issues.