| | {info}This Java developer guide will help you learn how to create Apatar project in Eclipse IDE. {info} |
| | |
| | h4. Pre-requirements |
| | |
| | * Eclipse IDE for Java EE Developers version 3.5.1 |
| | * Subversive plug-in for Eclipse installed (to enable working with SVN). [http://www.eclipse.org/subversive/] |
| | |
| | h4. Configuration |
| | |
| | 1. Start Eclipse and create a workspace |
| | |
| | !1.1.PNG! |
| | |
| | !1.2.PNG! |
| | |
| | 2. Open SVN Repository Exploring Perspective |
| | |
| | !2.PNG!\\ |
| | |
| | 3. Right-click in the SVN Repository Exploring tab and choose `New \-> Repository Location` to create a new link to repository |
| | |
| | !3.PNG! |
| | |
| | 4. In the `URL` field, enter [http://apatar.svn.sourceforge.net/svnroot/apatar/sourcecode_second/] |
| | Uncheck `Validate Repository Location on finish` to increase productivity |
| | |
| | !4.PNG!\\ |
| | |
| | 5. Right-click the `sourcecode` folder and select `Find/Check Out As...` |
| | |
| | !5.PNG!\\ |
| | |
| | 6. To create a project, select the options as below in the "Check out As" window (keep the default settings): |
| | |
| | !6.PNG! |
| | |
| | 7. Indicate that you are creating a `Java Project` and click `Next` |
| | |
| | !7.PNG! |
| | |
| |  | 8. The next window should have the following settings (you can enter any Project name that is convenient for you): |
| | |
| | {note}Apatar requires JRE 1.6 or higher{note} |
| | |
| | | 8. The next window should have the following settings (you can enter any Project name that is convenient for you):{note}Apatar requires JRE 1.6 or higher {note} |
| | !8.PNG! |
| | |
| | 9. At this screen, click `Yes`. |
| | |
| | !9.PNG! |
| | |
| | 10. Now you can start setting up the project. Right-click the project name and select `Properties` |
| | |
| | !10.PNG! |
| | |
| | 11. In the next window, select `Java Build Path`. Go to the `Source` tab and add folders with plug-ins source code by clicking the `Add Folder...` button |
| | |
| | !11.PNG! |
| | |
| | 12. Check all `src` folders in each plug-in within the `plugins` folder |
| | |
| | !12.PNG! |
| | |
| | 13. Check `Allow output folders for source folders`. For each plug-in, specify a desired folder for compiled files. All compiled files should be in `bin` folders in related plug-in folders, thus the path should be like `plugins/core/plug-in_name/bin` or `plugins/connectors/plug-in_name/bin` or `plugins/rich_ui_framework/plug-in_name/bin`. At this screen, select `Output folder: (Default output folder)` for each plug-in and click `Edit...` |
| | |
| | !13.PNG! |
| | |
| | 14. In the Source Folder Output Location window, select `Specific output folder (path relative to 'project_name')` and click `Browse` |
| | |
| | !14.PNG! |
| | |
| | 15. Select a plug-in and then click `Create New Folder...`. If a `bin` folder in a related plug-in folder already exists, you can select it, though if you found a `bin` folder, you are most likely in a wrong folder, as far as SVN doesn't create `bin` folders when creating a project. |
| | |
| | !15.PNG! |
| | |
| | 16. Enter `bin` in the `Folder name:` field |
| | |
| | !16.PNG! |
| | |
| | 17. Accordingly, Source Folder Output Location's screen should look something like this: |
| | |
| | !17.PNG! |
| | |
| | 18. Repeat steps 13-17 for each plug-in so that each plug-in folder contains a `bin` folder. |
| | |
| | 19. Below is an example of a project's set-up screen that appears after you set up source code location and folders for compiled files. Review the list and make sure there are no the `Output folder: (Default output folder)` lines. Each `Output folder: ` line should contain a specific path to a `bin` folder of a related plug-in. |
| | |
| | !19.PNG! |
| | |
| | 20. Now you can start setting up libraries at the `Libraries` tab to enable Eclipse compile the project. To add libraries, click `Add JARs...` |
| | |
| | !20.PNG! |
| | |
| | 21. In the `JAR Selection` window, choose libraries in the `lib` folder located in the project's root folder. To select all of the libraries, click the first element on the list, hold `Shift` or `Ctrl`, and then click the last element on the list. Select only JAR files. Confirm the selection by clicking `OK` |
| | |
| | !21.PNG! |
| | |
| | 22. Now you should add libraries from a `lib` folder of each plug-in that has such a folder. |
| | |
| | !22.1.PNG! |
| | |
| | !22.2.PNG! |
| | |
| | 23. Eclipse keeps track of the libraries that have already been added, so next time you click `Add JARs...`, the `JAR Selection` screen will contain fewer folders. The main task is that this window should be empty when you are done with adding libraries. |
| | |
| | !23.PNG! |
| | |
| | 24. In the screenshot below, you can see an example of how Eclipse should look like when you are done with project set-up. |
| | |
| | !24.PNG! |
| | |
 | | 25. Now you should configure the application start-up in Eclipse. Click the button and select `Open Run Dialog...` (`Open Run Dialog...` can also be found in the main menu of Eclipse.) |
| | | 25. Now you should configure the application start-up in Eclipse. Click the button and select `Run Configurations...` (`Run Configurations...` can also be found in the main menu of Eclipse.) |
| | |
| | !25.PNG! |
| | |
| | 26. In the Run window, right-click `Java Application` and select `New` |
| | |
| | !26.PNG! |
| | |
| | 27. The folowing screenshot explains how the main panel of the `Run` window will look like. At the `Main` tab, enter `org.java.plugin.boot.Boot` to the `Main class` field |
| | |
| | !27.PNG! |
| | |
| | 28. At the `Arguments` tab, enter `debug="true"` in the `Program arguments` field, and enter `-Djpf.boot.config="boot1.properties"` in the `VM arguments` field |
| | |
| | !28.PNG! |
| | |
| | 29. Now you should create a folder to store logs. Right-click the project's title and select `New` \-> `Folder` |
| | |
| | !29.PNG! |
| | |
| | 30. In the `New Folder` window, enter `logs` in the `Folder name` field and click `Finish` |
| | |
| | !30.PNG! |
| | |
| | Now you are ready to work with Apatar. |