summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-07-17 15:50:14 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-08-15 10:28:43 +0100
commit55d5355b84eea118487a243e048f92e76ab3bcdf (patch)
tree347084c3728d6b907fd6795bdee9661b6ae93c91
parent0efdd1d4daea6994dd62dcd74c9f5daf97219784 (diff)
downloadpoky-55d5355b84eea118487a243e048f92e76ab3bcdf.tar.gz
sdk-manual: Added section on changing the default ext. SDK install directory
(From yocto-docs rev: d3f0c7b9e2ddea3fec6f42fc9a3c8806b02119f3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/sdk-manual/sdk-appendix-customizing.xml45
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