Project

General

Profile

SourceCode » History » Version 42

dl lud, 08/21/2019 05:08 PM
Removed redundant "Replicant" word from page name.

1 42 dl lud
h1. Source code
2 1 Paul Kocialkowski
3 25 Paul Kocialkowski
h2. Browsing the source code
4 2 Paul Kocialkowski
5 31 Wolfgang Wiedmeyer
The Replicant source code is currently hosted by the "FSF":https://www.fsf.org/ at: "git.replicant.us":https://git.replicant.us/replicant
6 27 Paul Kocialkowski
7
There is one branch per Replicant version, such as @replicant-2.2@.
8 2 Paul Kocialkowski
9 20 Paul Kocialkowski
h2. Disk space
10
11 36 Wolfgang Wiedmeyer
Before downloading the Replicant source code, make sure there is a considerable amount of disk space left on the drive you intend to build Replicant on.
12
It is advised to have 60-70GiB available for the Replicant source code and the produced files for one device. If you intend to build for multiple devices, every additional device will need ca. 17GiB.
13 20 Paul Kocialkowski
14 23 Paul Kocialkowski
h2. Source tree root folder
15 1 Paul Kocialkowski
16 23 Paul Kocialkowski
The path to the source tree root folder *must not contain spaces*.
17 1 Paul Kocialkowski
18 32 Wolfgang Wiedmeyer
h2. Installing the repo tool
19 1 Paul Kocialkowski
20 32 Wolfgang Wiedmeyer
To be able download the complete source code, the "@repo@ tool":https://android.googlesource.com/tools/repo needs to be installed. The distribution you are using may already have the tool packaged and it may already been installed as part of the [[BuildDependenciesInstallation|Build dependencies installation]].
21 1 Paul Kocialkowski
22 34 Wolfgang Wiedmeyer
It is recommended to install the @repo@ tool with the package manager. However, if the @repo@ tool is not available on your system, you can download and install it locally:
23 32 Wolfgang Wiedmeyer
24 1 Paul Kocialkowski
<pre>
25
mkdir tools
26
cd tools
27 30 Denis 'GNUtoo' Carikli
wget https://commondatastorage.googleapis.com/git-repo-downloads/repo
28 1 Paul Kocialkowski
chmod a+x repo
29
cd ../
30
</pre>
31 32 Wolfgang Wiedmeyer
32 35 Wolfgang Wiedmeyer
In the following, it is assumed that @repo@ is installed from your system's package manager. If you have installed @repo@ locally in @../tools/repo@, replace
33 32 Wolfgang Wiedmeyer
34
<pre>
35 35 Wolfgang Wiedmeyer
repo
36 1 Paul Kocialkowski
</pre>
37 32 Wolfgang Wiedmeyer
38 35 Wolfgang Wiedmeyer
with
39 32 Wolfgang Wiedmeyer
<pre>
40 35 Wolfgang Wiedmeyer
../tools/repo
41 32 Wolfgang Wiedmeyer
</pre>
42
43
at the beginning of the following commands.
44 1 Paul Kocialkowski
45 26 Paul Kocialkowski
h2. Initializing the repository
46 1 Paul Kocialkowski
47 16 Paul Kocialkowski
The source manifest is the list of all the git repositories that are present in the Replicant tree.
48 1 Paul Kocialkowski
Each Replicant version has a dedicated branch with the proper source manifest.
49
50 36 Wolfgang Wiedmeyer
h3. Replicant 6.0 release version
51
52 29 Loic Dachary
<pre>
53 36 Wolfgang Wiedmeyer
mkdir replicant-6.0
54
cd replicant-6.0
55 39 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-6.0
56 29 Loic Dachary
</pre>
57
58 1 Paul Kocialkowski
h3. Replicant 6.0 development version
59 33 Wolfgang Wiedmeyer
60
<pre>
61
mkdir replicant-6.0-dev
62
cd replicant-6.0-dev
63 35 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-6.0-dev
64 33 Wolfgang Wiedmeyer
</pre>
65 1 Paul Kocialkowski
66 14 Denis 'GNUtoo' Carikli
h3. Replicant 4.2
67 1 Paul Kocialkowski
68 15 Denis 'GNUtoo' Carikli
<pre>
69 11 Paul Kocialkowski
mkdir replicant-4.2
70
cd replicant-4.2
71 35 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.2
72 1 Paul Kocialkowski
</pre>
73 11 Paul Kocialkowski
74 4 Paul Kocialkowski
h3. Replicant 4.0
75
76
<pre>
77
mkdir replicant-4.0
78
cd replicant-4.0
79 35 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.0
80 4 Paul Kocialkowski
</pre>
81
82 1 Paul Kocialkowski
h3. Replicant 2.3
83
84
<pre>
85
mkdir replicant-2.3
86
cd replicant-2.3
87 35 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.3
88 1 Paul Kocialkowski
</pre>
89
90
h3. Replicant 2.2
91
92
<pre>
93
mkdir replicant-2.2
94
cd replicant-2.2
95 35 Wolfgang Wiedmeyer
repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.2
96 1 Paul Kocialkowski
</pre>
97
98 26 Paul Kocialkowski
h2. Downloading/Updating the source code
99 1 Paul Kocialkowski
100 26 Paul Kocialkowski
Now that you have configured @repo@, you can start downloading Replicant sources for the desired version.
101 1 Paul Kocialkowski
102
*This step is very long and can take hours to complete!*
103
104
<pre>
105
repo sync
106
</pre>
107
108 38 Wolfgang Wiedmeyer
For the Replicant 6.0 release branch, it is possible and recommended to verify the signatures of the Git tags in all repositories:[[ReplicantSourceCodeTagsVerification]]
109 37 Wolfgang Wiedmeyer
110
h3. Prebuilt apps
111
112 36 Wolfgang Wiedmeyer
Once the source code is ready, you need to get the prebuilt applications (they are downloaded from F-Droid). Since Replicant 6.0, the prebuilt applications are checked if they were signed with the "F-Droid signing key":https://f-droid.org/wiki/page/Release_Channels_and_Signing_Keys. The signing key can be retrieved and added to your GPG keyring using:
113
114
<pre>
115 40 Denis 'GNUtoo' Carikli
gpg --recv-key 37D2C98789D8311948394E3E41E7044E1DBA2E89
116 36 Wolfgang Wiedmeyer
</pre>
117
118
Then you can download the prebuilts:
119
120 17 Paul Kocialkowski
<pre>
121
vendor/replicant/get-prebuilts
122 18 Taro K.
</pre>
123
124 17 Paul Kocialkowski
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.