Evgeny Mandrikov | 82a92ca | 2012-01-15 20:25:48 +0000 | [diff] [blame^] | 1 | <?xml version="1.0" encoding="ISO-8859-1" ?> |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| 3 | <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> |
| 4 | <head> |
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
| 6 | <link rel="stylesheet" href=".resources/doc.css" charset="ISO-8859-1" type="text/css" /> |
| 7 | <link rel="shortcut icon" href=".resources/report.gif" type="image/gif" /> |
| 8 | <title>JaCoCo - Development Environment</title> |
| 9 | </head> |
| 10 | <body> |
| 11 | |
| 12 | <div class="breadcrumb"> |
| 13 | <a href="../index.html" class="el_report">JaCoCo</a> > |
| 14 | <a href="index.html" class="el_group">Documentation</a> > |
| 15 | <span class="el_source">Development Environment</span> |
| 16 | </div> |
| 17 | <div id="content"> |
| 18 | |
| 19 | <h1>Development Environment</h1> |
| 20 | |
| 21 | <p> |
| 22 | With this version JaCoCo is hosted at |
| 23 | <a href="http://www.sourceforge.net/">SourceForge</a> as part of the |
| 24 | <a href="http://www.sourceforge.net/projects/eclemma">EclEmma project</a>. |
| 25 | This document provides an overview of the local and shared tools used for |
| 26 | JaCoCo development. |
| 27 | </p> |
| 28 | |
| 29 | <h3>IDE</h3> |
| 30 | |
| 31 | <p> |
| 32 | JaCoCo development is done with the latest Eclipse version 3.7.x. JaCoCo |
| 33 | projects are OSGi bundles, therefore the PDE feature is required. Project |
| 34 | specific Eclipse settings exist for the projects |
| 35 | </p> |
| 36 | |
| 37 | <ul> |
| 38 | <li><code>org.jacoco.core</code></li> |
| 39 | <li><code>org.jacoco.core.test</code></li> |
| 40 | </ul> |
| 41 | |
| 42 | <p> |
| 43 | All other projects and test projects link to these settings. |
| 44 | </p> |
| 45 | |
| 46 | <h3>JRE/JDK</h3> |
| 47 | |
| 48 | <p> |
| 49 | The minimum JRE version to execute JaCoCo is Java 1.5. However to guarantee |
| 50 | compatibility JaCoCo builds should only be executed against a 1.5 JDK. |
| 51 | </p> |
| 52 | |
| 53 | <h3>Build System</h3> |
| 54 | |
| 55 | <p> |
| 56 | The build is based on <a href="http://maven.apache.org/">Maven</a>. The |
| 57 | JaCoCo <a href="build.html">build</a> requires Maven 3. |
| 58 | </p> |
| 59 | |
| 60 | <h3>Third Party Dependencies</h3> |
| 61 | |
| 62 | <p> |
| 63 | JaCoCo has dependencies to the following third party bundles: |
| 64 | </p> |
| 65 | |
| 66 | <ul> |
| 67 | <li>Apache Ant 1.7.x</li> |
| 68 | <li>JUnit 4</li> |
| 69 | <li>Objectweb ASM 3.3.x</li> |
| 70 | </ul> |
| 71 | |
| 72 | <p> |
| 73 | These bundles are included with the Eclipse 3.7.x PDE feature and are not |
| 74 | part of the JaCoCo source tree. |
| 75 | </p> |
| 76 | |
| 77 | <h3>Source Control</h3> |
| 78 | |
| 79 | <p> |
| 80 | The JaCoCo source code is maintained in a subversion repository at |
| 81 | </p> |
| 82 | |
| 83 | <pre> |
| 84 | https://eclemma.svn.sourceforge.net/svnroot/eclemma/jacoco |
| 85 | </pre> |
| 86 | |
| 87 | <p> |
| 88 | You will find the latest version as several Eclipse projects in the |
| 89 | <code>trunk</code> folder. You might also browse the source code online via our |
| 90 | <a href="http://eclemma.svn.sourceforge.net/viewvc/eclemma/jacoco/">ViewVC</a> |
| 91 | or <a href="https://sourceforge.net/apps/trac/eclemma/browser/jacoco">Trac</a> |
| 92 | web interface. |
| 93 | </p> |
| 94 | |
| 95 | <h3>Planning</h3> |
| 96 | |
| 97 | <p> |
| 98 | A <a href="https://sourceforge.net/apps/trac/eclemma">Trac Instance</a> is |
| 99 | used for milestone planning and task tracking. |
| 100 | </p> |
| 101 | |
| 102 | <h3>Communication</h3> |
| 103 | |
| 104 | <p> |
| 105 | The development team communicates through a mailing list. The list is closed |
| 106 | for non-developers but the archive is |
| 107 | <a href="https://sourceforge.net/mailarchive/forum.php?forum_name=eclemma-jacoco-dev">public</a>. |
| 108 | Please use the <a href="support.html">support channels</a> to get in touch |
| 109 | with the development team. |
| 110 | </p> |
| 111 | |
| 112 | </div> |
| 113 | <div class="footer"> |
| 114 | <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> |
| 115 | <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors |
| 116 | </div> |
| 117 | |
| 118 | </body> |
| 119 | </html> |