Replicant

h1. Build Replicant 6.0

This page explains how to build Replicant 6.0 for supported devices.

h2. Prerequisites

Before building, you must make sure that:

* You have installed the build dependencies: [[Replicant60BuildDependenciesInstallation|Replicant 6.0 build dependencies installation]]

* You have downloaded Replicant 6.0 sources: [[ReplicantSourceCode]]

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

* Your terminal is running in the directory where the sources were downloaded

h2. Warning

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

See the [[BuildTips|build tips]] if you are facing issues.

h2. Before building

* On Debian stretch, building the toolchain will fail. See [[Replicant60BuildTips#usrbinsed-usrbinmkdir-usrbinmkdir-No-such-file-or-directory]] for how to workaround that and make the build succeed.

h2. Building

All of the following build commands need to be run in the source tree root folder.

h3. Building the toolchain

First, the toolchain needs to be built for replicant 6. To do that *open a new shell* and run the following command:

<pre>

./vendor/replicant/build-toolchain

</pre>

h2. Building a Replicant image for a device

Once the toolchain has been built, you can then start building an image for a specific device.

Use the command corresponding to your device in this table to do that:

|_. Device(s) |_. Command |

| Galaxy S 2 (I9100) | ./vendor/replicant/build.sh i9100 |

| Galaxy S 3 (I9300) | ./vendor/replicant/build.sh i9300 |

| Galaxy S 3 4G (I9305) | ./vendor/replicant/build.sh i9305 |

| Galaxy Note (N7000) | ./vendor/replicant/build.sh n7000 |

| Galaxy Note 2 (N7100) | ./vendor/replicant/build.sh n7100 |

| Galaxy Nexus (I9250) | ./vendor/replicant/build.sh maguro |

| Galaxy Tab 2 7.0 (P3100) |/2. ./vendor/replicant/build.sh espresso3g |

| Galaxy Tab 2 10.1 (P5100) |

| Galaxy Tab 2 7.0 Wi-Fi (P3110) |/2. ./vendor/replicant/build.sh espressowifi |

| Galaxy Tab 2 10.1 Wi-Fi (P5110) |

| Galaxy Note 8.0 (N5100) | ./vendor/replicant/build.sh n5100 |

| Galaxy Note 8.0 Wi-Fi (N5110) | ./vendor/replicant/build.sh n5110 |

For instance to build for the Galaxy S3 (I9300) you need to type the following command:

<pre>

./vendor/replicant/build.sh i9300

</pre>

The first time you build an image it might ask you a few questions at various points during the build process as it needs then to build the images and generate the necessary signing keys near the end of the building process.

h2. Output files

For the built host tools, the produced files are at: @out/host/linux-x86/bin/@

For the built target images, you can use the following table to find the directory that has the produced files:

|_. Output directory |_. Device(s) |

| out/dist/i9100/ |  Galaxy S 2 (I9100) |

| out/dist/i9300/ | Galaxy S 3 (I9300) |

| out/dist/i9305/ | Galaxy S 3 4G (I9305) |

| out/dist/n7000/ | Galaxy Note (N7000) |

| out/dist/n7100/ | Galaxy Note 2 (N7100) |

| out/dist/maguro/ | Galaxy Nexus (I9250) |

|/2. out/dist/espresso3g/ | Galaxy Tab 2 7.0 (P3100) | 

| Galaxy Tab 2 10.1 (P5100) |

|/2. out/dist/espressowifi/ | Galaxy Tab 2 7.0 Wi-Fi (P3110) | 

| Galaxy Tab 2 10.1 Wi-Fi (P5110) |

| out/dist/n5100/ | Galaxy Note 8.0 (N5100) |

| out/dist/n5110/ | Galaxy Note 8.0 Wi-Fi (N5110) |

For instance, for the Galaxy S 3 (I9300), the built target images are in @out/dist/i9300/@