diff options
-rw-r--r-- | documentation/sdk-manual/sdk-appendix-customizing.xml | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing.xml b/documentation/sdk-manual/sdk-appendix-customizing.xml index 718b9d4c19..7224049fa2 100644 --- a/documentation/sdk-manual/sdk-appendix-customizing.xml +++ b/documentation/sdk-manual/sdk-appendix-customizing.xml | |||
@@ -260,6 +260,51 @@ | |||
260 | </para> | 260 | </para> |
261 | </section> | 261 | </section> |
262 | 262 | ||
263 | <section id='sdk-changing-the-default-sdk-installation-directory'> | ||
264 | <title>Changing the Default SDK Installation Directory</title> | ||
265 | |||
266 | <para> | ||
267 | When you build the installer for the Extensible SDK, the default | ||
268 | installation directory for the SDK is based on the | ||
269 | <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> | ||
270 | and | ||
271 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SDKEXTPATH'><filename>SDKEXTPATH</filename></ulink> | ||
272 | variables from within the | ||
273 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-populate-sdk-*'><filename>populate_sdk_base</filename></ulink> | ||
274 | class as follows: | ||
275 | <literallayout class='monospaced'> | ||
276 | SDKEXTPATH ??= "~/${@d.getVar('DISTRO')}_sdk" | ||
277 | </literallayout> | ||
278 | You can change this default installation directory by specifically | ||
279 | setting the <filename>SDKEXTPATH</filename> variable. | ||
280 | </para> | ||
281 | |||
282 | <para> | ||
283 | While a number of ways exist through which you can set this variable, | ||
284 | the method that makes the most sense is to set the variable in your | ||
285 | distribution's configuration file. | ||
286 | Doing so creates an SDK installer default directory that applies | ||
287 | across your distribution. | ||
288 | As an example, assume you have your own layer for your distribution | ||
289 | named "meta-mydistro" and you are using the same type of file | ||
290 | hierarchy as does the default "poky" distribution. | ||
291 | If so, you could update the <filename>SDKEXTPATH</filename> variable | ||
292 | in the | ||
293 | <filename>~/meta-mydistro/conf/distro/mydistro.conf</filename> file | ||
294 | using the following form: | ||
295 | <literallayout class='monospaced'> | ||
296 | SDKEXTPATH = "<replaceable>some_path_for_your_installed_sdk</replaceable>" | ||
297 | </literallayout> | ||
298 | </para> | ||
299 | |||
300 | <para> | ||
301 | After building your installer, running it prompts the user for | ||
302 | acceptance of the | ||
303 | <replaceable>some_path_for_your_installed_sdk</replaceable> directory | ||
304 | as the default location to install the Extensible SDK. | ||
305 | </para> | ||
306 | </section> | ||
307 | |||
263 | <section id='sdk-providing-additional-installable-extensible-sdk-content'> | 308 | <section id='sdk-providing-additional-installable-extensible-sdk-content'> |
264 | <title>Providing Additional Installable Extensible SDK Content</title> | 309 | <title>Providing Additional Installable Extensible SDK Content</title> |
265 | 310 | ||