Replicant

h1. Replicant source code

h2. Browsing the source code

The Replicant source code is currently hosted by the "FSF":https://www.fsf.org/ at: https://git.replicant.us/

There is one branch per Replicant version, such as @replicant-2.2@.

h2. Disk space

Before downloading the Replicant source code, make sure there is a considerable amount of disk space left on the drive you intent to build Replicant on.

It is advised to have 40-50GiB available for the Replicant source code and the produced files.

h2. Source tree root folder

The path to the source tree root folder *must not contain spaces*.

h2. Installing the tools

Then, download the @repo@ tool and set it executable:

<pre>

mkdir tools

cd tools

wget http://commondatastorage.googleapis.com/git-repo-downloads/repo

chmod a+x repo

cd ../

</pre>

h2. Initializing the repository

The source manifest is the list of all the git repositories that are present in the Replicant tree.

Each Replicant version has a dedicated branch with the proper source manifest.

In case errors such as *server certificate verification failed* happen, installing the CACert certificate may help:

<pre>

mkdir /usr/local/share/ca-certificates/cacert.org

wget -P /usr/local/share/ca-certificates/cacert.org http://www.cacert.org/certs/root.crt http://www.cacert.org/certs/class3.crt

update-ca-certificates

</pre>

h3. Replicant 4.2

<pre>

mkdir replicant-4.2

cd replicant-4.2

../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.2

</pre>

h3. Replicant 4.0

<pre>

mkdir replicant-4.0

cd replicant-4.0

../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.0

</pre>

h3. Replicant 2.3

<pre>

mkdir replicant-2.3

cd replicant-2.3

../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.3

</pre>

h3. Replicant 2.2

<pre>

mkdir replicant-2.2

cd replicant-2.2

../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.2

</pre>

h2. Downloading/Updating the source code

Now that you have configured @repo@, you can start downloading Replicant sources for the desired version.

*This step is very long and can take hours to complete!*

<pre>

../tools/repo sync

</pre>

Once the source code is ready, you need to get the prebuilt applications (they are downloaded from F-Droid):

<pre>

vendor/replicant/get-prebuilts

</pre>

You must redo these steps each time you want to sync your tree, in order to keep it up to date. Future syncs are faster than the first one.