Author: eric
Date: Tue Jun 14 12:40:48 2011
New Revision: 1135532
URL: http://svn.apache.org/viewvc?rev=1135532&view=rev
Log:
Tutorial to build James from Netbeans IDE - Tks to Ioan (JAMES-1270)
Added:
james/server/trunk/src/site/resources/images/netbeans/
james/server/trunk/src/site/resources/images/netbeans/james-build-dir.png
(with props)
james/server/trunk/src/site/resources/images/netbeans/netbeans-james-project.png
(with props)
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout-browse.png
(with props)
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout1.png
(with props)
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout2.png
(with props)
Modified:
james/server/trunk/src/site/xdoc/dev-build.xml
Added: james/server/trunk/src/site/resources/images/netbeans/james-build-dir.png
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/netbeans/james-build-dir.png?rev=1135532&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
james/server/trunk/src/site/resources/images/netbeans/james-build-dir.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
james/server/trunk/src/site/resources/images/netbeans/netbeans-james-project.png
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/netbeans/netbeans-james-project.png?rev=1135532&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
james/server/trunk/src/site/resources/images/netbeans/netbeans-james-project.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout-browse.png
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout-browse.png?rev=1135532&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout-browse.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout1.png
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout1.png?rev=1135532&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout1.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout2.png
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout2.png?rev=1135532&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
james/server/trunk/src/site/resources/images/netbeans/netbeans-svn-checkout2.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: james/server/trunk/src/site/xdoc/dev-build.xml
URL:
http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/dev-build.xml?rev=1135532&r1=1135531&r2=1135532&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/dev-build.xml (original)
+++ james/server/trunk/src/site/xdoc/dev-build.xml Tue Jun 14 12:40:48 2011
@@ -105,7 +105,7 @@
<p>You now need to import the maven projects in the Eclipse
workspace.</p>
<p>Therefore, click on the <code>File</code> menu and select
<code>Import</code>.
Choose <code>Existing Maven Project</code> and click on
<code>Next</code> button.</p>
- <img src="./images/eclipse/eclipse-import-maven-view-1.gif" width="300"/>
+ <img src="./images/eclipse/eclipse-import-maven-view-1.gif"/>
</subsection>
@@ -127,8 +127,8 @@
</div>
</div>
</p>
-
- <img src="./images/eclipse/eclipse-import-maven-view-2.gif" width="300"/>
+ <br/>
+ <img src="./images/eclipse/eclipse-import-maven-view-2.gif"/>
<p>You can also import other projects from
<a href="http://james.apache.org/imap/source-code.html";>imap</a>,
@@ -142,7 +142,7 @@
<p>Check that 'Workspace resolution' is enable in m2eclipse plugin.</p>
<p>Your changes in code will be directly taken into account.</p>
- <img src="./images/eclipse/eclipse-m2eclipse-project-dependencies.gif"
width="300"/>
+ <img src="./images/eclipse/eclipse-m2eclipse-project-dependencies.gif"/>
</subsection>
@@ -159,14 +159,14 @@
from <code>container-spring\src\main\config\james</code> folder to
a <code>conf</code> folder
(<code>conf</code> folder must be a sub-folder of the
JAMES_SRC_HOME directory where you made the check-out).</li>
</ol>
- <img src="./images/eclipse/eclipse-m2eclipse-projects.gif" width="300"/>
+ <img src="./images/eclipse/eclipse-m2eclipse-projects.gif"/>
</subsection>
<subsection name="Run James from Eclipse">
<p>That's it. Run or Debug James in Eclipse (right-click on the Main
class) and Have Fun!.</p>
- <img src="./images/eclipse/eclipse-run-james.gif" width="300"/>
+ <img src="./images/eclipse/eclipse-run-james.gif"/>
<p>If you change a JPA Entity class, your will need to run 'mvn package'
or add the following option to your run configuration
@@ -177,6 +177,49 @@
</section>
+ <section name="Build James from NetBeans">
+
+ <p>This was done using NetBeans 7, which comes bundeled with Maven 3,
needed to build James 3.
+ Older versions of NetBeans should be able to build James fine, provided
that you configure them to use an instance of Maven 3, if they do not have it.
+ I used james 3.0-beta1 release and it builded in 7:40 min on my notebook
running Debian Squeeze.
+ </p>
+
+ <subsection name="Getting the sources from the repository">
+ <p>Building James with NetBeans is very easy as it comes with
Subersion and Maven support already build in.
+ Maven is bundeled with the IDE, but Subverion is not, so you will
have to install Subversion yourself and NetBeans will be able to use it.
+ You can get more details on how to install and where to get
Subversion from the NetBeans Help menu by clicking on <strong>Help
Contents</strong> and from there go to the <strong>IDE Basics->Version Control
and File Hierarchy->Subversion</strong> topic.
+ </p>
+ <p>For Linux users, Subversion is probably packaged by your
distribution so use your distribution tools to install it (aptitude, yum,
etc.)</p>
+ <p>Once you have Subversion, go to
<strong>Team->Subversion->Checkout</strong> menu entry. <br/>
+ You will see an dialog window used to enter the information about
the Subversion repository you are going to use. It looks like this:
+ <img src="./images/netbeans/netbeans-svn-checkout1.png"/>. <br/>
+ In the <code>Repository URL</code> field enter the location for
James repository and click <code>Next</code>.
+ You can use the following URL to get the trunk or developement
version:
+ <a
href="http://svn.apache.org/repos/asf/james/server/trunk";>http://svn.apache.org/repos/asf/james/server/trunk</a>.<br/>
+ After this you will be presented with another dialog window where
you can configure which folders to check out and where to save them on your
machine.
+ <img src="./images/netbeans/netbeans-svn-checkout2.png"/>. <br/>
+ If you supplied the above URL you can click <code>Finish</code> to
get trunk version and start hacking.
+ You can choose another folder by clicking <code>Browse</code>. A new
dialog window will open and from there you cand browse
+ the whole subversion repository. I wanted to build James 3.0beta so
I choosed <code>james-serve-3.0-beta1</code> under james/server/tags/ folder.
+ <img src="./images/netbeans/netbeans-svn-checkout-browse.png"/>.
<br/>
+ </p>
+ <p>After you click <code>Finish</code> NetBeans will checkout the
sources. It will detect the Maven project and ask you if you wish to open the
project.
+ If you open the project you will see in the Projects Window
(<code>CTRL+1</code> if not visible) something similar to the next image:<br/>
+ <img src="./images/netbeans/netbeans-james-project.png"/>.
+ </p>
+
+ </subsection>
+
+ <subsection name="Building the project">
+ <p> Building the project does not require too much work. Just go to
<code>Run->Build Project</code> menu option.
+ Make sure that James is the main project (if you have other projects
open) or NetBeans will build that project instead of James.
+ Once the build is finished you will find the binary distribution in
<code>container-spring/target</code> directory.
+ <img src="./images/netbeans/james-build-dir.png"/>. <br/>
+ </p>
+ </subsection>
+
+ </section>
+
<section name="Build James Source from other IDEs">
<p>We will be happy to include on this page any other tutorial you could
send
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org
