diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index 764f808e7e..75d4d146b6 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml @@ -53,10 +53,12 @@ Once you have downloaded the tarball, extract it into a clean directory. - For example, the following command unpacks and installs the Eclipse IDE + For example, the following commands unpack and install the Eclipse IDE + tarball found in the Downloads area into a clean directory using the default name eclipse: - $ tar -xzvf ~/Downloads/Eclipse-SDK-3.7-linux-gtk-x86_64.tar.gz + $ cd ~ + $ tar -xzvf ~/Downloads/eclipse-SDK-3.7.1-linux-gtk-x86_64.tar.gz @@ -138,30 +140,36 @@
- Installing the Eclipse Yocto Plug-in + Installing or Accessing the Eclipse Yocto Plug-in - You can install the Eclipse Yocto Plug-in one of three methods: as new software - from within the Eclipse IDE, from the Yocto Project source repositories, or as a built zip file. + You can install the Eclipse Yocto Plug-in into the Eclipse application + one of two ways: using the Eclipse IDE and installing the plug-in as new software, or + using a built zip file. + If you don't want to permanently install the plug-in but just want to try it out + within the Eclipse environment, you can import the plug-in project from the + Yocto Project source repositories.
- New Software + Installing the Plug-in as New Software - To install the Eclipse Yocto Plug-in directly into the Eclipse IDE, + To install the Eclipse Yocto Plug-in as new software directly into the Eclipse IDE, follow these steps: Start up the Eclipse IDE. In Eclipse, select "Install New Software" from the "Help" menu. Click "Add..." in the "Work with:" area. Enter - http://www.yoctoproject.org/downloads/eclipse-plugin/1.1 + http://downloads.yoctoproject.org/releases/eclipse-plugin/1.1 in the URL field and provide a meaningful 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. + Check the box next to Development tools and SDKs for Yocto Linux. + Complete the remaining software installation steps and then restart the Eclipse IDE to finish the installation of the plug-in. @@ -169,46 +177,8 @@
- -
- Yocto Project Source - - - To install the Eclipse Yocto Plug-in from the Yocto Project source repositories, - follow these steps: - - Open a shell and create a Git repository with: - - $ git clone git://git.yoctoproject.org/eclipse-poky yocto-eclipse - - For this example, the repository is named - ~/yocto-eclipse. - In Eclipse, select "Import" from the "File" menu. - Expand the "General" box and pick "existing projects into workspace". - - Select the root directory and browse to "~/yocto-eclipse/plugins". - - There will be three things there. - Select each one and install one at a time. - Do all three. - Restart everything. - - - - - At this point you should be able to invoke Eclipse from the shell using the following: - - $ cd ~/eclipse - $ ./eclipse -vmargs -XX:PermSize=256M - - The left navigation pane shows the default projects. - Right-click on one of these projects and run it as an Eclipse application. - This brings up a second instance of Eclipse IDE that has the Yocto Plug-in. - -
-
- Zip File Method + Installing the Plug-in from a Zip File To install the Eclipse Yocto Plug-in by building and installing a plug-in zip file, follow these steps: @@ -247,22 +217,57 @@ Click "Add". Provide anything you want in the "Name" field. - For the "Archive" field, select the ZIP file you built in step - 4. + Click "Archive" and browse to the ZIP file you built + in step four. This ZIP file should not be "unzipped", and must be the *archive.zip file created by running the build.sh script. - Select the new entry in the installation window and complete + Check the box next to the new entry in the installation window and complete the installation. Restart the Eclipse IDE if necessary. - At this point you should be able to configure the Eclipse Yocto Plug-in as described in - the next section. + 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. +
+ +
+ Importing the Plug-in Project into the Eclipse Environment + + Importing the Eclipse Yocto Plug-in project from the Yocto Project source repositories + is useful when you want to try out the latest plug-in from the tip of plug-in's + development tree. + It is important to understand when you import the plug-in you are not installing + it into the Eclipse application. + Rather, you are importing the project and just using it. + To import the plug-in project, follow these steps: + + Open a shell and create a Git repository with: + + $ git clone git://git.yoctoproject.org/eclipse-poky yocto-eclipse + + For this example, the repository is named + ~/yocto-eclipse. + In Eclipse, select "Import" from the "File" menu. + Expand the "General" box and select "existing projects into workspace" + and then click "Next". + Select the root directory and browse to "~/yocto-eclipse/plugins". + + There will be three things there. + Select each one and install one at a time. + Do all three. + + + + + The left navigation pane in the Eclipse application shows the default projects. + Right-click on one of these projects and run it as an Eclipse application. + This brings up a second instance of Eclipse IDE that has the Yocto Plug-in. -
+