Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Side by Side Diff: README.md

Issue 29348920: Issue 3767 - Update README to reflect build changes in 44.0.2 (Closed)
Patch Set: Created July 29, 2016, 10:10 p.m.
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 Adblock Browser 1 Adblock Browser
2 =============== 2 ===============
3 3
4 The Adblock Plus browser, based on Firefox for Android. 4 The Adblock Plus browser, based on Firefox for Android.
5 5
6 Building 6 Building
7 -------- 7 --------
8 8
9 First ensure that all dependencies are up to date by calling: 9 First ensure that all dependencies are up to date by calling:
10 10
11 ./ensure_dependencies.py 11 ./ensure_dependencies.py
12 12
13 Then just follow Mozilla's [Building Fennec][1] guide. 13 Then just follow Mozilla's [Building Fennec][1] guide.
14 14
15 15
16 Important note
17 --------------
18
19 You must add the following line to your `mozconfig`:
20
21 ac_add_options --disable-crashreporter
22
23 to disable the CrashReporter.
24
25 (Follow-up issue: https://issues.adblockplus.org/ticket/2490)
anton 2016/09/12 11:29:26 currently it's also in reviewing state and i'd pre
26
27 Creating a multilocale build 16 Creating a multilocale build
28 ---------------------------- 17 ----------------------------
29 18
30 ### Automation ### 19 ### Automation ###
31 20
32 While the manual process is still documented below, the easiest way to create a 21 While the manual process is still documented below, the easiest way to create a
33 multi-locale build is to use: https://bitbucket.org/adblockplus/adblockbrowser-b uild. 22 multi-locale build is to use: https://bitbucket.org/adblockplus/adblockbrowser-b uild.
34 23
35 ### Preparations ### 24 ### Preparations ###
36 25
(...skipping 25 matching lines...) Expand all
62 * If your `mozconfig` is not called `mozconfig`, change `MOZCONFIG` 51 * If your `mozconfig` is not called `mozconfig`, change `MOZCONFIG`
63 * **Remove the repository pulling part** from `config`. 52 * **Remove the repository pulling part** from `config`.
64 The code to remove looks like this: 53 The code to remove looks like this:
65 54
66 "repos": [{ 55 "repos": [{
67 "repo": "https://hg.mozilla.org/%s" % REPO_PATH, 56 "repo": "https://hg.mozilla.org/%s" % REPO_PATH,
68 "tag": "default", 57 "tag": "default",
69 "dest": BUILD_DIR, 58 "dest": BUILD_DIR,
70 }], 59 }],
71 60
72 * Change `"hg_l10n_tag"` in `config` from `default` to `FENNEC_40_0_RELEASE` 61 * Change `"hg_l10n_tag"` in `config` from `default` to `FENNEC_44_0_2_RELEASE`
62 * Add `en-ZA` to `ignore_locales` since it isn't currently supported
73 * [Issue #3047][2] introduced a custom build step named `abb-transform-locales` 63 * [Issue #3047][2] introduced a custom build step named `abb-transform-locales`
74 for manipulating search engine availability and order. This must be inserted 64 for manipulating search engine availability and order. This must be inserted
75 into `default_actions` right before `package-multi` 65 into `default_actions` right before `package-multi`
76 * You might want to remove the `"backup-objdir"` build step if you do 66 * You might want to remove the `"backup-objdir"` build step if you do
77 not want your objdir to be backed up. Keep in mind that you then need to 67 not want your objdir to be backed up. Keep in mind that you then need to
78 clobber for a single-locale build. 68 clobber for a single-locale build.
79 69
80 An example configuration could look like this: 70 An example configuration could look like this:
81 71
82 import os 72 import os
(...skipping 13 matching lines...) Expand all
96 # Absolute path to your mozconfig. 86 # Absolute path to your mozconfig.
97 # By default it looks at "./mozconfig" 87 # By default it looks at "./mozconfig"
98 MOZCONFIG = os.path.join(os.getcwd(), "mozconfig") 88 MOZCONFIG = os.path.join(os.getcwd(), "mozconfig")
99 89
100 config = { 90 config = {
101 "work_dir": ".", 91 "work_dir": ".",
102 "log_name": "multilocale", 92 "log_name": "multilocale",
103 "objdir": OBJDIR, 93 "objdir": OBJDIR,
104 "locales_file": "%s/%s/locales/maemo-locales" % (BUILD_DIR, ANDROID_DIR) , 94 "locales_file": "%s/%s/locales/maemo-locales" % (BUILD_DIR, ANDROID_DIR) ,
105 "locales_dir": "%s/locales" % ANDROID_DIR, 95 "locales_dir": "%s/locales" % ANDROID_DIR,
106 "ignore_locales": ["en-US", "multi"], 96 "ignore_locales": ["en-US", "en-ZA", "multi"],
107 "l10n_repos": [{ 97 "l10n_repos": [{
108 "repo": "https://hg.mozilla.org/build/compare-locales", 98 "repo": "https://hg.mozilla.org/build/compare-locales",
109 "tag": "RELEASE_AUTOMATION" 99 "tag": "RELEASE_AUTOMATION"
110 }], 100 }],
111 "hg_l10n_base": "https://hg.mozilla.org/%s" % L10N_REPO_PATH, 101 "hg_l10n_base": "https://hg.mozilla.org/%s" % L10N_REPO_PATH,
112 "hg_l10n_tag": "FENNEC_40_0_RELEASE", 102 "hg_l10n_tag": "FENNEC_44_0_2_RELEASE",
113 "l10n_dir": "l10n", 103 "l10n_dir": "l10n",
114 "merge_locales": True, 104 "merge_locales": True,
115 "mozilla_dir": BUILD_DIR, 105 "mozilla_dir": BUILD_DIR,
116 "mozconfig": MOZCONFIG, 106 "mozconfig": MOZCONFIG,
117 "default_actions": [ 107 "default_actions": [
118 "pull-locale-source", 108 "pull-locale-source",
119 "build", 109 "build",
120 "package-en-US", 110 "package-en-US",
121 "restore-objdir", 111 "restore-objdir",
122 "add-locales", 112 "add-locales",
123 "abb-transform-locales", 113 "abb-transform-locales",
124 "package-multi", 114 "package-multi",
125 "summary", 115 "summary",
126 ], 116 ],
127 } 117 }
128 118
129 ### Building ### 119 ### Building ###
130 120
131 For performing the multilocale build, invoke 121 For performing the multilocale build, invoke
132 122
133 ./mozharness/scripts/multil10n.py --cfg abb-multi-cfg.py 123 ./mozharness/scripts/multil10n.py --cfg abb-multi-cfg.py
134 124
135 from inside `abb-multi`. The resulting build is located in 125 from inside `abb-multi`. The resulting build is located in
136 `BUILD_DIR/OBJ_DIR/dist/` 126 `BUILD_DIR/OBJ_DIR/dist/`
137 127
138 [1]: https://wiki.mozilla.org/Mobile/Fennec/Android 128 [1]: https://wiki.mozilla.org/Mobile/Fennec/Android
139 [2]: https://issues.adblockplus.org/ticket/3047 129 [2]: https://issues.adblockplus.org/ticket/3047
OLDNEW
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld