From 052c49367b4d63e411f5b30f99290c2f831e7523 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 13 Jun 2018 14:14:16 -0700 Subject: sdk-manual: Edits to the Oxygen section Found several items that were slightly off after working through the procedure. Updates to bring it into line with reality. (From yocto-docs rev: 0f34afe3c37dedda28a1a5714703787a5dfe649d) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/sdk-manual/sdk-eclipse-project.xml | 120 ++++++++++++----------- 1 file changed, 64 insertions(+), 56 deletions(-) (limited to 'documentation/sdk-manual') diff --git a/documentation/sdk-manual/sdk-eclipse-project.xml b/documentation/sdk-manual/sdk-eclipse-project.xml index 5ad9c45ae7..c45d0874af 100644 --- a/documentation/sdk-manual/sdk-eclipse-project.xml +++ b/documentation/sdk-manual/sdk-eclipse-project.xml @@ -19,8 +19,8 @@ The following figure and supporting list summarize the - application development general workflow that employs both the - SDK Eclipse. + general workflow for application development that uses the + SDK within the Eclipse IDE. @@ -259,15 +259,17 @@ Install the Software: - Accept the default "cpp-oxygen" directory and - click "Install". - Accept any license agreements and approve any - certificates. + Click "Install" to begin the installation. + Accept all the certificates and any license + agreements. + Click "Install" again to finish the installation. Launch Oxygen: - Click the "Launch" button and accept the - default "workspace". + Accept the default "workspace" and click the + "Launch" button. + You should see the Eclipse welcome page from which + can click "workbench" to enter your workspace. @@ -278,17 +280,29 @@ Follow these steps to configure the Oxygen Eclipse IDE. - - Depending on how you installed Eclipse and what - you have already done, some of the options will - not appear. - If you cannot find an option as directed by the - manual, it has already been installed. + Notes + + + Depending on how you installed Eclipse and what + you have already done, some of the options will + not appear. + If you cannot find an option as directed by the + manual, it has already been installed. + + + If you want to see all items regardless of + whether they are installed or not, deselect the + "Hide items that are already installed" + check box. + + Be sure Eclipse is running and you are in your workbench. + Just click "workbench" if you are not in your + default workspace. Select "Install New Software" from the "Help" @@ -341,7 +355,7 @@ You can install the Eclipse Yocto Plug-in into the Eclipse IDE one of two ways: use the Yocto Project's - Eclipse Update site to install the pre-built plug-in + Eclipse Update site to install the pre-built plug-in, or build and install the plug-in from the latest source code. @@ -370,12 +384,10 @@ name in the "Name" field. - Click "OK" to have the entry added - to the "Work with:" drop-down list. - - - Select the entry for the plug-in - from the "Work with:" drop-down list. + Click "OK" to have the entry automatically + populate the "Work with:" field and to have + the items for installation appear in the window + below. Check the boxes next to the following: @@ -407,8 +419,13 @@ latest source code, follow these steps: - Be sure your development system - has JDK 1.8+ + Be sure your build host has JDK version 1.8 + or greater. + On a Linux build host you can determine the + version using the following command: + + $ java -version + Install X11-related packages: @@ -428,12 +445,12 @@ Use Git to create the correct tag: $ cd ~/eclipse-yocto - $ git checkout -b oxygen/yocto-&DISTRO; remotes/origin/oxygen-master + $ git checkout -b oxygen/&DISTRO_NAME_NO_CAP; remotes/origin/oxygen/&DISTRO_NAME_NO_CAP; This creates a local tag named - oxygen/yocto-&DISTRO; + oxygen/&DISTRO_NAME_NO_CAP; based on the branch - origin/oxygen-master. + origin/oxygen/&DISTRO_NAME_NO_CAP;. You are put into a detached HEAD state, which is fine since you are only going to be building and not developing. @@ -467,11 +484,11 @@ Following is an example: - $ ECLIPSE_HOME=/home/scottrif/eclipse-yocto/scripts/eclipse ./build.sh -l oxygen/yocto-&DISTRO; master yocto-&DISTRO; 2>&1 | tee build.log + $ ECLIPSE_HOME=/home/scottrif/eclipse-yocto/scripts/eclipse ./build.sh -l oxygen/&DISTRO_NAME_NO_CAP; master yocto-&DISTRO; 2>&1 | tee build.log The previous example command adds the tag you need for - oxygen/yocto-&DISTRO; + oxygen/&DISTRO_NAME_NO_CAP; to HEAD, then tells the build script to use the local (-l) Git checkout for the build. @@ -553,7 +570,7 @@ To start, you need to do the following from within the Eclipse IDE: - + Choose "Preferences" from the "Window" menu to display the Preferences Dialog. @@ -562,7 +579,7 @@ Click "Yocto Project SDK" to display the configuration screen. - + The following sub-sections describe how to configure the plug-in. @@ -784,7 +801,7 @@ - Click the "Apply" and "OK" to save your plug-in + Click "Apply and Close" to save your plug-in configurations. @@ -822,17 +839,15 @@ click "Next". - Expand - Yocto Project SDK Autotools Project. + Expand "Yocto Project SDK Autotools Project". - Select Hello World ANSI C Autotools Projects. + Select "Hello World ANSI C Autotools Projects". This is an Autotools-based project based on a Yocto template. - Put a name in the - Project name: field. + Put a name in the "Project name:" field. Do not use hyphens as part of the name (e.g. hello). @@ -886,21 +901,15 @@ Make or verify your configurations for the - project and click "OK". + project and click "Apply and Close". - Right-click in the navigation pane and - select "Reconfigure Project" from the pop-up menu. + Right-click in the navigation pane and select + "Reconfigure Project" from the pop-up menu. This selection reconfigures the project by running - autogen.sh in the workspace - for your project. - The script also runs - libtoolize, - aclocal, - autoconf, - autoheader, - automake --a, and - ./configure. + Autotools GNU utility programs + such as Autoconf, Automake, and so forth in the + workspace for your project. Click on the "Console" tab beneath your source code to see the results of reconfiguring your project. @@ -914,7 +923,8 @@ To build the project select "Build All" from the "Project" menu. The console should update and you can note the - cross-compiler you are using. + cross-compiler you are using (i.e. + i586-poky-linux-gcc in this example). When building "Yocto Project SDK Autotools" projects, the Eclipse IDE might display error messages for @@ -934,8 +944,9 @@ File > New menu. - In the "New Folder" Dialog, select "Link to - alternate location (linked folder)". + In the "New Folder" Dialog, click the "Advanced" + button and then activate "Link to + alternate location (linked folder)" button. Click "Browse" to navigate to the include @@ -943,9 +954,6 @@ selected in the Yocto Project configuration preferences. - - Click "OK". - Click "Finish" to save the linked folder. @@ -988,8 +996,8 @@ rpcbind, follow the suggestions to get the service running. As an example, on a new Ubuntu 16.04 LTS - installation, you must do the following in - order to get QEMU to launch: + installation, you must do the following in a new + shell in order to get QEMU to launch: $ sudo apt-get install rpcbind -- cgit v1.2.3-54-g00ecf