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