h1. GTA04 Build

This explains how to build Replicant for the GTA04.

h2. Prerequisites

Before building, you must make sure:
* You have installed the build dependencies: [[BuildDependenciesInstallation]]
* 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/@