diff options
-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 1c6e461361..78ead9c022 100644 --- a/documentation/sdk-manual/sdk-appendix-customizing.xml +++ b/documentation/sdk-manual/sdk-appendix-customizing.xml | |||
@@ -337,27 +337,38 @@ | |||
337 | <title>Providing Additional Installable Extensible SDK Content</title> | 337 | <title>Providing Additional Installable Extensible SDK Content</title> |
338 | 338 | ||
339 | <para> | 339 | <para> |
340 | If you want the users of the extensible SDK you are building to be | 340 | If you want the users of an extensible SDK you build to be |
341 | able to add items to the SDK without needing to build the | 341 | able to add items to the SDK without requiring the users to build |
342 | items from source, you need to do a number of things: | 342 | the items from source, you need to do a number of things: |
343 | <orderedlist> | 343 | <itemizedlist> |
344 | <listitem><para> | 344 | <listitem><para> |
345 | Ensure the additional items you want the user to be able to | 345 | Ensure the additional items you want the user to be able to |
346 | install are actually built. | 346 | install are already built: |
347 | You can ensure these items are built a number of different | 347 | <itemizedlist> |
348 | ways: 1) Build them explicitly, perhaps using one or more | 348 | <listitem><para> |
349 | "meta" recipes that depend on lists of other recipes to keep | 349 | Build the items explicitly. |
350 | things tidy, or 2) Build the "world" target and set | 350 | You could use one or more "meta" recipes that depend |
351 | <filename>EXCLUDE_FROM_WORLD_pn-</filename><replaceable>recipename</replaceable> | 351 | on lists of other recipes. |
352 | for the recipes you do not want built. | 352 | </para></listitem> |
353 | See the | 353 | <listitem><para> |
354 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXCLUDE_FROM_WORLD'><filename>EXCLUDE_FROM_WORLD</filename></ulink> | 354 | Build the "world" target and set |
355 | variable for additional information. | 355 | <filename>EXCLUDE_FROM_WORLD_pn-</filename><replaceable>recipename</replaceable> |
356 | for the recipes you do not want built. | ||
357 | See the | ||
358 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXCLUDE_FROM_WORLD'><filename>EXCLUDE_FROM_WORLD</filename></ulink> | ||
359 | variable for additional information. | ||
360 | </para></listitem> | ||
361 | </itemizedlist> | ||
356 | </para></listitem> | 362 | </para></listitem> |
357 | <listitem><para> | 363 | <listitem><para> |
358 | Expose the <filename>sstate-cache</filename> directory | 364 | Expose the <filename>sstate-cache</filename> directory |
359 | produced by the build. | 365 | produced by the build. |
360 | Typically, you expose this directory over HTTP or HTTPS. | 366 | Typically, you expose this directory by making it available |
367 | through an | ||
368 | <ulink url='https://en.wikipedia.org/wiki/Apache_HTTP_Server'>Apache HTTP Server</ulink> | ||
369 | or | ||
370 | <ulink url='https://en.wikipedia.org/wiki/Nginx'>Nginx</ulink> | ||
371 | server. | ||
361 | </para></listitem> | 372 | </para></listitem> |
362 | <listitem><para> | 373 | <listitem><para> |
363 | Set the appropriate configuration so that the produced SDK | 374 | Set the appropriate configuration so that the produced SDK |
@@ -390,7 +401,7 @@ | |||
390 | Alternatively, if you just want to set the | 401 | Alternatively, if you just want to set the |
391 | <filename>SSTATE_MIRRORS</filename> variable's value | 402 | <filename>SSTATE_MIRRORS</filename> variable's value |
392 | for the SDK alone, create a | 403 | for the SDK alone, create a |
393 | <filename>conf/sdk-extra.conf</filename> either in | 404 | <filename>conf/sdk-extra.conf</filename> file either in |
394 | your | 405 | your |
395 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> | 406 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> |
396 | or within any layer and put your | 407 | or within any layer and put your |
@@ -404,7 +415,7 @@ | |||
404 | </para></listitem> | 415 | </para></listitem> |
405 | </itemizedlist> | 416 | </itemizedlist> |
406 | </para></listitem> | 417 | </para></listitem> |
407 | </orderedlist> | 418 | </itemizedlist> |
408 | </para> | 419 | </para> |
409 | </section> | 420 | </section> |
410 | 421 | ||
@@ -478,7 +489,7 @@ | |||
478 | then providing a shared state mirror is mandatory so that items | 489 | then providing a shared state mirror is mandatory so that items |
479 | can be installed as needed. | 490 | can be installed as needed. |
480 | See the | 491 | See the |
481 | "<link linkend='sdk-providing-additional-installable-extensible-sdk-content'>Providing Additional Installable Extensible SDK Content</link>" | 492 | "<link linkend='sdk-providing-additional-extensible-sdk-content'>Providing Additional Installable Extensible SDK Content</link>" |
482 | section for more information. | 493 | section for more information. |
483 | </note> | 494 | </note> |
484 | </para> | 495 | </para> |