Ethereum Serial (VIII): Installation and Customization of C++ Client (II)

Installing the client from source

Overview

The cpp-ethereum codebase is spread across several Git repositories, where the libraries are grouped as submodules under the webthree-umbrella repository.

We use the regular CMake build system to generate the platform specific architecture files, which means the workflow is very similar on whatever OS you're using:

1. Install compilation tools and external packages (these are platform independent)

2. Clone the source code from the webthree-umbrella git repository

3. Run CMake to generate compilation files (makefiles, Visual Studio solutions, etc.)

4. Compile

Operating system specific installation instructions

Note for Linux builds - It is also possible to make the client work on 32-bit Ubuntu by building from source and disabling VMJIT and other features. We may accept pull requests to add such support, but will not invest any time in dedicated development support for Ubuntu 32-bit architectures.

Linux has a slideshow of distro specific packaging system steps, which is the first thing we need to do before we start building from source. The following sections try to reflect those steps. If you are using a different distro and hit version, please let us know.

Clone the repository To clone the source code, execute the following command:

git clone —recursive https://github.com/ethereum/webthree-umbrella.git

Install dependencies (distro specific)

Install dependencies for Ubuntu

Ubuntu Trusty Tahr (14.04) steps:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
twenty one
twenty two

 sudo apt-add-repository ppa:george-edison55/cmake-3.x
sudo apt-get -y update
sudo apt-get -y install language-pack-en-base
sudo dpkg-reconfigure locales
sudo apt-get -y install software-properties-common
sudo add-apt-repository "deb http://llvm.org/apt/trusty/ llvm-toolchain-trusty-3.7 main"
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y update
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev
sudo apt-get -y update
sudo apt-get -y upgrade
sudo apt-get -y install build-essential git cmake libboost-all-dev libgmp-dev \
libleveldb-dev libminiupnpc-dev libreadline-dev libncurses5-dev \
libcurl4-openssl-dev libcryptopp-dev libmicrohttpd-dev libjsoncpp-dev \
libargtable2-dev libedit-dev mesa-common-dev ocl-icd-libopencl1 opencl-headers \
libgoogle-perftools-dev qtbase5-dev qt5-default qtdeclarative5-dev \
libqt5webkit5-dev libqt5webengine5-dev ocl-icd-dev libv8-dev libz-dev
sudo apt-get -y install libjson-rpc-cpp-dev
sudo apt-get -y install qml-module-qtquick-controls qml-module-qtwebengine

Ubuntu Utopic Unicorn (14.10) steps:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
twenty one
twenty two

 sudo apt-get -y update
sudo apt-get -y install language-pack-en-base
sudo dpkg-reconfigure locales
sudo apt-get -y install software-properties-common
sudo add-apt-repository "deb http://llvm.org/apt/utopic/ llvm-toolchain-utopic-3.7 main"
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y update
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev
sudo apt-get -y update
sudo apt-get -y upgrade
sudo apt-get -y install build-essential git cmake libboost-all-dev libgmp-dev \
libleveldb-dev libminiupnpc-dev libreadline-dev libncurses5-dev \
libcurl4-openssl-dev libcryptopp-dev libmicrohttpd-dev libjsoncpp-dev \
libargtable2-dev libedit-dev mesa-common-dev ocl-icd-libopencl1 opencl-headers \
libgoogle-perftools-dev qtbase5-dev qt5-default qtdeclarative5-dev \
libqt5webkit5-dev libqt5webengine5-dev ocl-icd-dev libv8-dev libz-dev
sudo apt-get -y install libjson-rpc-cpp-dev
sudo apt-get -y install qml-module-qtquick-controls qml-module-qtwebengine

Ubuntu Vivid Vervet (15.04) steps:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
twenty one

 sudo apt-get -y update
sudo apt-get -y install language-pack-en-base
sudo dpkg-reconfigure locales
sudo apt-get -y install software-properties-common
sudo add-apt-repository "deb http://llvm.org/apt/vivid/ llvm-toolchain-vivid-3.7 main"
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y update
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev
sudo apt-get -y update
sudo apt-get -y upgrade
sudo apt-get -y install build-essential git cmake libboost-all-dev libgmp-dev \
libleveldb-dev libminiupnpc-dev libreadline-dev libncurses5-dev \
libcurl4-openssl-dev libcryptopp-dev libmicrohttpd-dev libjsoncpp-dev \
libargtable2-dev libedit-dev mesa-common-dev ocl-icd-libopencl1 opencl-headers \
libgoogle-perftools-dev qtbase5-dev qt5-default qtdeclarative5-dev \
libqt5webkit5-dev libqt5webengine5-dev ocl-icd-dev libv8-dev libz-dev
sudo apt-get -y install libjson-rpc-cpp-dev
sudo apt-get -y install qml-module-qtquick-controls qml-module-qtwebengine

Ubuntu WilyWerewolf (15.10) Steps:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
twenty one

 sudo apt-get -y update
sudo apt-get -y install language-pack-en-base
sudo dpkg-reconfigure locales
sudo apt-get -y install software-properties-common
sudo add-apt-repository "deb http://llvm.org/apt/wily/ llvm-toolchain-wily-3.7 main"
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y update
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev
sudo apt-get -y update
sudo apt-get -y upgrade
sudo apt-get -y install build-essential git cmake libboost-all-dev libgmp-dev \
libleveldb-dev libminiupnpc-dev libreadline-dev libncurses5-dev \
libcurl4-openssl-dev libcryptopp-dev libmicrohttpd-dev libjsoncpp-dev \
libargtable2-dev libedit-dev mesa-common-dev ocl-icd-libopencl1 opencl-headers \
libgoogle-perftools-dev qtbase5-dev qt5-default qtdeclarative5-dev \
libqt5webkit5-dev libqt5webengine5-dev ocl-icd-dev libv8-dev libz-dev
sudo apt-get -y install libjsonrpccpp-dev
sudo apt-get -y install qml-module-qtquick-controls qml-module-qtwebengine

Ubuntu Xenial Xerus (16.04) Steps:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

 sudo apt-get -y update
sudo apt-get -y install language-pack-en-base
sudo dpkg-reconfigure locales
sudo apt-get -y install software-properties-common
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev
sudo apt-get -y update
sudo apt-get -y upgrade
sudo apt-get -y install build-essential git cmake libboost-all-dev libgmp-dev \
libleveldb-dev libminiupnpc-dev libreadline-dev libncurses5-dev \
libcurl4-openssl-dev libcryptopp-dev libmicrohttpd-dev libjsoncpp-dev \
libargtable2-dev libedit-dev mesa-common-dev ocl-icd-libopencl1 opencl-headers \
libgoogle-perftools-dev qtbase5-dev qt5-default qtdeclarative5-dev \
libqt5webkit5-dev libqt5webengine5-dev ocl-icd-dev libv8-dev libz-dev
sudo apt-get -y install libjsonrpccpp-dev
sudo apt-get -y install qml-module-qtquick-controls qml-module-qtwebengine \
qml-module-qtquick-privatewidgets qml-module-qtquick-dialogs \
qml-module-qt-labs-settings qml-module-qtgraphicaleffects

Installing dependencies for Fedora

Fedora 20 Steps:

 1
2
3
4
5

 yum install git automake autoconf libtool cmake gcc gcc-c++ xkeyboard-config \
leveldb-devel boost-devel gmp-devel cryptopp-devel miniupnpc-devel \
qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtquick1-devel qt5-qtwebkit-devel \
mesa-dri-drivers snappy-devel ncurses-devel readline-devel curl-devel \
python-devel

Fedora 21 Steps:

 1
2
3
4
5

 yum install git automake autoconf libtool cmake gcc gcc-c++ xkeyboard-config \
leveldb-devel boost-devel gmp-devel cryptopp-devel miniupnpc-devel \
qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtquick1-devel qt5-qtwebkit-devel \
mesa-dri-drivers snappy-devel ncurses-devel readline-devel curl-devel \
python-devel jsoncpp-devel argtable-devel

Building json-rpc from github as per https://github.com/ethereum/cpp-ethereum/issues/617:

 1
2
3
4
5
6
7
8

 git clone https://github.com/cinemast/libjson-rpc-cpp
cd libjson-rpc-cpp
git checkout tags/v0.3.2
mkdir -p build
cd build
cmake .. && make
sudo make install
sudo ldconfig

Fedora 22 Fedora 22 may have more dependencies than what is installed:

 1
2
3
4

 dnf install git automake autoconf libtool cmake gcc gcc-c++ xkeyboard-config \
leveldb-devel boost-devel gmp-devel cryptopp-devel miniupnpc-devel \
mesa-dri-drivers snappy-devel ncurses-devel readline-devel curl-devel \
python-devel jsoncpp-devel argtable-devel

Install gcc version 4.9! Fedora 22 came with a different compiler (CC v5.3). It couldn't compile webthreeumbrella, so I installed gcc version 4.9 from SRC!

Check that you have gcc4.9 available in /usr/local, I installed it in /home/app/gcc49, you can read instructions on google how to compile gcc! After that, before every cmake, you have to compile everything needed for webthree-umbrella with gcc4.9 like this:

 1
2

 export CXX=/home/app/gcc49/bin/g++
export CC=/home/app/gcc49/bin/gcc

With this, you compile with gcc4.9 instead of the one that came with the distribution F22. Uninstalling the compiler that came with your distribution is not recommended! You can also make it work with symbolic links.

Install from Fedora COPR REPO LLVM3.7 using:

 1
2

 dnf copr enable alonid/llvm-3.7
dnf install llvm-3.7 llvm-3.7-devel llvm-3.7-static llvm-3.7-libs

I had to do this because Fedora 22 comes with llvm-3.5 from the stock repository! There may be other solutions, but this one worked for me. Install CryptoPP from SRC https://github.com/weidai11/cryptoppCRYPTOPP_5_6_2:

 1
2
3
4
5
6
7
8
9
10

 git clone https://github.com/weidai11/cryptopp
cd cryptopp
git checkout release/CRYPTOPP_5_6_2
mkdir build
cd build
export CXX=/home/app/gcc49/bin/g++ <- be sure to compile with gcc4.9
export CC=/home/app/gcc49/bin/gcc <- be sure to compile with gcc4.9
cmake ..
make
make install

Install QT5 from COPR "dnf copr enable @kdesig/Qt5", newer QT5 version:

 1

 dnf install qt5-*

This should install QT5 version 5.6.0 from the COPR repo. I have not tested other user packages. Install qtwebengine from https://github.com/qtproject/qtwebengine. I installed version 5.6.0. Others may also work. Have a look :D

 1
2
3
4
5
6

 git clone https://github.com/qtproject/qtwebengine
cd qtwebengine
git checkout release/v5.6.0
qmake-qt5 <- in other distros its just called qmake in fedora 22 qmake-qt5
make
make install

Install json-rpc from github https://github.com/ethereum/cpp-ethereum/issues/617%EF%BC%9A

 1
2
3
4
5
6
7
8
9
10

 git clone https://github.com/cinemast/libjson-rpc-cpp
cd libjson-rpc-cpp
git checkout tags/v0.4.2
mkdir -p build
cd build
export CXX=/home/app/gcc49/bin/g++ <- be sure to compile with gcc4.9
export CC=/home/app/gcc49/bin/gcc <- be sure to compile with gcc4.9
cmake .. && make
sudo make install
sudo ldconfig

Make sure to check if jsonrpcstub works in the console, type "jsonrpcstub" and see if it gets an answer. If the answer is no arguments or slt, it worked, but if you don't get the file, you will have to symbolically link the missing parts into the libs dir /usr/local/lib64 or usr/local/lib, depending on where the file blabla is. Try to find it with "updatedb" and then "locate blabla.so"

Now try to compile, it should work, if not there is a missing symlink because there is no such embracing file or there are some missing packs, try to find them with dnf like "dnf search packname " or "dnf list packname ". All I have to say is this is not a 5 minute webthree-umbrella compile, enjoy Tflux99.

Installing dependencies for OpenSUSE

This is how to get the required dependencies for building the latest webthreeumbrella on OpenSUSE. It was done on Leap 42.1, but there should be equivalent packages available for Tumbleweed and 13.x. The first dependency is provided by the main repository:

 1
2
3
4
5
6
7

 zypper in git automake autoconf libtool cmake gcc gcc-c++ \
xkeyboard-config leveldb-devel boost-devel gmp-devel \
cryptopp-devel libminiupnpc-devel libqt5-qtbase-common-devel \
libqt5-qtdeclarative-devel libQTWebKit-devel libqt5-qtwebengine-devel \
libQt5Concurrent-devel Mesa ncurses-devel readline-devel libcurl-devel \
llvm llvm-clang llvm-clang-devel llvm-devel libLLVM binutils \
libmicrohttp-devel jsoncpp-devel opencl-headers-1.2 zlib-devel

It is possible to use the generic libOpenCL1, but I have only tested it with the AMD-specific package from the AMD driver repository fglrx64_opencl_SUSE421.

These packages are not in the standard repositories, but can be found using the OpenSUSE package search and YaST 1-Click installation:

1. libargtable2-devel

2. libv8-3

3. v8-devel

Installing Dependencies for OpenSUSE Compiling webthree-umbrella on Arch Linux requires dependencies from the official repository and the Arch User Repository (AUR). To install from the official repository, use pacman. To install packages from AUR, there are many AUR helpers available. In this guide, the AUR helper yaourt is used.

Install Dependencies

 1
2
3

 # from official repositories sudo pacman -Sy git base-devel cmake boost crypto++ leveldb llvm miniupnpc
libcl opencl-headers libmicrohttpd qt5-base qt5-webengine
# from AUR yaourt -Sy libjson-rpc-cpp

Compiling the Source Code In this step, you can specify the folder where Ethereum will be installed, although specifying a folder is optional. If not specified, the binary folder will be located in the created folder. However, for this guide, it is assumed that the Ethereum files will be installed in /opt/eth. The reason for using /opt is that it makes it easier to delete the Ethereum folder later than installing it in, say, /usr. Also, /opt is often used to install software that is not managed by the packaging system, such as manually compiled programs.

 1
2
3
4
5
6
7
8
9
10
11
12
13

 # enter webthree-umbrella folder after cloning its github repository
cd webthree-umbrella
# make a build folder and enter into it
mkdir -p build && cd build
# create build files and specify Ethereum installation folder
cmake .. -DCMAKE_INSTALL_PREFIX=/opt/eth
# compile the source code
make
# alternatively it is possible to specify number of compilation threads
# for example to use 4 threads execute make as follows:
# make -j 4
# install the resulting binaries, shared libraries and header files into /opt
sudo make install

After successful compilation and installation, the Ethereum binary can be found in /opt/eth/bin, shared libraries in /opt/eth/lib, and header files in /opt/eth/include.

Specifying the Ethereum library path Since Ethereum is installed in /opt/eth, executing its binary will result in a link error caused by not being able to find the Ethereum shared library. To correct this problem, you need to add the file containing the Ethereum shared library to the LD_LIBRARY_PATH environment variable:

 1
2
3
4

 # update ~/.bashrc
echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/eth/lib" >> ~/.bashrc
# reload ~/.bashrc
source ~/.bashrc

Install dependencies for Debian

Debian Jessie (8.5)

Warning: GUI applications have not been tried on Debian. So, to build without a GUI use: cmake .. -DGUI=0

step:

 1
2
3
4

 sudo apt-get -y install gcc
sudo apt-get -y install g++
sudo apt-get -y install unzip
sudo apt-get -y install cmake

Make sure you install cmake version 3.5.2. If apt-get installed an older version, you will need to compile it from source following the instructions at this link.

 1
2
3
4

 sudo apt-get -y install libboost-all-dev
sudo apt-get -y install libgmp-dev
sudo apt-get -y install libjsoncpp-dev
sudo apt-get -y install libleveldb-dev

To install cryptopp, it is necessary to create from:

 1
2
3
4
5
6
7
8

 mkdir ~/download
cd ~/download
wget https://www.cryptopp.com/cryptopp563.zip
mkdir cryptopp
mv cryptopp563.zip cryptopp
cd cryptopp
unzip -a cryptopp563.zip
make static dynamic cryptest.exe

Test the installation:

 1

 ./cryptest.exe v

Verify the result and run another test:

 1

 ./cryptest.exe tv

Verification successful? Continue:

 1
2

 make libcryptopp.a libcryptopp.so cryptest.exe
sudo make install PREFIX=/usr/local

CryptoPP installation complete!

 1

 sudo apt-get -y install libminiupnpc-dev

Now install LLVM build from source:

 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
twenty one
twenty two

 sudo apt-get -y install build-essential
mkdir ~/download/llvm
cd ~/download/llvm
wget -c http://llvm.org/releases/3.8.0/llvm-3.8.0.src.tar.xz
wget -c http://llvm.org/releases/3.8.0/cfe-3.8.0.src.tar.xz
wget -c http://llvm.org/releases/3.8.0/compiler-rt-3.8.0.src.tar.xz
tar -xf llvm-3.8.0.src.tar.xz
tar -xf cfe-3.8.0.src.tar.xz
tar -xf compiler-rt-3.8.0.src.tar.xz

mv llvm-3.8.0.src llvm-3.8.0
mv cfe-3.8.0.src cfe
mv compiler-rt-3.8.0.src compiler-rt
mv cfe llvm-3.8.0/tools
mv compiler-rt llvm-3.8.0/projects/
mkdir build

cd build
cmake ../llvm-3.8.0
make
sudo make install
sudo ldconfig

Back to apt-get:

 1
2

 sudo apt-get -y install opencl-dev
sudo apt-get -y install libcurl4-openssl-dev

Install json-rpc-cpp from source:

 1
2
3
4
5
6
7
8
9
10

 sudo apt-get source libmicrohttpd-dev
sudo apt-get -y install libargtable2-dev
sudo apt-get -y install libmicrohttpd-dev
git clone git://github.com/cinemast/libjson-rpc-cpp.git
mkdir -p libjson-rpc-cpp/build
cd libjson-rpc-cpp/build
cmake
make
sudo make install
sudo ldconfig

Building from the command line is only possible after you have installed the dependencies (the rest of the files!)

 1
2
3
4
5

 mkdir build Make a directory for the build output
cd build Switch into that directory
cmake .. To generate a makefile.
make To build that makefile on the command-line
make -j <number> (or) Execute makefile with multiple cores

Building for Windows

We only support 64-bit architecture and only work with the following Windows versions:

1. Windows 7

2. Windows 8/8.1

3. Windows 10

4. Windows Server 2012 R2

It is also possible to make the client work on 32-bit Windows by building from source and disabling VMJIT and other features. We may accept pull requests to add such support, but will not invest any time in dedicated development support for Windows 32-bit architectures.

First of all you need to install the following dependencies

Software Notes Git for Windows Command-line tool for retrieving sources from Github CMake cross-platform build file generator Visual Studio 2015 C++ compiler and dev environment

Get the source Clone the git repository containing all the source code by executing the following command:

 1

 git clone --recursive https://github.com/ethereum/webthree-umbrella.git

Get external dependencies Execute the CMake script to download and open the pre-built external binaries required to build the project:

 1

 cmake -P webthree-helpers/deps/install_deps.cmake

The generic Visual Studio project file then executes the following command, which will use CMake to generate the Visual Studio solution file:

 1
2
3

 mkdir build
cd build
cmake -G "Visual Studio 14 2015 Win64" ..

This will result in the creation of cpp-ethereum.sln in the build directory.

Double clicking the file will launch Visual Studio. We recommend setting up the RelWithDebugInfo configuration, but all others will work.

Alternatively, you can build this project from the command line like this:

 1

 cmake --build . --config RelWithDebInfo

Building for OS X

Overview - Here comes the dragon! There is no way to avoid OS X build breakages because Homebrew is a "rolling release" package manager, which means the plane will keep moving underneath us unless we add all external dependencies to the Homebrew tap, or add them as git submodules to the umbrella project. The results of Enduser vary depending on how long you build your project. A build might have worked yesterday, but there is no guarantee that your friend will have the same results on their machine today. Needless to say, this is not a happy situation.

If you run into OS X build hiccups, please browse the Github issues to see if your problem has already been reported. If so, please comment on an existing issue. If you don't see any similar issues, please create a new issue describing your OS X version, cpp-ethereum version, hardware, and any other details you think are relevant.

Please add verbose log files via gist.github.com or similar service.

The cpp-ethereum-development gitter channel is where we hang out and work together to solve problems.

We only support the two latest OS X versions:

1. OS X Yosemite (10.10)

2. OS X El Capitan (10.11)

The cpp-ethereum codebase does not build on older versions of OS X, and we do not support that. If you are using an older version of OS X, we recommend that you update to the latest version, not only for building cpp-ethereum, but also for your own security.

First things first and external dependencies make sure you have the latest version of Xcode installed. This includes the Clang C++ compiler, Xcode IDE and other Apple development tools necessary to build C++ applications on OS X. If you are installing Xcode for the first time, or have just installed a new version, you will need to accept the license before doing a command line build:

 1

 sudo xcodebuild -license accept

If you want to build GUI applications (AlethZero and Mix), you need to install the XQuartz X11Window System, because Qt on OS X uses that X11 layer.

Our OS X builds require you to install the Homebrew package manager in order to install external dependencies.

If you want to start from scratch, here's how to uninstall Homebre.

Use Homebre to install all necessary external dependencies

 1
2
3
4

 brew update
brew upgrade
brew install boost cmake cryptopp miniupnpc leveldb gmp jsoncpp libjson-rpc-cpp libmicrohttpd
brew install homebrew/versions/llvm38

Here is how to create a graphical user interface application:

 1

 brew install qt5 --with-d-bus

NOTE1: The Qt5 step takes many hours on most people's machines. This is because it uses non-default settings that cause it to build from source. It seems to use about 20G of temporary disk space. Be careful! NOTE2: Qt and Qt5 packages cannot coexist in Homebrew. If you already have Qt installed, you will need to uninstall it before you can successfully build cpp-ethereum:

 1

 brew uninstall --force qt

Clone the repository To clone the source code, execute the following command:

 1

 git clone --recursive https://github.com/ethereum/webthree-umbrella.git

You can generate a Makefile and build on the command line, or generate an X-Code project and build in the IDE.

Command line build from project root:

 1
2
3
4

 mkdir build
cd build
cmake ..
make -j4 (or different value, depending on your number of CPU cores)

Installing your own builds You can also use the same Makefile to install your own builds globally on your machine:

 1

 make install

Generate Xcode project from project root:

 1
2
3

 mkdir build_xc
cd build_xc
cmake -G Xcode ..

This will generate an Xcode project file called cpp-ethereum.xcodeproj that you can open with X-Code and build/debug/run.

Building Notes for FreeBSD - Once the package is in the FreeBSD main ports, this guide should become much easier.

Manually Installing Ports For some steps, you must require root permissions to fix the ports directory.

webthree-umbrella depends on libjson-rpc-cpp.shar which is also not in the ports system.

First you need to download the shar file and put it in the ports directory under the "devel" session, usually /usr/ports/devel

 1

 curl https://raw.githubusercontent.com/enriquefynn/webthree-umbrella-port/master/libjson-rpc-cpp.shar

Now we execute the script with:

 1
2

 cd /usr/ports/devel
sh libjson-rpc-cpp.shar

This will create the libjson-rpc-cpp port. Now you should do the same for the webthree-umbrella port, we should get the webthree-umbrella files and create the port in the "net-p2p" directory.

 1
2

 curl https://raw.githubusercontent.com/enriquefynn/webthree-umbrella-port/master/webthree-umbrella.cd /usr/ports/net-p2p
sh webthree-umbrella.shar

Create and Install Now you can navigate to the webthree-umbrella directory and install the port:

 1
2

 cd /usr/ports/net-p2p/webthree-umbrella
make install clean

Building for Android

We don't have a working Android build right now, although it's on the roadmap at doublethinkco. Android uses the Linux kernel, but cross-building with ARM Linux has a different API, meaning that specific binaries are needed.

ARM Linux distributions use the GLIBC execution library, and Android uses bionic.

Building for iOS

We don't have a working iOS build right now, although it's on the roadmap at doublethinkco. iOS is a UNIX-like operating system based on Darwin (BSD) that uses ARM chips. This is cross-built with ARM Linux with a different API, meaning specific binaries are needed.

Built for Raspberry Pi Model A, B+, Zero, 2 and 3

EthEmbedded maintains build scripts for all Raspberry Mi modules. They are on Github in the Raspi-Eth-Install repository. Cross-building for these platforms is also possible.

Build for Odroid XU3/XU4

EthEmbedded maintains build scripts for the Odroid module. Support for more Odroid devices is possible in the future. They are on Github in the OdroidXU3-Eth-Install repository. Cross-building for these platforms is also possible.

Building for BeagleBone Black

EthEmbedded maintains build scripts for BBB on Github in the BBB-Eth-Install repository. It is also possible to cross-build for this platform.

Built for WandBoard

EthEmbedded maintains build scripts for WandBoard on Github in the WandBoard-Eth-Install repository. It is also possible to cross-build for this platform.

Building for Linux for ARM (cross builds)

Doublethinkco maintains a Docker-based cross build infrastructure hosted on Github in the cpp-ethereum-cross repository.

At the time of writing, these cross-build binaries have been used successfully on the following devices:

1. Jolla Phone (Sailfish OS)

2. Nexus 5 (Sailfish OS)

3. Meizu MX4 Ubuntu Edition (Ubuntu Phone)

4. Raspberry Pi Model B+, Rpi2 (Raspbian)

5. Odroid XU3 (Ubuntu MATE)

6. BeagleBone Black (Debian)

7. Wandboard Quad (Debian)

8. CHIP (Debian)

To-dos include:

1. Tizen

2. Android

3. iOS

In the next article we will introduce "Ethereum Serial (IX): Installation and Customization of Ethereum C++ Client (III)"

Thanks to Azure and Bob from the Chaoxi team for participating in the translation and proofreading of "Ethereum Homestead Documentation".