OLD | NEW |
1 # The MB (Meta-Build wrapper) user guide | 1 # The MB (Meta-Build wrapper) user guide |
2 | 2 |
3 [TOC] | 3 [TOC] |
4 | 4 |
5 ## Introduction | 5 ## Introduction |
6 | 6 |
7 `mb` is a simple python wrapper around the GYP and GN meta-build tools to | 7 `mb` is a simple python wrapper around the GYP and GN meta-build tools to |
8 be used as part of the GYP->GN migration. | 8 be used as part of the GYP->GN migration. |
9 | 9 |
10 It is intended to be used by bots to make it easier to manage the configuration | 10 It is intended to be used by bots to make it easier to manage the configuration |
(...skipping 156 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
167 | 167 |
168 The value of each key is a list of "mixins" that will define what that | 168 The value of each key is a list of "mixins" that will define what that |
169 build_config does. Each item in the list must be an entry in the dictionary | 169 build_config does. Each item in the list must be an entry in the dictionary |
170 value of the `mixins` key. | 170 value of the `mixins` key. |
171 | 171 |
172 Each mixin value is itself a dictionary that contains one or more of the | 172 Each mixin value is itself a dictionary that contains one or more of the |
173 following keys: | 173 following keys: |
174 | 174 |
175 * `gyp_configs`: a list of the configurations to build, e.g., | 175 * `gyp_configs`: a list of the configurations to build, e.g., |
176 ['Release', 'Release_x64']. | 176 ['Release', 'Release_x64']. |
| 177 * `gyp_crosscompile`: a boolean; if true, GYP_CROSSCOMPILE=1 is set in |
| 178 the environment and passed to GYP. |
177 * `gyp_defines`: a string containing a list of GYP_DEFINES. | 179 * `gyp_defines`: a string containing a list of GYP_DEFINES. |
178 * `gn_args`: a string containing a list of values passed to gn --args. | 180 * `gn_args`: a string containing a list of values passed to gn --args. |
179 * `mixins`: a list of other mixins that should be included. | 181 * `mixins`: a list of other mixins that should be included. |
180 * `type`: a string with either the value `gyp` or `gn`; | 182 * `type`: a string with either the value `gyp` or `gn`; |
181 setting this indicates which meta-build tool to use. | 183 setting this indicates which meta-build tool to use. |
182 | 184 |
183 When `mb gen` or `mb analyze` executes, it takes a config name, looks it | 185 When `mb gen` or `mb analyze` executes, it takes a config name, looks it |
184 up in the 'configs' dict, and then does a left-to-right expansion of the | 186 up in the 'configs' dict, and then does a left-to-right expansion of the |
185 mixins; gyp_defines and gn_args values are concatenated, and type and | 187 mixins; gyp_defines and gn_args values are concatenated, and type and |
186 gyp_configs values override each other. | 188 gyp_configs values override each other. |
(...skipping 49 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
236 run than you expect; running `'mb -v'` will print what it's doing and | 238 run than you expect; running `'mb -v'` will print what it's doing and |
237 run the commands; `'mb -n'` will print what it will do but *not* run | 239 run the commands; `'mb -n'` will print what it will do but *not* run |
238 the commands. | 240 the commands. |
239 | 241 |
240 If you hit weirder things than that, add some print statements to the | 242 If you hit weirder things than that, add some print statements to the |
241 python script, send a question to gn-dev@chromium.org, or | 243 python script, send a question to gn-dev@chromium.org, or |
242 [file a bug](https://crbug.com/new) with the label | 244 [file a bug](https://crbug.com/new) with the label |
243 'mb' and cc: dpranke@chromium.org. | 245 'mb' and cc: dpranke@chromium.org. |
244 | 246 |
245 | 247 |
OLD | NEW |