| <HTML> |
| <HEAD> |
| <TITLE>Contributing JUnit Tests to the Eclipse Build</TITLE> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> |
| </HEAD> |
| |
| <BODY BGCOLOR="#FFFFFF" TEXT="#000000"> |
| <P><B>Contributing JUnit Plug-in Tests to Builds</B></P><P>Last updated: August |
| 30, 2004<BR><BR>1. The tests need to be contributed as one or more plugins that |
| use the <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.test/testframework.html?rev=HEAD&content-type=text/html">org.eclipse.test</a> |
| automated testing framework.<BR><IMG SRC="new.gif" WIDTH="31" HEIGHT="14"> JUnit |
| tests can also be written as performance tests. Click <A HREF="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.test.performance/doc/Performance%20Tests%20HowTo.html">here</A> |
| for the latest instructions.<br> <br> 2. Get PMC approval to create the new plugins |
| projects on dev.eclipse.org:/cvsroot/eclipse. Once the projects are created, proceed |
| to the next step.<br> <br> 3. Send a request for commit rights to the org.eclipse.releng |
| project on dev.eclipse.org:/cvsroot/eclipse. Check out org.eclipse.releng from dev.eclipse.org:/cvsroot/eclipse |
| and create a new file with a .map extension or use an existing to add entries |
| for the new test plug-ins. Click <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.releng.basebuilder/readme.html?rev=HEAD&content-type=text/html#createmap">here</a> |
| for a description of the format used in the map files.<br> <br> 4. Install the |
| <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-releng-home/dev.html?rev=HEAD&content-type=text/html">org.eclipse.releng.tools</a> |
| plug-in, and use the "Release" action in the context menu of the test |
| plug-in project to update and commit map file.<br> <br> 5. Send a request to platform-releng-dev@eclipse.org |
| to add the test plugins to the build process. Include the following information:</P><ul> |
| <li> the plug-in ids.</li><li>the plug-ins that contain a test.xml</li><li> additional |
| steps to setup the tests outside of installing the test plugins and framework |
| in an Eclipse SDK.</li></ul><p>The Eclipse release engineering team will update |
| the appropriate feature and scripts to build and run the new tests.</p><P><B>Example |
| (with UI): </B><a href="http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ui.tests/">http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ui.tests/<br> |
| </a><b>Example (headless): </b><a href="http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ant.tests.core/">http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ant.tests.core/</a></P><P><B><br> |
| <a name="performance"></a>Performance Monitoring and JUnit Testing</B><br></P><P>Click |
| <A HREF="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.test.performance/doc/Performance%20Tests%20HowTo.html">here</A> |
| for the latest instructions on writing and contributing performance tests to the |
| builds.<BR></P> |
| </BODY> |
| </HTML> |