README.MAKEFILE 4.02 KB
Newer Older
1
2
3
4
5
6
7
8
9
Description of makefile rules
=============================


release
-------
Build Tor Browser for the release channel, for all supported platforms.
The resulting build can be found in directory release/$version.

10
release-{linux-x86_64,linux-i686,windows-i686,osx-x86_64,android-armv7,
11
         android-x86,android-x86_64,android-aarch64}
12
-----------------------------------------------------------------------
13
14
15
16
17
Same as release, for the selected platform only.

alpha
-----
Build Tor Browser for the alpha channel, for all supported platforms.
Georg Koppen's avatar
Georg Koppen committed
18
The resulting build can be found in directory alpha/$version.
19

20
alpha-{linux-x86_64,linux-i686,windows-i686,osx-x86_64,android-armv7,
21
       android-x86,android-x86_64,android-aarch64}
22
---------------------------------------------------------------------
23
24
25
26
27
28
29
30
31
32
33
Same as alpha, for the selected platform only.

nightly
-------
Build Tor Browser for the nightly channel, for all supported platforms.
Many of the components will be based on the master branch. You might
want to run "make fetch" before, to fetch the latest commits from all
components.

The resulting build can be found in directory nightly/$date

34
nightly-{linux-x86_64,linux-i686,windows-i686,osx-x86_64,android-armv7,
35
         android-x86,android-x86_64,android-aarch64}
36
-----------------------------------------------------------------------
37
38
39
40
41
42
43
44
Same as nightly, for the selected platform only.

alpha_nightly
-------------
Build Tor Browser for the alpha channel, for all supported platforms.
This is the same as 'make alpha', but the output directory is different.
The resulting build can be found in directory alpha_nightly/$date

45
alpha_nightly-{linux-x86_64,linux-i686,windows-i686,osx-x86_64,android-armv7,
46
               android-x86,android-x86_64,android-aarch64}
47
-----------------------------------------------------------------------------
48
49
50
51
52
The same as alpha_nightly, for the selected platform only.

testbuild
---------
Build a Tor Browser test build. To make the build faster, only the en-US
53
54
55
56
locale is created, without mar files, and without the source tarballs.
By default it is based on the alpha channel, but you can change that by
editing rbm.local.conf. The resulting build can be found in directory
testbuild.
57

boklm's avatar
boklm committed
58
59
60
61
{release,alpha,nightly,testbuild}-linux-x86_64-debug
----------------------------------------------------
Create a debug build for Linux x86_64 with debug features such as ASan.

62
63
64
65
{release,alpha,nightly,testbuild}-src
-------------------------------------
Create source tarballs for firefox, torbutton and tor-launcher.

66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
fetch
-----
Fetch new commits from all components. This is useful when you want to
build the nightly channel.

clean
-----
Clean files created during previous builds that are no longer used in
current builds. Before using this command, you first need to configure
in rbm.local.conf the channel(s) that you are building.

In other software, the clean rule is used to remove all build files,
but this is not the case here, where only obsolete build files are
removed. It is usually not necessary to remove all build files before
starting a new build as the need for rebuilding components is detected
automatically. If you want to remove all build files, you can remove
the out/ directory.

clean-dry-run
-------------
Print the files that would be removed when running 'make clean'.

signtag-{release,alpha}
-----------------------
Create a git signed tag for the selected channel, using the version and
build number defined as var/torbrowser_version and var/torbrowser_build.

93
94
95
96
97
incrementals-{release,alpha}
----------------------------
Create incremental mar files for an unsigned build in the release or
alpha channel.

boklm's avatar
boklm committed
98
99
100
101
102
103
dmg2mar-{release,alpha)
-----------------------
Generate updated mar files for the OSX bundles, from the dmg files, then
regenerate the OSX incremental mar files. You should run this after
signing the OSX dmg files.

104
105
106
update_responses-{release,alpha}
--------------------------------
Create update responses xml files for a signed build in the release or
107
108
alpha channel. The files can be found in a tar in the directory
{release,alpha}/update-responses.
109