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

Side by Side Diff: README.md

Issue 29515617: Issue 5517 - Update README.md with build changes required by 45.0.2 merge (Closed)
Patch Set: Adding https to adblockbrowser-build link Created Aug. 16, 2017, 1:09 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 [Firefox for Android build instructions][1].
14 14
15 15
16 Creating a multilocale build 16 Creating a multilocale build
17 ---------------------------- 17 ----------------------------
18 18
19 ### Automation ### 19 ### Automation ###
20 20
21 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
22 multi-locale build is to use: https://bitbucket.org/adblockplus/adblockbrowser-b uild. 22 multi-locale build is to use [adblockbrowser-build][2].
23 23
24 ### Preparations ### 24 ### Preparations ###
25 25
26 1. Create a folder outside of the Adblock Browser repo, e.g `abb-multi` 26 1. Create a folder outside of the Adblock Browser repo, e.g `abb-multi`
27 2. Change into `abb-multi` and clone mozharness via: 27 2. Change into `abb-multi` and clone mozharness via:
28 28
29 hg clone ssh://hg@bitbucket.org/adblockplus/mozharness -r adblockbrowser 29 hg clone ssh://hg@bitbucket.org/adblockplus/mozharness -r adblockbrowser
30 30
31 3. Symlink the adblockbrowser repo into `abb-multi`, e.g.: 31 3. Symlink the adblockbrowser repo into `abb-multi`, e.g.:
32 32
(...skipping 18 matching lines...) Expand all
51 * If your `mozconfig` is not called `mozconfig`, change `MOZCONFIG` 51 * If your `mozconfig` is not called `mozconfig`, change `MOZCONFIG`
52 * **Remove the repository pulling part** from `config`. 52 * **Remove the repository pulling part** from `config`.
53 The code to remove looks like this: 53 The code to remove looks like this:
54 54
55 "repos": [{ 55 "repos": [{
56 "repo": "https://hg.mozilla.org/%s" % REPO_PATH, 56 "repo": "https://hg.mozilla.org/%s" % REPO_PATH,
57 "tag": "default", 57 "tag": "default",
58 "dest": BUILD_DIR, 58 "dest": BUILD_DIR,
59 }], 59 }],
60 60
61 * Change `"hg_l10n_tag"` in `config` from `default` to `FENNEC_44_0_2_RELEASE` 61 * Change `"hg_l10n_tag"` in `config` from `default` to `FENNEC_45_0_2_RELEASE`
62 * Add `en-ZA` to `ignore_locales` since it isn't currently supported 62 * Add `en-ZA` to `ignore_locales` since it isn't currently supported
63 * [Issue #3047][2] introduced a custom build step named `abb-transform-locales` 63 * [Issue #3047][3] introduced a custom build step named `abb-transform-locales`
64 for manipulating search engine availability and order. This must be inserted 64 for manipulating search engine availability and order. This must be inserted
65 into `default_actions` right before `package-multi` 65 into `default_actions` right before `package-multi`
66 * 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
67 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
68 clobber for a single-locale build. 68 clobber for a single-locale build.
69 69
70 An example configuration could look like this: 70 An example configuration could look like this:
71 71
72 import os 72 import os
73 # The name of the directory we'll pull our source into. 73 # The name of the directory we'll pull our source into.
(...skipping 18 matching lines...) Expand all
92 "log_name": "multilocale", 92 "log_name": "multilocale",
93 "objdir": OBJDIR, 93 "objdir": OBJDIR,
94 "locales_file": "%s/%s/locales/maemo-locales" % (BUILD_DIR, ANDROID_DIR) , 94 "locales_file": "%s/%s/locales/maemo-locales" % (BUILD_DIR, ANDROID_DIR) ,
95 "locales_dir": "%s/locales" % ANDROID_DIR, 95 "locales_dir": "%s/locales" % ANDROID_DIR,
96 "ignore_locales": ["en-US", "en-ZA", "multi"], 96 "ignore_locales": ["en-US", "en-ZA", "multi"],
97 "l10n_repos": [{ 97 "l10n_repos": [{
98 "repo": "https://hg.mozilla.org/build/compare-locales", 98 "repo": "https://hg.mozilla.org/build/compare-locales",
99 "tag": "RELEASE_AUTOMATION" 99 "tag": "RELEASE_AUTOMATION"
100 }], 100 }],
101 "hg_l10n_base": "https://hg.mozilla.org/%s" % L10N_REPO_PATH, 101 "hg_l10n_base": "https://hg.mozilla.org/%s" % L10N_REPO_PATH,
102 "hg_l10n_tag": "FENNEC_44_0_2_RELEASE", 102 "hg_l10n_tag": "FENNEC_45_0_2_RELEASE",
103 "l10n_dir": "l10n", 103 "l10n_dir": "l10n",
104 "merge_locales": True, 104 "merge_locales": True,
105 "mozilla_dir": BUILD_DIR, 105 "mozilla_dir": BUILD_DIR,
106 "mozconfig": MOZCONFIG, 106 "mozconfig": MOZCONFIG,
107 "default_actions": [ 107 "default_actions": [
108 "pull-locale-source", 108 "pull-locale-source",
109 "build", 109 "build",
110 "package-en-US", 110 "package-en-US",
111 "restore-objdir", 111 "restore-objdir",
112 "add-locales", 112 "add-locales",
113 "abb-transform-locales", 113 "abb-transform-locales",
114 "package-multi", 114 "package-multi",
115 "summary", 115 "summary",
116 ], 116 ],
117 } 117 }
118 118
119 ### Building ### 119 ### Building ###
120 120
121 For performing the multilocale build, invoke 121 For performing the multilocale build, invoke
122 122
123 ./mozharness/scripts/multil10n.py --cfg abb-multi-cfg.py 123 ./mozharness/scripts/multil10n.py --cfg abb-multi-cfg.py
124 124
125 from inside `abb-multi`. The resulting build is located in 125 from inside `abb-multi`. The resulting build is located in
126 `BUILD_DIR/OBJ_DIR/dist/` 126 `BUILD_DIR/OBJ_DIR/dist/`
127 127
128 [1]: https://wiki.mozilla.org/Mobile/Fennec/Android 128 [1]: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Inst ructions/Simple_Firefox_for_Android_build
129 [2]: https://issues.adblockplus.org/ticket/3047 129 [2]: https://hg.adblockplus.org/adblockbrowser-build/
130 [3]: 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