blob: 2ae6b62937de999e18df970ef3125608e62d3bf4 [file] [log] [blame]
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta
http-equiv="Content-Type"
content="text/html; charset=ISO-8859-1" />
<title>Getting Source</title>
</head>
<body>
<h1>Getting Source for WTP, after Installing Java EE IDE</h1>
<p>The easiest way to get going with web development, is to install the <a
href="http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/ganymedesr1/">Java EE IDE Package</a>from
the <a href="http://www.eclipse.org/downloads/">Eclipse download site</a>.</p>
<p>We deliberately leave out the source code from this package, since it would nearly double the size of the
download file and it is not needed to develop web applications. But some people would also like to get the source code
for this package installed in their development environment, such as those developing add-on plug-ins. Once the Java EE IDE
is installed, this is a fairly easy task. In fact, it is so easy these instructions would not even be required, except for a
few bugs that require some workarounds in the form of non-intuitive steps. While the steps below are specifically for the WTP
source code, the process would be similar for other components.</p>
<dl>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 1. Help, Software Updates</dt>
<dd>The first screen you'll see is a too long list of installed features. <br />
<img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="Software Updates"
src="./InstallImages/SoftwareUpdates.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 2. Available Software Tab</dt>
<dd>Click on the <code>Available Software</code> tab. This will show a list of enabled update sites.
Unfortunately, the webtools update site is not enabled by default, see <a
href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=247389">bug 247389</a>. <img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="Available Software"
src="./InstallImages/AvailableSoftware.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 3. Manage Sites</dt>
<dd>From the <code>Available Software tab</code> click on the <code>Manage Sites button</code>. These are the
sites that make up the Java EE IDE features and projects. You can enable them all if you'd like, but that may, I've
heard, cause some performance slow downs, while doing the remaining steps. At a minimum, make sure the "webtools"
update site is checked. Note, at times, instead of the URL, as in the image below, you may see the actual name of
the site, <code>Web Tools (WTP) Update Site</code>, depending on exactly when the update function actually goes to
that URL to find what's there. <img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="Enable sites from Manage Sites"
src="./InstallImages/ManageSites.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 4. Select WTP SDK features</dt>
<dd>After clicking <code>OK</code> with the webtools site enabled, you will then see, and should expand, the
webtools update site on the <code>Available Software tab</code>. For <strong>Ganymede SR1</strong>, the version of
WTP SDK features to get are in the <strong>WTP 3.0.2 category</strong>. Select all of them, or the desired specific
ones. Note, as in Step 3, at times, instead of the URL, as in the image below, you may see the actual name of the
site, <code>Web Tools (WTP) Update Site</code>, depending on exactly when the update function actually goes to that
URL to find what's there. <img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="List of WTP SDK Features"
src="./InstallImages/WTP302SDK.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 5. Confirm</dt>
<dd>After a lot of deep thought, you should see a list of SDK features to install. <img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="Confirm List of Features"
src="./InstallImages/ReviewAndConfirm.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 6. Review Legal stuff</dt>
<dd>After pressing <code>Next</code> you will get a chance to review the license information, which is really
nothing new from what applies to the whole of the Java EE IDE ... well, consult your attorneys if you want legal advise!
<img
style="padding-top: 2em; padding-bottom: 2em"
width="100%"
alt="License Info Dialog"
src="./InstallImages/AcceptLicense.gif" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 7. Updates occur</dt>
<dd>After pressing <code>Finish</code>, please take this opportunity to visit our snack bar and purchase a
tasty treat. <br clear="all" />
<img
style="padding-top: 2em; padding-bottom: 2em"
alt="Progress dialog"
src="./InstallImages/Progress.gif"
width="607"
height="266" /></dd>
<dt style="padding-bottom: 1em; font-size: large; font-weight: bold;">Step 8. Restart</dt>
<dd>I doubt if you have to for just installing source jars, but I always restart when Eclipse tells me its
strongly recommended. <br clear="all" />
<img
style="padding-top: 2em; padding-bottom: 2em"
alt="restart"
src="./InstallImages/Restart.gif"
width="601"
height="152" /></dd>
</dl>
<p>If you find errors on this page, please open a bug under the <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=WTP%20Website">Webtools Website</a></p>
</body>
</html>