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

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

  1. Be sure your development system is not using OpenJDK to build the plug-in by doing the following:

    1. Use the Oracle JDK. If you don't have that, go to http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html and download the latest appropriate Java SE Development Kit tarball for your development system and extract it into your home directory.

    2. In the shell you are going to do your work, export the location of the Oracle Java. The previous step creates a new folder for the extracted software. You need to use the following export command and provide the specific location:

           export PATH=~/extracted_jdk_location/bin:$PATH
                                              

  2. In the same shell, create a Git repository with:

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

  3. Be sure to checkout the correct tag. For example, if you are using Luna, do the following:

         $ git checkout luna/yocto-2.2
                                    

    This puts you in a detached HEAD state, which is fine since you are only going to be building and not developing.

    Note

    If you are building kepler, checkout the kepler/yocto-2.2 branch.

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

         $ cd scripts
                                    

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

         $ ./setup.sh
                                    

  6. 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. Here is an example that uses the luna/yocto-2.2 tag, the master documentation branch, and tbd for the release name:

         $ ECLIPSE_HOME=/home/scottrif/eclipse-poky/scripts/eclipse ./build.sh luna/yocto-2.2 master tbd 2>&1 | tee -a build.log
                                    

    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 in step eight. 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 Yocto Project ADT Plug-in, Yocto Project Bitbake Commander Plug-in, and the 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 Eclipse Yocto Plug-in" section.