Eclipse - Subversion for Macs
Eclipse, an open development platform, can be used on Macintosh, Windows, and Linux operating systems in order to access files stored on Source Forge. However, an SVN plugin must be installed to properly configure Ecilpse to retrieve files from the AguaClara Source Forge Repository.
Note: This tutorial assumes that you already have a source forge account through forge.cornell.edu. If this is not the case please contact Alissa Diminich (mailto: alissa.diminich@gmail.com) and ask to be added to the AguaClara project in source forge.
The Eclipse Platform
Installing Eclipse
- Download Eclipse. Select Eclipse Classic 3.4.
- Unzip the downloaded file using a program like Zipeg.
- Drag the unziped folder into the Applications folder on your Mac.
Subclipse - SVN Plugin for Eclipse
Subclipse is an Eclipse Team Provider plug-in providing support for Subversion within the Eclipse IDE. The SVN plugin called Subclipse can be downloaded here. Just click on the link for Subeclipse which can be found on the left hand side under the heading of featured projects.
Installing the Subclipse Plugin
- At the Subclipse page select the zipped downloads link for Eclipse 3.2+.
- Download the first stable release listed. This download should yield a folder.
- Open this folder in one window and then open your Eclispe folder in a separate window. You should have two windows open. One containing plugin files and the other containing files for Eclispe.
- Click on the features folder found in the window with your plugin files, then drag the files within this folder into the corresponding features folder in the Eclipse Window.
- Repeat the step above with the plugins folder found in the window with your plugin files.
Accessing Files with Eclipse
Setting Up a Repository with Eclipse
- Open Eclipse by clicking on the circular Eclipse icon within the Eclipse folder.
Note: When opening Eclipse for the first time, you will be asked to designate a location for your workspace. Remember this location because this is where all your files and projects will be stored. - Go to the workbench within Eclipse. If you are at the welcome screen, the arrow to the far right will lead to the Workbench when clicked.
- Create a new project by going to File > New > Project. Select the SVN Folder from the list and click on this folder to access the Checkout projects from SVN option. Then click next.
- Choose the create a new repository location option on the next screen and insert the url of the repository of your choice. Then click next.
Note: A listing of current AguaClara repositories can be found here. - Select the folders within the repository of your choice that you wish to download to your computer. Hold down on shift to select multiple folders. Afterwards, click next and then Finish.
File Management with Eclipse
Modifying Files
- Open the file you wish to modify from where it is saved on your computer within the Eclipse workspace. Make changes and save the file on your computer.
- Find the file within the Workbench in the open Eclipse Application.
- Right click on the file and select Team > Commit.
- Select the files you wish to modify and click ok to modify the file in question.
Adding Files
- Add new files and folders to the project location in your workspace on your computer. i.e. Make changes to the files directly on your computer.
- Right click on the folder within your Workbench in Eclipse that holds the changes you have made. Go to Team > Update. The new files you wish to add should appear within Eclipse with question marks.
- Click on the folder containing the new files and select Team > Commit. You should be brought to a screen listing the files to be added.
- Select the files you wish to add to the repository and then click ok to add the new files.
Screen Shots