4.3.2.1.3.2. Installing the Plug-in Using the Latest Source Code

To install the Neon Eclipse Yocto Plug-in from the latest source code, follow these steps:

  1. Be sure your development system has JDK 1.8+

  2. Install X11-related packages:

         $ sudo apt-get install xauth
                                        

  3. In a new terminal shell, create a Git repository with:

         $ cd ~
         $ git clone git://git.yoctoproject.org/eclipse-poky
                                        

  4. Use Git to create the correct tag:

         $ cd ~/eclipse-poky
         $ git checkout neon/yocto-2.3
                                        

    This creates a local tag named neon/yocto-2.3 based on the branch origin/neon-master. You are put into a detached HEAD state, which is fine since you are only going to be building and not developing.

  5. Change to the scripts directory within the Git repository:

         $ cd scripts
                                        

  6. Set up the local build environment by running the setup script:

         $ ./setup.sh
                                        

    When the script finishes execution, it prompts you with instructions on how to run the build.sh script, which is also in the scripts directory of the Git repository created earlier.

  7. Run the build.sh script as directed. Be sure to provide the tag name, documentation branch, and a release name.

    Following is an example:

         $ ECLIPSE_HOME=/home/scottrif/eclipse-poky/scripts/eclipse ./build.sh -l neon/yocto-2.3 master yocto-2.3 2>&1 | tee build.log
                                        

    The previous example command adds the tag you need for mars/yocto-2.3 to HEAD, then tells the build script to use the local (-l) Git checkout for the build. After running the script, the file org.yocto.sdk-release-date-archive.zip is in the current directory.

  8. If necessary, start the Eclipse IDE and be sure you are in the Workbench.

  9. Select "Install New Software" from the "Help" pull-down menu.

  10. Click "Add".

  11. Provide anything you want in the "Name" field.

  12. Click "Archive" and browse to the ZIP file you built earlier. This ZIP file should not be "unzipped", and must be the *archive.zip file created by running the build.sh script.

  13. Click the "OK" button.

  14. Check the boxes that appear in the installation window to install the following:

         Yocto Project SDK Plug-in
         Yocto Project Documentation plug-in
                                        

  15. Finish the installation by clicking through the appropriate buttons. You can click "OK" when prompted about installing software that contains unsigned content.

  16. Restart the Eclipse IDE if necessary.

At this point you should be able to configure the Eclipse Yocto Plug-in as described in the "Configuring the Neon Eclipse Yocto Plug-in" section.