overte/BUILD_WIN.md
anshuman64 e6446b6913 New simplified, stand-alone build guide for Windows
Still throws this error after trying to build in Visual Studio: 

Error    9    error MSB3073: The command "setlocal
"C:\Program Files\CMake\bin\cmake.exe" "-DBUNDLE_EXECUTABLE=C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/render-perf-test.exe" "-DBUNDLE_PLUGIN_DIR=C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/plugins" -P "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/FixupBundlePostBuild.cmake"
if %errorlevel% neq 0 goto :cmEnd
:cmEnd
endlocal & call :cmErrorLevel %errorlevel% & goto :cmDone
:cmErrorLevel
exit /b %1
:cmDone
if %errorlevel% neq 0 goto :VCEnd
setlocal
CMD /C "SET PATH=%PATH%;C:/Qt/Qt5.6.1/5.6/msvc2013_64/bin && C:/Qt/Qt5.6.1/5.6/msvc2013_64/bin/windeployqt.exe  --release C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/render-perf-test.exe"
if %errorlevel% neq 0 goto :cmEnd
:cmEnd
endlocal & call :cmErrorLevel %errorlevel% & goto :cmDone
:cmErrorLevel
exit /b %1
:cmDone
if %errorlevel% neq 0 goto :VCEnd
setlocal
if exist "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio/qtaudio_windows.dll" ( "C:/Program Files/CMake/bin/cmake.exe" -E remove "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio/qtaudio_windows.dll" && "C:/Program Files/CMake/bin/cmake.exe" -E copy "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/ext/vc12/wasapi/project/src/wasapi/qtaudio_wasapi.dll" "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio" && "C:/Program Files/CMake/bin/cmake.exe" -E copy "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/ext/vc12/wasapi/project/src/wasapi/qtaudio_wasapi.pdb" "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio" )
if %errorlevel% neq 0 goto :cmEnd
if exist "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio/qtaudio_windowsd.dll" ( "C:/Program Files/CMake/bin/cmake.exe" -E remove "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio/qtaudio_windowsd.dll" && "C:/Program Files/CMake/bin/cmake.exe" -E copy "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/ext/vc12/wasapi/project/src/wasapi/qtaudio_wasapid.dll" "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio" && "C:/Program Files/CMake/bin/cmake.exe" -E copy "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/ext/vc12/wasapi/project/src/wasapi/qtaudio_wasapid.pdb" "C:/Users/Chris i5 AMD/Documents/GitHub/hifi/build/tests/render-perf/Release/audio" )
if %errorlevel% neq 0 goto :cmEnd
:cmEnd
endlocal & call :cmErrorLevel %errorlevel% & goto :cmDone
:cmErrorLevel
exit /b %1
:cmDone
if %errorlevel% neq 0 goto :VCEnd
:VCEnd" exited with code 1.    C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\Microsoft.CppCommon.targets    132    5    render-perf-test
2017-03-18 19:59:23 -07:00

3.3 KiB

This is a stand-alone guide for creating your first High Fidelity build for Windows 64-bit.

###Step 1. Installing Visual Studio 2013

If you don't already have the Community or Professional edition of Visual Studio 2013, download and install Visual Studio Community 2013. You do not need to install any of the optional components when going through the installer.

Note: Newer versions of Visual Studio are not yet compatible.

###Step 2. Installing CMake

Download and install the "win64-x64 Installer" from the CMake Website. Make sure "Add CMake to system PATH for all users" is checked when going through the installer.

###Step 3. Installing Qt

Download and install the Qt 5.6.1 Installer

Make sure to select all components when going through the installer.

###Step 4. Setting Qt Environment Variable

Go to "Control Panel > System > Advanced System Settings > Environment Variables > New..."

  • Set "Variable name": QT_CMAKE_PREFIX_PATH
  • Set "Variable value": C:\Qt\Qt5.6.1\5.6\msvc2013_64\lib\cmake

###Step 5. Installing OpenSSL

Download and install the "Win64 OpenSSL v1.0.xk" Installer from this website, where "x" is the number of the latest release (ex. Win64 OpenSSL v1.0.2k).

###Step 6. Running CMake to Generate Build Files

Run Command Prompt from Start and run the following commands: cd "%HIFI_DIR%" mkdir build cd build cmake .. -G "Visual Studio 12 Win64"

Where %HIFI_DIR% is the directory for the highfidelity repository.

###Step 7. Making a Build

Open '%HIFI_DIR%\build\hifi.sln' using Visual Studio.

Change the Solution Configuration (next to the green play button) from "Debug" to "Release" for best performance.

Run Build > Build Solution.

###Step 8. Testing the Interface

Create another environment variable (see Step #4)

  • Set "Variable name": _NO_DEBUG_HEAP
  • Set "Variable value": 1

In Visual Studio, right+click "interface" under the Apps folder in Solution Explorer and select "Set as Startup Project". 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 Docs for more information regarding the programming workflow.

Note: You can also run Interface by launching it from command line or File Explorer from %HIFI_DIR%\build\interface\Debug\interface.exe

###Troubleshooting

For any problems after Step #6, first try this:

  • Delete the highfidelity repository
  • Restart your computer
  • Redownload the repository
  • Restart directions from Step #6

####CMake gives you the same error message repeatedly after the build fails

Remove CMakeCache.txt found in the '%HIFI_DIR%\build' directory

####nmake cannot be found

Make sure nmake.exe is located at the following path: C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin

If not, add the directory where nmake is located to the PATH environment variable.

####Qt is throwing an error

Make sure you have the current version (5.6.1-1) installed and 'QT_CMAKE_PREFIX_PATH' environment variable is set correctly.