INSTALL.md

Follow the build guide to figure out how to build High Fidelity for your platform.

During generation, CMake should produce an install target and a package target.

Install

The install target will copy the High Fidelity targets and their dependencies to your CMAKE_INSTALL_PREFIX.
This variable is set by the project(hifi) command in CMakeLists.txt to C:/Program Files/hifi and stored in build/CMakeCache.txt

Packaging

To produce an installer, run the package target.

Windows

To produce an executable installer on Windows, the following are required:

1. 7-zip

2. Nullsoft Scriptable Install System - 3.04
   Install using defaults (will install to C:\Program Files (x86)\NSIS)

3. UAC Plug-in for Nullsoft - 0.2.4c

   1. Extract Zip
   2. Copy UAC.nsh to C:\Program Files (x86)\NSIS\Include\
   3. Copy Plugins\x86-ansi\UAC.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   4. Copy Plugins\x86-unicode\UAC.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

4. nsProcess Plug-in for Nullsoft - 1.6 (use the link marked nsProcess_1_6.7z)

   1. Extract Zip
   2. Copy Include\nsProcess.nsh to C:\Program Files (x86)\NSIS\Include\
   3. Copy Plugins\nsProcess.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   4. Copy Plugins\nsProcessW.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

5. InetC Plug-in for Nullsoft - 1.0

   1. Extract Zip
   2. Copy Plugin\x86-ansi\InetC.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   3. Copy Plugin\x86-unicode\InetC.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

6. NSISpcre Plug-in for Nullsoft - 1.0

   1. Extract Zip
   2. Copy NSISpre.nsh to C:\Program Files (x86)\NSIS\Include\
   3. Copy NSISpre.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\

7. nsisSlideshow Plug-in for Nullsoft - 1.7

   1. Extract Zip
   2. Copy bin\nsisSlideshow.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   3. Copy bin\nsisSlideshowW.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

8. Nsisunz plug-in for Nullsoft

   1. Download both Zips and unzip
   2. Copy nsisunz\Release\nsisunz.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   3. Copy NSISunzU\Plugin unicode\nsisunz.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

9. ApplicationID plug-in for Nullsoft - 1.0

   1. Download Pre-built DLLs
   2. Extract Zip
   3. Copy Release\ApplicationID.dll to C:\Program Files (x86)\NSIS\Plugins\x86-ansi\
   4. Copy ReleaseUnicode\ApplicationID.dll to C:\Program Files (x86)\NSIS\Plugins\x86-unicode\

10. npm

    1. Install version 10.15.0 LTS

11. Perform a clean cmake from a new terminal.

12. Open the hifi.sln Solution and select the Release configuration.

13. Build the Solution.

14. Build packaged-server-console (found under Server Console)
    This will add 2 folders to build\server-console\ -
    server-console-win32-x64 and x64

15. Build CMakeTargets->PACKAGE
    Installer is now available in build\_CPack_Packages\win64\NSIS

OS X

1. npm Install version 10.15.0 LTS

2. Perform a clean cmake.

3. Perform a Release build of ALL_BUILD

4. Perform a Release build of packaged-server-console This will add a folder to build\server-console\ -
   Sandbox-darwin-x64

5. Perform a Release build of package Installer is now available in `build/_CPack_Packages/Darwin/DragNDrop