Replicant

h1. GTA04 Build

This explains how to build Replicant for the GTA04.

h2. Prerequisites

Before building, you must make sure:

* You have installed the [[BuildDependencies]]

* You have downloaded Replicant 2.3 or 4.0 sources: [[ReplicantSources]]

* Your sources are up to date: [[ReplicantSources#DownloadingUpdating-the-source-from-the-repos|Downloading/Updating the source from the repos]]

* You are in the directory where the sources were downloaded

h2. Warning

*Do not build as root, always build as user.*

h2. Building Replicant 4.0

Setup the build environment: 

<pre>

source build/envsetup.sh

lunch replicant_gta04-eng

export ANDROID_JAVA_HOME=$JAVA_HOME

</pre>

Start the build:

<pre>

parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)

make -j$parallel_tasks bootimage

make -j$parallel_tasks bootloaderimage

make -j$parallel_tasks systemtarball

</pre>

h2. Building Replicant 2.3

Setup the build environment: 

<pre>

source build/envsetup.sh

lunch replicant_gta04-eng

export ANDROID_JAVA_HOME=$JAVA_HOME

</pre>

Start the build:

h3. Building for µSD card storage

<pre>

parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)

make -j$parallel_tasks bootimage BOARD_SDCARD_INIT:=true

make -j$parallel_tasks bootloaderimage

make -j$parallel_tasks systemtarball

</pre>

h3. Building for NAND storage

<pre>

parallel_tasks=$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc)

make -j$parallel_tasks bootimage

make -j$parallel_tasks bootloaderimage

make -j$parallel_tasks systemimage

make -j$parallel_tasks userdataimage

</pre>

The -jn argument is to indicate the number of parallel tasks during the build. 

You can remove it from the command line to have only one task at a time. With fast hardware, best results will come with @-j9@, @-j16@ and @-j32@.

h2. Output files

Find the produced files:

* built target images: @out/target/product/gta04/@

* built host tools: @out/host/linux-x86/bin/@