Project

General

Profile

Edit History

DeveloperGuide ยป

SourceCode » History » Version 13

Denis 'GNUtoo' Carikli, 05/31/2014 02:02 PM

1 10 Paul Kocialkowski 
h1. Replicant Sources
2 1 Paul Kocialkowski 





    3
    2
    Paul Kocialkowski
    
h2. Browsing the source





    4
    
    
    





    5
    
    
    
The Replicant source code is currently hosted at Gitorious: https://gitorious.org/replicant 





    6
    
    
    
There is a branch per Replicant version, like @replicant-2.2@.





    7
    
    
    





    8
    1
    Paul Kocialkowski
    
h2. Code tree location





    9
    
    
    





    10
    8
    Linus Drumbler
    
Start by defining the place where you want to download Replicant tree.





    11
    
    
    





    12
    
    
    
*Important: the name of the path to this location must not contain spaces!*





    13
    1
    Paul Kocialkowski
    





    14
    
    
    
h2. Installing the tools





    15
    
    
    





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





    17
    13
    Denis 'GNUtoo'  Carikli
    





    18
    1
    Paul Kocialkowski
    
<pre>





    19
    
    
    
mkdir tools





    20
    
    
    
cd tools





    21
    7
    Paul Kocialkowski
    
wget http://commondatastorage.googleapis.com/git-repo-downloads/repo





    22
    1
    Paul Kocialkowski
    
chmod a+x repo





    23
    
    
    
cd ../





    24
    
    
    
</pre>





    25
    
    
    





    26
    
    
    
h2. Getting the source manifest





    27
    
    
    





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





    29
    
    
    
There is one manifest per replicant version. 





    30
    
    
    





    31
    11
    Paul Kocialkowski
    
h3. Replicant 4.2





    32
    13
    Denis 'GNUtoo'  Carikli
    





    33
    12
    Denis 'GNUtoo'  Carikli
    
If you don't setup your name and email in git, repo will complain:





    34
    13
    Denis 'GNUtoo'  Carikli
    





    35
    12
    Denis 'GNUtoo'  Carikli
    
<pre>





    36
    
    
    
Traceback (most recent call last):





    37
    13
    Denis 'GNUtoo'  Carikli
    
[...]





    38
    12
    Denis 'GNUtoo'  Carikli
    
error.GitError: manifests var: 





    39
    
    
    
*** Please tell me who you are.





    40
    
    
    





    41
    11
    Paul Kocialkowski
    
Run





    42
    12
    Denis 'GNUtoo'  Carikli
    





    43
    
    
    
  git config --global user.email "you@example.com"





    44
    
    
    
  git config --global user.name "Your Name"





    45
    
    
    





    46
    
    
    
to set your account's default identity.





    47
    13
    Denis 'GNUtoo'  Carikli
    
[...]





    48
    12
    Denis 'GNUtoo'  Carikli
    
</pre>





    49
    
    
    
So we setup it correctly, replace the email and the name by a valid one:





    50
    
    
    
<pre>





    51
    
    
    
  git config --global user.email "you@example.com"





    52
    
    
    
  git config --global user.name "Your Name"





    53
    
    
    
</pre>





    54
    11
    Paul Kocialkowski
    
<pre>





    55
    
    
    
mkdir replicant-4.2





    56
    
    
    
cd replicant-4.2





    57
    
    
    
../tools/repo init -u git://gitorious.org/replicant/manifest.git -b replicant-4.2





    58
    
    
    
</pre>





    59
    
    
    





    60
    4
    Paul Kocialkowski
    
h3. Replicant 4.0





    61
    
    
    





    62
    
    
    
<pre>





    63
    
    
    
mkdir replicant-4.0





    64
    
    
    
cd replicant-4.0





    65
    
    
    
../tools/repo init -u git://gitorious.org/replicant/manifest.git -b replicant-4.0





    66
    
    
    
</pre>





    67
    
    
    





    68
    1
    Paul Kocialkowski
    
h3. Replicant 2.3





    69
    
    
    





    70
    
    
    
<pre>





    71
    
    
    
mkdir replicant-2.3





    72
    
    
    
cd replicant-2.3





    73
    
    
    
../tools/repo init -u git://gitorious.org/replicant/manifest.git -b replicant-2.3





    74
    
    
    
</pre>





    75
    
    
    





    76
    
    
    
h3. Replicant 2.2





    77
    
    
    





    78
    
    
    
<pre>





    79
    
    
    
mkdir replicant-2.2





    80
    
    
    
cd replicant-2.2





    81
    
    
    
../tools/repo init -u git://gitorious.org/replicant/manifest.git -b replicant-2.2





    82
    
    
    
</pre>





    83
    
    
    





    84
    3
    Paul Kocialkowski
    
h2. Downloading/Updating the source from the repos





    85
    1
    Paul Kocialkowski
    





    86
    9
    Linus Drumbler
    
Now that you have configured the repository to use a manifest, you can start downloading Replicant sources for the desired version.





    87
    1
    Paul Kocialkowski
    





    88
    9
    Linus Drumbler
    
*This step is very long and can take the whole day to complete!*





    89
    
    
    





    90
    1
    Paul Kocialkowski
    
<pre>





    91
    
    
    
../tools/repo sync





    92
    
    
    
</pre>





    93
    3
    Paul Kocialkowski
    





    94
    9
    Linus Drumbler
    
Depending on your internet bandwidth, using the @-j@ argument may speed up the process (if you encounter errors, retry without the @-j@ argument):





    95
    5
    Paul Kocialkowski
    





    96
    
    
    
<pre>





    97
    
    
    
../tools/repo sync -j9





    98
    
    
    
</pre>





    99
    
    
    





    100
    6
    Paul Kocialkowski
    
You must redo this step each time you want to sync your tree, in order to keep it up to date. Future syncs are faster than the first one.