diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/sdk-manual/sdk-appendix-customizing.xml | 47 |
1 files changed, 29 insertions, 18 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing.xml b/documentation/sdk-manual/sdk-appendix-customizing.xml index 6c68a849ff..d3544b21dc 100644 --- a/documentation/sdk-manual/sdk-appendix-customizing.xml +++ b/documentation/sdk-manual/sdk-appendix-customizing.xml | |||
| @@ -269,27 +269,38 @@ | |||
| 269 | <title>Providing Additional Installable Extensible SDK Content</title> | 269 | <title>Providing Additional Installable Extensible SDK Content</title> |
| 270 | 270 | ||
| 271 | <para> | 271 | <para> |
| 272 | If you want the users of the extensible SDK you are building to be | 272 | If you want the users of an extensible SDK you build to be |
| 273 | able to add items to the SDK without needing to build the | 273 | able to add items to the SDK without requiring the users to build |
| 274 | items from source, you need to do a number of things: | 274 | the items from source, you need to do a number of things: |
| 275 | <orderedlist> | 275 | <itemizedlist> |
| 276 | <listitem><para> | 276 | <listitem><para> |
| 277 | Ensure the additional items you want the user to be able to | 277 | Ensure the additional items you want the user to be able to |
| 278 | install are actually built. | 278 | install are already built: |
| 279 | You can ensure these items are built a number of different | 279 | <itemizedlist> |
| 280 | ways: 1) Build them explicitly, perhaps using one or more | 280 | <listitem><para> |
| 281 | "meta" recipes that depend on lists of other recipes to keep | 281 | Build the items explicitly. |
| 282 | things tidy, or 2) Build the "world" target and set | 282 | You could use one or more "meta" recipes that depend |
| 283 | <filename>EXCLUDE_FROM_WORLD_pn-</filename><replaceable>recipename</replaceable> | 283 | on lists of other recipes. |
| 284 | for the recipes you do not want built. | 284 | </para></listitem> |
| 285 | See the | 285 | <listitem><para> |
| 286 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXCLUDE_FROM_WORLD'><filename>EXCLUDE_FROM_WORLD</filename></ulink> | 286 | Build the "world" target and set |
| 287 | variable for additional information. | 287 | <filename>EXCLUDE_FROM_WORLD_pn-</filename><replaceable>recipename</replaceable> |
| 288 | for the recipes you do not want built. | ||
| 289 | See the | ||
| 290 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXCLUDE_FROM_WORLD'><filename>EXCLUDE_FROM_WORLD</filename></ulink> | ||
| 291 | variable for additional information. | ||
| 292 | </para></listitem> | ||
| 293 | </itemizedlist> | ||
| 288 | </para></listitem> | 294 | </para></listitem> |
| 289 | <listitem><para> | 295 | <listitem><para> |
| 290 | Expose the <filename>sstate-cache</filename> directory | 296 | Expose the <filename>sstate-cache</filename> directory |
| 291 | produced by the build. | 297 | produced by the build. |
| 292 | Typically, you expose this directory over HTTP or HTTPS. | 298 | Typically, you expose this directory by making it available |
| 299 | through an | ||
| 300 | <ulink url='https://en.wikipedia.org/wiki/Apache_HTTP_Server'>Apache HTTP Server</ulink> | ||
| 301 | or | ||
| 302 | <ulink url='https://en.wikipedia.org/wiki/Nginx'>Nginx</ulink> | ||
| 303 | server. | ||
| 293 | </para></listitem> | 304 | </para></listitem> |
| 294 | <listitem><para> | 305 | <listitem><para> |
| 295 | Set the appropriate configuration so that the produced SDK | 306 | Set the appropriate configuration so that the produced SDK |
| @@ -322,7 +333,7 @@ | |||
| 322 | Alternatively, if you just want to set the | 333 | Alternatively, if you just want to set the |
| 323 | <filename>SSTATE_MIRRORS</filename> variable's value | 334 | <filename>SSTATE_MIRRORS</filename> variable's value |
| 324 | for the SDK alone, create a | 335 | for the SDK alone, create a |
| 325 | <filename>conf/sdk-extra.conf</filename> either in | 336 | <filename>conf/sdk-extra.conf</filename> file either in |
| 326 | your | 337 | your |
| 327 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> | 338 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> |
| 328 | or within any layer and put your | 339 | or within any layer and put your |
| @@ -336,7 +347,7 @@ | |||
| 336 | </para></listitem> | 347 | </para></listitem> |
| 337 | </itemizedlist> | 348 | </itemizedlist> |
| 338 | </para></listitem> | 349 | </para></listitem> |
| 339 | </orderedlist> | 350 | </itemizedlist> |
| 340 | </para> | 351 | </para> |
| 341 | </section> | 352 | </section> |
| 342 | 353 | ||
| @@ -410,7 +421,7 @@ | |||
| 410 | then providing a shared state mirror is mandatory so that items | 421 | then providing a shared state mirror is mandatory so that items |
| 411 | can be installed as needed. | 422 | can be installed as needed. |
| 412 | See the | 423 | See the |
| 413 | "<link linkend='sdk-providing-additional-installable-extensible-sdk-content'>Providing Additional Installable Extensible SDK Content</link>" | 424 | "<link linkend='sdk-providing-additional-extensible-sdk-content'>Providing Additional Installable Extensible SDK Content</link>" |
| 414 | section for more information. | 425 | section for more information. |
| 415 | </note> | 426 | </note> |
| 416 | </para> | 427 | </para> |
