File: http://svn.ist-palcom.org/svn/palcom/doc/setup/Eclipse-SVN.txt 1. Eclipse SVN Plugin --------------------- To use SVN from within Eclipse you have to manually install a plugin for this. The suggested plugin is found at http://subclipse.tigris.org/ To install it, inside Eclipse do this (Eclipse 3.4 instructions): a. Select Help->Software updates... (meaning: In menu "Help", select item "Software updates") b. Select the tab "Available Software" c. Click "Add Site..." d. Enter URL http://subclipse.tigris.org/update_1.4.x, press OK e. Make sure "Subclipse" is checked. Click "Install..." f. On the page "Install" let all items be selcted. Click Next. g. Accept the license and click "Finish". Eclipse will suggest restarting. 2. Checking out "palcom" and importing Eclipse Projects. -------------------------------------------------------- The SVN file structure of the PalCom toolbox does not follow the (flat) directory structure preferred by Eclipse projects. For this reason, you need to perform a few extra steps to establish the Eclipse projects contained within the SVN Repository. We here describe some alternative ways to do this. 2.1. Checking out "palcom" and importing There are (at least) two ways to check out the full source tree. These alternatives are described in 2.1.1 and 2.1.2. After having done one of these, you continue with the import described in 2.1.3, after which you should check your settings as described in Eclipse-build.txt. 2.1.1 Checking out "palcom" with command line You can start by checking out the full main trunk of "palcom" using command line svn as described in Palcom-SVN.txt. Then go directly to 2.1.3 below. 2.1.2 Checking out "palcom" from within Eclipse You can use Eclipse to check out "palcom". A. First change your workspace to a directory where you check out the palcom source tree: File->Switch Workspace... We suggest that you name the workspace directory "palcom-checkout". B. Set up the SVN Repository location. Change Perspective to the SVN Repository Exploring perspective (Window->Open Perspective->Other...->SVN Repository Exploring). Right click in the empty part the left pane "SVN Repository", and select New->Repository Location... Specify the URL http://svn.ist-palcom.org/svn/palcom/trunk The plugin will ask for your SVN username and password. If you are a registered PalCom developer, use your assigned username and password. Otherwise, enter username "anon" and password "anon" for read-only access (without commit rights). C. Now right-click on this new location in the left pane and choose "Checkout" from the menu. Choose "Check out as a project in the workspace" and name the project "palcom". Click Finish. After the download has finished, if you switch to the Resource view, you will see a project called "palcom". D. Switch to another workspace where you import the PalCom Eclipse projects: File->Switch Workspace... We suggest "palcom-projects" as the workspace directory name. Then go to section 2.1.3. Here you should use the "palcom-checkout" location to import from. Later, you can go back to "palcom-checkout" for updating from the repositiory. 2.1.3 Importing Eclipse projects from a full "palcom" checkout You should first have checked out the full SVN tree using one of the methods described in 2.1.1 or 2.1.2. For users that have checked out the palcom tree using anonymous checkout, extra steps are needed before the import of all projects, as described in Section 2.1.3.1. If you have checked out with a PalCom username and password, please proceed to 2.1.3.2. 2.1.3.1 Extra steps for anonymous checkouts a) In Eclipse open File->Import...->General->Existing Projects Into Workspace. Click Next. b) Click Browse. Go to palcom/developer/dev-lib in the checked-out tree. c) The single project dev-lib will be listed. Let it be checked and click Finish. d) When a dialog asking for username and password appears, click Cancel. e) Right-click on the dev-lib project, choose Team->Share Project... f) Select SVN and click Next. g) Eclipse will say that the project is already configured with SVN repository information. Click Finish. h) In the Username and Password dialog, click Cancel. i) In the dialog Unable to Validate, select Yes for "Set project sharing anyway". j) Proceed with the import of all projects as described in 2.1.3.2. 2.1.3.2 Importing all projects In Eclipse open File->Import...->General->Existing Projects Into Workspace Using the Browse button you navigate to the "developer" directory in your "palcom" checkout. Then make sure the correct projects are found and checked on the list presented, and press Finish. It is safe to import all the listed projects. After the import, automatic builders will be triggered for some projects. When they have finished, some errors will remain. Please see Eclipse-build.txt for information about how to perform the final build step manually. After the import, there will be many projects (more than 40). Many of those contain specific services, implemented for different scenarios. Such projects are shown with "[trunk/developer/application-layer..." in the Package Explorer. If you are mainly interested in the framework for implementing new services, you can remove those as follows: right-click on the project and choose Delete. Let "Do not delete contents" be checked, and click Yes. (There are a few cases where projects outside application-layer depend on projects in application-layer. If you remove such a project, there will be errors in the Problems view. If that happens, re-import the project, or delete the project with errors if you do not need it.)