*Authors: James Rutherford, Richard Jones, Stuart Lewis
*Version: 24th August 2009
...
Installing IDEA
This guide covers version 8.3 of IDEA, which you can get from here: http://www.jetbrains.com/idea/. Instructions for installing & running can be found on the website and in the readme file included with the download.
Creating a DSpace project from an SVN checkout
From the main window, click "Check out from Version Control", then "Subversion". When it prompts you for a repository, click the "+" icon and enter the URL for the DSpace subversion repository http://scm.dspace.org/svn/repo. Next, select "dspace" followed by "trunk" and click "checkout", and you will be prompted to choose a directory for the sources. Select your source, and on the next page ('SVN Checkout Options') elect how you wish the checkout to be structured ('Destination:'). Click OK and when prompted which SVN version to use, select the latest. The source will then be checked-out.
...
Code Block |
---|
Project Settings -> JDKs |
and add your JDK here
Building and installing DSpace for the first time
Go to the command line, and go to the root of your new project. Run:
...
- run
from this directory. You can do this in IDEA by right clickingCode Block ant fresh_install
, and selectingCode Block build.xml
. When the build file dialog opens, selectCode Block Add as Ant Build File
and hit the run button at the top of the panel.Code Block fresh_install
One-click maven builds
Go to "Run" -> "Edit configurations", then click the "+" icon and select maven.
...
built into it. You can do this using the quick launch from the IDEA tool bar: in the centre of the toolbar at the top is a pull-down menu which contains all your pre-configured run tasks. Select the one you have named "mvn clean package", and hit the green arrow to the right of it. You should see maven building your project in a window at the bottom of IDEA, and the content will be similar to when you ran it from the command line earlier.
Web Facets
At some point during the above installation process, IDEA may notify you of new web facets detected. These correspond to the individual WAR files and thus web applications which we are working on. If you do not confirm the detection of these facets straight away, they will be available on the bottom left of the screen by clicking on the flashing gear/cog.
...
In the dialog, select "Accept".
Deploying DSpace
The next step in getting fully integrated with this IDE is to set it up with ant and tomcat. First, set up ant by clicking the "Ant build" icon on the right. If you used Ant to build DSpace above, then your previous configuration will remain. Otherwise, add a new one by clicking the "+" icon. Here, you need to select the
...
Once you have this set up, you can deploy DSpace, by selecting the tomcat deployment from the menu bar, and hitting the green play button next to it. Hit the play button on the opened dialog, and IDEA will deploy the applications at the context paths specified in this section.
Tips
If you leave the "run" dialog boxes open at the bottom, you have a quick way to re-run the build and deployment tasks. The maven build can be re-run by clicking the green icon that looks like ">>", and likewise for the ant + tomcat deployment, except you'll have to click "stop" first, and wait for tomcat to shut down.
Useful plugins
IDEA has loads of plugins available to install. A couple that may be useful are:
...