Skip to content

Latest commit

 

History

History
48 lines (34 loc) · 2.89 KB

prerequisites-for-building.md

File metadata and controls

48 lines (34 loc) · 2.89 KB
Raw

The following pre-requisites need to be installed for building the repo:

Windows (Windows 7+)

  1. Install Visual Studio 2017, including Visual C++ support.
  2. Install CMake 3.8.0 or later. Make sure you add it to the PATH in the setup wizard.
  3. (Windows 7 only) Install PowerShell 3.0. It's part of Windows Management Framework 3.0. Windows 8 or later comes with the right version inbox.

PowerShell also needs to be available from the PATH environment variable (it's the default). Typically it should be %SYSTEMROOT%\System32\WindowsPowerShell\v1.0.

Ubuntu (14.04)

Install basic dependency packages:

First add a new package source to be able to install clang-3.9:

echo "deb http://llvm.org/apt/trusty/ llvm-toolchain-trusty-3.9 main" | sudo tee /etc/apt/sources.list.d/llvm.list
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install cmake clang-3.9 libicu52 libunwind8 uuid-dev

Mac OSX (10.11.5+)

  1. Install Command Line Tools for XCode 8 or higher.
  2. Install CMake. Launch /Applications/CMake.app/Contents/MacOS/CMake GUI. Goto "OSX App Menu -> Tools -> Install For Command Line Use" and follow the steps. CMake < 3.6 has a bug that can make --install fail. Do sudo mkdir /usr/local/bin to work around.
  3. Install OpenSSL. Build tools have a dependency on OpenSSL. You can use Homebrew to install it: with Homebrew installed, run brew install openssl followed by ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/, followed by ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/.
  4. Install ICU (International Components for Unicode). It can be obtained via Homebrew: run brew install icu4c followed by brew link --force icu4c

Bash on Ubuntu on Windows (Windows 10 Creators Update or later)

Make sure you run with Ubuntu 16.04 Xenial userland (this is the default after Windows 10 Creators Update, but if you enabled the "Bash on Ubuntu on Windows" feature before the Creators Update, you need to upgrade manually). Running lsb_release -a will give you the version.

Install basic dependency packages:

First add a new package source to be able to install clang-3.9:

echo "deb http://llvm.org/apt/xenial/ llvm-toolchain-xenial-3.9 main" | sudo tee /etc/apt/sources.list.d/llvm.list
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install cmake clang-3.9 libunwind8 uuid-dev