diff options
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-model.xml | 94 |
1 files changed, 27 insertions, 67 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 334ae16276..761ac982a5 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml | |||
@@ -749,12 +749,8 @@ | |||
749 | <para> | 749 | <para> |
750 | You can install the Eclipse Yocto Plug-in into the Eclipse | 750 | You can install the Eclipse Yocto Plug-in into the Eclipse |
751 | IDE one of two ways: use the Yocto Project's Eclipse | 751 | IDE one of two ways: use the Yocto Project's Eclipse |
752 | Update site to install the pre-built plug-in, or build and | 752 | Update site to install the pre-built plug-in or build and |
753 | install the plug-in from the latest source code. | 753 | install the plug-in from the latest source code. |
754 | If you do not want to permanently install the plug-in but | ||
755 | just want to try it out within the Eclipse environment, | ||
756 | you can import the plug-in project from the Yocto Project's | ||
757 | Source Repositories. | ||
758 | </para> | 754 | </para> |
759 | 755 | ||
760 | <section id='new-software'> | 756 | <section id='new-software'> |
@@ -807,10 +803,29 @@ | |||
807 | To install the Eclipse Yocto Plug-in from the latest | 803 | To install the Eclipse Yocto Plug-in from the latest |
808 | source code, follow these steps: | 804 | source code, follow these steps: |
809 | <orderedlist> | 805 | <orderedlist> |
810 | <listitem><para>Open a shell and create a Git | 806 | <listitem><para>Be sure your development system |
807 | is not using OpenJDK to build the plug-in | ||
808 | by doing the following: | ||
809 | <orderedlist> | ||
810 | <listitem><para>Use the Oracle JDK. | ||
811 | If you don't have that, go to | ||
812 | <ulink url='http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html'></ulink> | ||
813 | and download the appropriate tarball | ||
814 | for your development system and | ||
815 | extract it into your home directory. | ||
816 | </para></listitem> | ||
817 | <listitem><para>In the shell you are going | ||
818 | to do your work, export the location of | ||
819 | the Oracle Java as follows: | ||
820 | <literallayout class='monospaced'> | ||
821 | export PATH=~/jdk1.7.0_40/bin:$PATH | ||
822 | </literallayout></para></listitem> | ||
823 | </orderedlist></para></listitem> | ||
824 | <listitem><para>In the same shell, create a Git | ||
811 | repository with: | 825 | repository with: |
812 | <literallayout class='monospaced'> | 826 | <literallayout class='monospaced'> |
813 | $ git clone git://git.yoctoproject.org/eclipse-poky-kepler yocto-eclipse | 827 | $ cd ~ |
828 | $ git clone git://git.yoctoproject.org/eclipse-poky-kepler | ||
814 | </literallayout> | 829 | </literallayout> |
815 | <note> | 830 | <note> |
816 | If you are using Juno, the repository is | 831 | If you are using Juno, the repository is |
@@ -818,19 +833,19 @@ | |||
818 | <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename>. | 833 | <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename>. |
819 | </note> | 834 | </note> |
820 | For this example, the repository is named | 835 | For this example, the repository is named |
821 | <filename>~/yocto-eclipse</filename>. | 836 | <filename>~/eclipse-poky-kepler</filename>. |
822 | </para></listitem> | 837 | </para></listitem> |
823 | <listitem><para>Change to the directory where you | 838 | <listitem><para>Change to the directory where you |
824 | set up the Git repository: | 839 | set up the Git repository: |
825 | <literallayout class='monospaced'> | 840 | <literallayout class='monospaced'> |
826 | $ cd ~/yocto-eclipse | 841 | $ cd ~/eclipse-poky-kepler |
827 | </literallayout></para></listitem> | 842 | </literallayout></para></listitem> |
828 | <listitem><para>Be sure you are in the right branch | 843 | <listitem><para>Be sure you are in the right branch |
829 | for your Git repository. | 844 | for your Git repository. |
830 | For this release set the branch to | 845 | For this release set the branch to |
831 | <filename>&DISTRO_NAME;</filename>: | 846 | <filename>&DISTRO_NAME;</filename>: |
832 | <literallayout class='monospaced'> | 847 | <literallayout class='monospaced'> |
833 | $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME; | 848 | $ git checkout &DISTRO_NAME; |
834 | </literallayout></para></listitem> | 849 | </literallayout></para></listitem> |
835 | <listitem><para>Change to the | 850 | <listitem><para>Change to the |
836 | <filename>scripts</filename> | 851 | <filename>scripts</filename> |
@@ -857,7 +872,7 @@ | |||
857 | Here is an example that uses the | 872 | Here is an example that uses the |
858 | <filename>&DISTRO_NAME;</filename> branch: | 873 | <filename>&DISTRO_NAME;</filename> branch: |
859 | <literallayout class='monospaced'> | 874 | <literallayout class='monospaced'> |
860 | $ ECLIPSE_HOME=/home/scottrif/yocto-eclipse/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME; | 875 | $ ECLIPSE_HOME=/home/scottrif/eclipse-poky-kepler/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME; |
861 | </literallayout> | 876 | </literallayout> |
862 | After running the script, the file | 877 | After running the script, the file |
863 | <filename>org.yocto.sdk-<release>-<date>-archive.zip</filename> | 878 | <filename>org.yocto.sdk-<release>-<date>-archive.zip</filename> |
@@ -879,7 +894,7 @@ | |||
879 | </para></listitem> | 894 | </para></listitem> |
880 | <listitem><para>Click through the "Okay" buttons. | 895 | <listitem><para>Click through the "Okay" buttons. |
881 | </para></listitem> | 896 | </para></listitem> |
882 | <listitem><para>Check the box next to the new entry | 897 | <listitem><para>Check the boxes |
883 | in the installation window and complete | 898 | in the installation window and complete |
884 | the installation.</para></listitem> | 899 | the installation.</para></listitem> |
885 | <listitem><para>Restart the Eclipse IDE if | 900 | <listitem><para>Restart the Eclipse IDE if |
@@ -893,61 +908,6 @@ | |||
893 | "<link linkend='configuring-the-eclipse-yocto-plug-in'>Configuring the Eclipse Yocto Plug-in</link>" | 908 | "<link linkend='configuring-the-eclipse-yocto-plug-in'>Configuring the Eclipse Yocto Plug-in</link>" |
894 | section.</para> | 909 | section.</para> |
895 | </section> | 910 | </section> |
896 | |||
897 | <section id='yocto-project-source'> | ||
898 | <title>Importing the Plug-in Project into the Eclipse Environment</title> | ||
899 | |||
900 | <para> | ||
901 | Importing the Eclipse Yocto Plug-in project from the | ||
902 | Yocto Project source repositories is useful when you | ||
903 | want to try out the latest plug-in from the tip of | ||
904 | plug-in's development tree. | ||
905 | It is important to understand when you import the | ||
906 | plug-in you are not installing it into the Eclipse | ||
907 | application. | ||
908 | Rather, you are importing the project and just using it. | ||
909 | </para> | ||
910 | |||
911 | <para> | ||
912 | To import the plug-in project, follow these steps: | ||
913 | <orderedlist> | ||
914 | <listitem><para>Open a shell and create a Git | ||
915 | repository with: | ||
916 | <literallayout class='monospaced'> | ||
917 | $ git clone git://git.yoctoproject.org/eclipse-poky-kepler yocto-eclipse | ||
918 | </literallayout> | ||
919 | <note> | ||
920 | The Juno repository is located at | ||
921 | <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename> | ||
922 | </note> | ||
923 | For this example, the repository is named | ||
924 | <filename>~/yocto-eclipse</filename>. | ||
925 | </para></listitem> | ||
926 | <listitem><para>In Eclipse, select "Import" from | ||
927 | the "File" menu.</para></listitem> | ||
928 | <listitem><para>Expand the "General" box and select | ||
929 | "existing projects into workspace" and then | ||
930 | click "Next".</para></listitem> | ||
931 | <listitem><para>Select the root directory and | ||
932 | browse to | ||
933 | <filename>~/yocto-eclipse/plugins</filename>. | ||
934 | </para></listitem> | ||
935 | <listitem><para>Three plug-ins exist: | ||
936 | <filename>org.yocto.bc.ui</filename>, | ||
937 | <filename>org.yocto.sdk.ide</filename>, and | ||
938 | <filename>org.yocto.sdk.remotetools</filename>. | ||
939 | Select and import all of them.</para></listitem> | ||
940 | </orderedlist> | ||
941 | </para> | ||
942 | |||
943 | <para> | ||
944 | The left navigation pane in the Eclipse application | ||
945 | shows the default projects. | ||
946 | Right-click on one of these projects and run it as an | ||
947 | Eclipse application to bring up a second instance of | ||
948 | Eclipse IDE that has the Yocto Plug-in. | ||
949 | </para> | ||
950 | </section> | ||
951 | </section> | 911 | </section> |
952 | 912 | ||
953 | <section id='configuring-the-eclipse-yocto-plug-in'> | 913 | <section id='configuring-the-eclipse-yocto-plug-in'> |