h1. Build dependencies installation

*Replicant can only be built on 64 bit x86 architectures, building on 32 bit x86 systems is no longer supported.*
However, some prebuilt tools are still 32 bit x86 executables and some host tools are generated as 32 bit x86 executables.

It is recommended to have at least 4GB of RAM available.

h2. Replicant 6.0

h3. Debian-based systems

*Debian 9*

Packages installation:

<pre>
dpkg --add-architecture i386 ; apt-get update
apt-get build-dep gcc binutils llvm-defaults
apt-get install gcc-arm-none-eabi cmake python-dev swig ant bc proguard maven-debian-helper libemma-java libasm4-java libguava-java libnb-platform18-java libnb-org-openide-util-java libandroidsdk-ddmlib-java libmaven-source-plugin-java libfreemarker-java libmaven-javadoc-plugin-java ca-cacert curl gawk libgmp3-dev libmpfr-dev libmpc-dev git-core gperf libncurses-dev squashfs-tools pngcrush zip zlib1g-dev lzma libc6-dev-i386 g++-multilib lib32z1-dev lib32readline-dev lib32ncurses5-dev zlib1g-dev:i386 xsltproc python-mako schedtool gradle dirmngr libandroidsdk-sdklib-java eclipse-jdt libgradle-android-plugin-java android-sdk-build-tools android-sdk-platform-23 aapt lzop rsync
</pre>

The @repo@ tool for downloading the Replicant source code "is available in the contrib repository":https://packages.debian.org/stretch/repo (see "bug #855846":https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=%23855846 for the reasons why it was moved to contrib).

h3. Tips to make it build:

* #1847
* #1848

h2. Replicant 4.2

h3. Debian-based systems

*Trisquel 7.0*

Packages installation:

<pre>
dpkg --add-architecture i386 ; apt-get update
apt-get install git gnupg flex bison gperf build-essential zip curl openjdk-7-jre openjdk-7-jdk libc6-dev libncurses5-dev:i386 x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils libxml2-dev xsltproc zlib1g-dev:i386 repo
</pre>

*Debian 8*

Packages installation:

<pre>
dpkg --add-architecture i386 ; apt-get update
apt-get install  bison flex git-core gperf libncurses-dev build-essential curl squashfs-tools openjdk-7-jre openjdk-7-jdk pngcrush wget zip zlib1g-dev lzma libxml2-utils libxml2-dev libc6-dev-i386 g++-multilib lib32z1-dev lib32readline-gplv2-dev lib32ncurses5-dev zlib1g-dev:i386 xsltproc
</pre>

h3. Tweaks

h4. libxml2.so

If you have the following error:
<pre>
$ ./vendor/replicant/build-toolchain
[...]
-- Clang version: 3.7.0
-- Configuring done
-- Generating done
-- Build files have been written to: /home/replicant/replicant-6.0/toolchain/clang
+ nproc
+ echo 1
+ make -j 1
[...]
[ 98%] Built target libclang
make[2]: *** No rule to make target '/usr/lib64/libxml2.so', needed by 'bin/c-index-test'.  Stop.
CMakeFiles/Makefile2:13807: recipe for target 'tools/clang/tools/c-index-test/CMakeFiles/c-index-test.dir/all' failed
make[1]: *** [tools/clang/tools/c-index-test/CMakeFiles/c-index-test.dir/all] Error 2
Makefile:149: recipe for target 'all' failed
make: *** [all] Error 2
</pre>
make sure that you have libxml2-dev installed

h4. missing lib32readline5-dev

If the packages manager complains about @lib32readline5-dev@ being missing, it has to be replaced with @lib32readline-gplv2-dev@ in the command line.

h4. missing /usr/lib/zconf.h header

If the @/usr/lib/zconf.h@ header is missing, a symlink has to be created:
<pre>
ln -s /usr/include/x86_64-linux-gnu/zconf.h /usr/lib/zconf.h
</pre>
* If errors messages about incompatible library versions are shown, some symlinks have to be created. For instance:
<pre>
sudo ln -s /usr/lib32/libstdc++.so.6.0.14 /usr/lib32/libstdc++.so
sudo ln -s /usr/lib32/libz.so.1.2.3.4 /usr/lib32/libz.so
</pre>

h3. Arch Linux-based systems

*Parabola*

Base packages (from the Parabola repositories) installation:
<pre>
pacman -S --needed core/bison core/flex core/make core/ncurses core/xz core/zlib extra/bc extra/git extra/gperf extra/gperftools libre/jdk7-openjdk extra/openjdk7-src libre/jre7-openjdk extra/wget extra/zip community/squashfs-tools community/pngcrush libre/unzip community/repo
</pre>

Some additional repositories are required to retrieve some of the build dependencies.

To enable those repositories, the following should be added to @/etc/pacman.conf@:
<pre>
[libre-multilib]
Include = /etc/pacman.d/mirrorlist

[multilib]
Include = /etc/pacman.d/mirrorlist
</pre>

For these changes to take effect, the packages database should be updated:
<pre>
pacman -Syu
</pre>

Additional packages installation:
<pre>
pacman -S --needed multilib/lib32-glibc multilib/gcc-multilib multilib/lib32-readline multilib/lib32-ncurses multilib/lib32-zlib
</pre>

*Tweaks*

* repo may complain about experimental python 3 support: python 2 has to be set as default instead:
<pre>
ln -s /usr/bin/python2 /usr/local/bin/python
</pre>