Project

General

Profile

Edit History

DeveloperGuide ยป

SourceCode » History » Version 31

Wolfgang Wiedmeyer, 03/05/2017 05:23 PM
Link directly to the Replicant group as forwarding doesn't work currently

1 25 Paul Kocialkowski 
h1. Replicant 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
    
    
    
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.





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





    13
    
    
    





    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
    
    
    
h2. Installing the tools





    19
    
    
    





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





    21
    13
    Denis 'GNUtoo'  Carikli
    





    22
    1
    Paul Kocialkowski
    
<pre>





    23
    
    
    
mkdir tools





    24
    
    
    
cd tools





    25
    30
    Denis 'GNUtoo'  Carikli
    
wget https://commondatastorage.googleapis.com/git-repo-downloads/repo





    26
    1
    Paul Kocialkowski
    
chmod a+x repo





    27
    
    
    
cd ../





    28
    
    
    
</pre>





    29
    
    
    





    30
    26
    Paul Kocialkowski
    
h2. Initializing the repository





    31
    1
    Paul Kocialkowski
    





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





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





    34
    14
    Denis 'GNUtoo'  Carikli
    





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





    36
    
    
    
<pre>





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





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





    39
    
    
    
update-ca-certificates





    40
    
    
    
</pre>





    41
    
    
    





    42
    14
    Denis 'GNUtoo'  Carikli
    
h3. Replicant 4.2





    43
    1
    Paul Kocialkowski
    





    44
    15
    Denis 'GNUtoo'  Carikli
    
<pre>





    45
    11
    Paul Kocialkowski
    
mkdir replicant-4.2





    46
    
    
    
cd replicant-4.2





    47
    28
    Paul Kocialkowski
    
../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.2





    48
    11
    Paul Kocialkowski
    
</pre>





    49
    
    
    





    50
    4
    Paul Kocialkowski
    
h3. Replicant 4.0





    51
    
    
    





    52
    
    
    
<pre>





    53
    
    
    
mkdir replicant-4.0





    54
    
    
    
cd replicant-4.0





    55
    28
    Paul Kocialkowski
    
../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-4.0





    56
    4
    Paul Kocialkowski
    
</pre>





    57
    
    
    





    58
    1
    Paul Kocialkowski
    
h3. Replicant 2.3





    59
    
    
    





    60
    
    
    
<pre>





    61
    
    
    
mkdir replicant-2.3





    62
    
    
    
cd replicant-2.3





    63
    28
    Paul Kocialkowski
    
../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.3





    64
    1
    Paul Kocialkowski
    
</pre>





    65
    
    
    





    66
    
    
    
h3. Replicant 2.2





    67
    
    
    





    68
    
    
    
<pre>





    69
    
    
    
mkdir replicant-2.2





    70
    
    
    
cd replicant-2.2





    71
    28
    Paul Kocialkowski
    
../tools/repo init -u https://git.replicant.us/replicant/manifest.git -b replicant-2.2





    72
    1
    Paul Kocialkowski
    
</pre>





    73
    
    
    





    74
    26
    Paul Kocialkowski
    
h2. Downloading/Updating the source code





    75
    1
    Paul Kocialkowski
    





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





    77
    3
    Paul Kocialkowski
    





    78
    26
    Paul Kocialkowski
    
*This step is very long and can take hours to complete!*





    79
    5
    Paul Kocialkowski
    





    80
    
    
    
<pre>





    81
    
    
    
../tools/repo sync





    82
    
    
    
</pre>





    83
    
    
    





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





    85
    17
    Paul Kocialkowski
    
<pre>





    86
    
    
    
vendor/replicant/get-prebuilts





    87
    18
    Taro K.
    
</pre>





    88
    
    
    





    89
    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.