| <html><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link type="text/css" href="../../../default_style.css" rel="stylesheet"><link type="text/css" href="../../../webtools/wtp.css" rel="stylesheet"><title>Eclipse API Scanner</title></head><body><table border="0" cellpadding="2" cellspacing="5" width="100%"><tbody><tr><td align="left" width="60%"><font class="indextop">Eclipse API Scanner</font><br><font class="indexsub">Eclipse API Scanner</font></td><td width="40%"><img src="../../../webtools/images/wtplogosmall.jpg" align="middle" height="129" hspace="50" width="207" alt="WTP Logo" usemap="logomap"><map id="logomap" name="logomap"><area coords="0,0,207,129" href="/webtools/" alt="WTP Home"></map></td></tr></tbody></table><table border="0" cellpadding="2" cellspacing="5" width="100%"><col width="16"><col width="*"><tbody><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><em>Updated 2005-02-07</em></td></tr><tr><td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Introduction</font></b></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p> |
| This document summarizes the usage of the Eclipse API scanner. |
| The goal of the Eclipse API scanner is to identify any internal API references in |
| any Eclipse-based products. You can view the requirements document |
| <a href="http://dev.eclipse.org/viewcvs/index.cgi/*checkout*/releng.wtptools/api/api-usage-checking.html?rev=HEAD&cvsroot=WebTools_Project&content-type=text/html">here</a>, and the design document |
| <a href="http://dev.eclipse.org/viewcvs/index.cgi/*checkout*/releng.wtptools/api/api-usage-checking-design.html?rev=HEAD&cvsroot=WebTools_Project&content-type=text/html">here</a>. |
| </p></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p></p></td></tr><tr><td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Downloading and running the Eclipse API scanner</font></b></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p> |
| You can get the latest version of the Eclipse API scanner |
| <a href="http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/wtp-apiscanner.zip">here</a>. |
| </p></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p> |
| The previous version of the Eclipse API scanner is available |
| <a href="http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/apiscanner.zip">here</a>. |
| </p></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p> |
| The source of the Eclipse API scanner is also available in |
| <a href="http://dev.eclipse.org/viewcvs/index.cgi/releng.wtptools/api/?cvsroot=WebTools_Project">CVS</a>. |
| Check out the |
| <b>org.eclipse.wtp.releng.tools.component.core</b> project and the |
| <b>org.eclipse.wtp.releng.tools.component.ui</b> project. |
| </p></td></tr><tr><td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Running the Eclipse API scanner within Eclipse</font></b></td></tr><tr><td align="right" valign="top"> |
| |
| </td><td valign="top"><p> |
| The Eclipse API scanner is available as two Eclipse plug-ins. Therefore, you can overlay |
| them on top of an Eclipse driver and use them to scan you APIs for violations, javadoc |
| coverage and etc. |
| <ol> |
| <li>Download the latest |
| <a href="http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/wtp-apiscanner.zip">Eclipse API scanner</a> |
| and unzip it on top of your Eclipse driver.</li> |
| <li>Start Eclipse.</li> |
| <li>Go to preference and make sure your target platform is correct.</li> |
| <li>Load your plug-ins into the workspace.</li> |
| <li>Right click on a component.xml file > API > Scan for API violation. |
| It may take a few minutes when you run this action for the first time. This |
| is because the scanner needs to parse the APIs for your target platform. |
| Subsequence runs should be faster. Note that if you change your target |
| platform, you will get the same delay again.</li> |
| <li>After the action completes, the API violation report opens in a browser. |
| This report shows you all the API violations for plug-ins in the selected |
| compoennt. |
| <p><img src="./figure01.gif"></p> |
| </li> |
| <li>Right click on the same component.xml file again > API > Scan |
| for Missing javadoc.</li> |
| <li>After the action completes, the Javadoc coverage report opens in a browser. |
| This report shows you plug-ins that have missing javadoc in them. |
| <p><img src="./figure02.gif"></p> |
| </li> |
| |
| |
| |
| </ol> |
| </p></td></tr></tbody></table></body></html> |