diff options
Diffstat (limited to 'documentation/sdk-manual/sdk-appendix-customizing.xml')
-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> |