OLD | NEW |
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) | |
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 Loading... |
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 Loading... |
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 |
OLD | NEW |