Wiki Markup |
---|
These instructions explain how to get the source code for Roller from Roller's Subversion repository, import it in to Eclipse and run it via an Eclipse launcher that starts Jetty and Derby. |
...
Prerequisites
These instructions assume you have these things already installed on your computer:
- Sun Java SE 1.6
- Subclipse Subversion client for Eclipse
- M2Eclipse Maven client for Eclipse
Checkout code from Subversion
Use the File->Import menu in Eclipse to start the Import, then choose the Checkout Projects from SVN option. (If you are wondering why we don't suggest using the "Check out Maven projects from SCM" option: it does not work. See this issue for MNGECLIPSE-2596 details.)
Choose the create new repository option
...
h1. Prerequisites These instructions assume you have these things already installed on your computer: * Sun Java SE 1.6 * Subclipse Subversion client for Eclipse * M2Eclipse Maven client for Eclipse h1. Checkout code from Subversion Use the File->Import menu in Eclipse to start the Import, then choose the Checkout Projects from SVN option. _(If you are wondering why we don't suggest using the "Check out Maven projects from SCM" option: it does not work. See this issue for [MNGECLIPSE-2596|https://issues.sonatype.org/browse/MNGECLIPSE-2596] details.)_ !roller-in-eclipse.key-0.jpg! Choose the create new repository option !roller-in-eclipse.key-1.jpg! Enter the URI of the Roller trunk, which is https://svn.apache.org/repos/asf/roller/trunk |
...
...
!roller-in-eclipse.key-2.jpg! Select the top-level element in the source |
...
Choose the Checkout as New Project in the work space:
Once you are done you should see the top-level Roller project in Eclipse
Import Maven projects
Use the File->Import menu again, and choose to Import Existing Maven Projects
Select all of the projects under the top-level one
When you are done, you'll see all of the Roller projects in Eclipse
Building and running Roller
To build all of the Roller code, right-click on the roller-project project, choose Run As and then choose "Maven install." If you change anything in a project, you'll have run Maven Install on the project before you attempt Roller.
The Eclipse Maven plugin can also run Roller for you and will start both the Jetty web service and the Derby database for Roller. To run Roller, use Eclipse's Run->Run Configurations to create a launcher for Roller. Create a new launcher under Maven Build, set these fields:
...
tree !roller-in-eclipse.key-3.jpg! Choose the Checkout as New Project in the work space: !roller-in-eclipse.key-4.jpg! Once you are done you should see the top-level Roller project in Eclipse !roller-in-eclipse.key-5.jpg! h1. Import Maven projects Use the File->Import menu again, and choose to Import Existing Maven Projects !roller-in-eclipse.key-6.jpg! Select all of the projects under the top-level one !roller-in-eclipse.key-7.jpg! When you are done, you'll see all of the Roller projects in Eclipse !roller-in-eclipse.key-8.jpg! h1. Building and running Roller To build all of the Roller code, right-click on the roller-project project, choose Run As and then choose "Maven install." If you change anything in a project, you'll have run Maven Install on the project before you attempt Roller. The Eclipse Maven plugin can also run Roller for you and will start both the Jetty web service and the Derby database for Roller. To run Roller, use Eclipse's Run->Run Configurations to create a launcher for Roller. Create a new launcher under Maven Build, set these fields: * Base directory: {preformatted}${workplace_loc:/roller-weblogger-webapp} |
...
{preformatted} * Goals: jetty:run |
...
Then you can use the Run button to start Roller.
...
!roller-in-eclipse.key-9.jpg! Then you can use the Run button to start Roller. Navigate to http://localhost:8080/roller |
...
and you'll find Roller up and running. |