summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorAlexander Kanavin <alex.kanavin@gmail.com>2023-11-22 13:42:48 +0100
committerSteve Sakoman <steve@sakoman.com>2023-11-28 05:00:32 -1000
commit8dc22248a8257e974e40b454474028790d0a76a1 (patch)
treec83d3a4ee8fb8aa44430eec447cf1ade5fa145f7 /documentation
parentb159ad2464a87f10bc92b718f76e908ad48a6ea0 (diff)
downloadpoky-8dc22248a8257e974e40b454474028790d0a76a1.tar.gz
sdk-manual: extensible.rst: remove instructions for using SDK functionality directly in a yocto build
This was not actually backported to kirkstone (and isn't going to be) but the documentation for the feature erroneously did make its way from master into kirkstone. (From yocto-docs rev: 08fda7a5601393617b1ecfe89229459e14a90b1d) Signed-off-by: Alexander Kanavin <alex@linutronix.de> Signed-off-by: Steve Sakoman <steve@sakoman.com>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/sdk-manual/extensible.rst63
1 files changed, 1 insertions, 62 deletions
diff --git a/documentation/sdk-manual/extensible.rst b/documentation/sdk-manual/extensible.rst
index 355c6cb0e4..7edb3eb4b4 100644
--- a/documentation/sdk-manual/extensible.rst
+++ b/documentation/sdk-manual/extensible.rst
@@ -41,44 +41,6 @@ functionality.
41Installing the Extensible SDK 41Installing the Extensible SDK
42============================= 42=============================
43 43
44Two ways to install the Extensible SDK
45--------------------------------------
46
47Extensible SDK can be installed in two different ways, and both have
48their own pros and cons:
49
50#. *Setting up the Extensible SDK environment directly in a Yocto build*. This
51 avoids having to produce, test, distribute and maintain separate SDK
52 installer archives, which can get very large. There is only one environment
53 for the regular Yocto build and the SDK and less code paths where things can
54 go not according to plan. It's easier to update the SDK: it simply means
55 updating the Yocto layers with git fetch or layer management tooling. The
56 SDK extensibility is better than in the second option: just run ``bitbake``
57 again to add more things to the sysroot, or add layers if even more things
58 are required.
59
60#. *Setting up the Extensible SDK from a standalone installer*. This has the
61 benefit of having a single, self-contained archive that includes all the
62 needed binary artifacts. So nothing needs to be rebuilt, and there is no
63 need to provide a well-functioning binary artefact cache over the network
64 for developers with underpowered laptops.
65
66Setting up the Extensible SDK environment directly in a Yocto build
67-------------------------------------------------------------------
68
69#. Set up all the needed layers and a Yocto :term:`Build Directory`, e.g. a regular Yocto
70 build where ``bitbake`` can be executed.
71
72#. Run::
73
74 $ bitbake meta-ide-support
75 $ bitbake -c populate_sysroot gtk+3
76 # or any other target or native item that the application developer would need
77 $ bitbake build-sysroots
78
79Setting up the Extensible SDK from a standalone installer
80---------------------------------------------------------
81
82The first thing you need to do is install the SDK on your :term:`Build 44The first thing you need to do is install the SDK on your :term:`Build
83Host` by running the ``*.sh`` installation script. 45Host` by running the ``*.sh`` installation script.
84 46
@@ -172,12 +134,7 @@ Running the Extensible SDK Environment Setup Script
172=================================================== 134===================================================
173 135
174Once you have the SDK installed, you must run the SDK environment setup 136Once you have the SDK installed, you must run the SDK environment setup
175script before you can actually use the SDK. 137script before you can actually use the SDK. This setup script resides in
176
177When using a SDK directly in a Yocto build, you will find the script in
178``tmp/deploy/images/qemux86-64/`` in your :term:`Build Directory`.
179
180When using a standalone SDK installer, this setup script resides in
181the directory you chose when you installed the SDK, which is either the 138the directory you chose when you installed the SDK, which is either the
182default ``poky_sdk`` directory or the directory you chose during 139default ``poky_sdk`` directory or the directory you chose during
183installation. 140installation.
@@ -195,11 +152,6 @@ script is for an IA-based target machine using i586 tuning::
195 SDK environment now set up; additionally you may now run devtool to perform development tasks. 152 SDK environment now set up; additionally you may now run devtool to perform development tasks.
196 Run devtool --help for further details. 153 Run devtool --help for further details.
197 154
198When using the environment script directly in a Yocto build, it can
199be run similarly::
200
201 $ source tmp/deploy/images/qemux86-64/environment-setup-core2-64-poky-linux
202
203Running the setup script defines many environment variables needed in order to 155Running the setup script defines many environment variables needed in order to
204use the SDK (e.g. ``PATH``, :term:`CC`, :term:`LD`, and so forth). If you want 156use the SDK (e.g. ``PATH``, :term:`CC`, :term:`LD`, and so forth). If you want
205to see all the environment variables the script exports, examine the 157to see all the environment variables the script exports, examine the
@@ -1219,19 +1171,6 @@ You can use the following command to find out::
1219Once you know the recipe 1171Once you know the recipe
1220(i.e. ``mesa`` in this example), you can install it. 1172(i.e. ``mesa`` in this example), you can install it.
1221 1173
1222When using the extensible SDK directly in a Yocto build
1223-------------------------------------------------------
1224
1225In this scenario, the Yocto build tooling, e.g. ``bitbake``
1226is directly accessible to build additional items, and it
1227can simply be executed directly::
1228
1229 $ bitbake mesa
1230 $ bitbake build-sysroots
1231
1232When using a standalone installer for the Extensible SDK
1233--------------------------------------------------------
1234
1235:: 1174::
1236 1175
1237 $ devtool sdk-install mesa 1176 $ devtool sdk-install mesa