blob: 6ec39674701f852ad7db18baec4db61b0eaf6a85 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML>
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
<TITLE>
The browser example
</TITLE>
<link rel="stylesheet" type="text/css" HREF="../book.css">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H2>
The browser example</H2>
<P>
We will look at how to build a Rich Client Platform application by going through a simple
web browser example. This example is not included in the R3.0 SDK, but can be downloaded from the project
<a href="http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ui.examples.rcp.browser/">org.eclipse.ui.examples.rcp.browser</a>.
If you are working in Eclipse, you may simply check out the project from the Eclipse CVS repository (see the
<a href="http://dev.eclipse.org/cvshowto.html">Eclipse CVS How-To</a> if you are not familiar with the procedure for
checking out projects from CVS).
</p>
<p>
To run the RCP Browser example from within the Eclipse SDK: </p>
<ol>
<li>Load the project <tt>org.eclipse.ui.examples.rcp.browser</tt> from the Eclipse CVS repository. </li>
<li>Choose
<a class="command-link" href='javascript:executeCommand("org.eclipse.debug.ui.commands.OpenRunConfigurations")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png">
<b>Run &gt; Run...</b></a>
from the workbench menu bar and create a new "Run-time workbench"
configuration named "Browser Example". </li>
<li>On the <b>Arguments</b> tab, select <b>Run a product</b> and select "org.eclipse.ui.examples.rcp.browser.product" from the drop-down. </li>
<li>On the <b>Plug-ins</b> tab, select <b>Choose plug-ins and fragments to launch from the list</b> so that you can select which
plug-ins are needed. </li>
<li>Press <b>Deselect All</b> to start with a clean slate. </li>
<li>Check "org.eclipse.ui.examples.rcp.browser" </li>
<li>Press <b>Add Required Plug-ins</b>. </li>
<li>Check "org.eclipse.update.configurator" </li>
<li>Run or debug the new run configuration. </li>
</ol>
<img border="0" src="images/browserexample.png" alt="Browser Example Window">
<p>
As you can see, it's hard to tell that this application has anything at all to do with Eclipse (apart from the default
web site that it browses!). There is no resource navigator, no mention of the Eclipse Platform, and none of the familiar
menu bar items from the platform workbench. (The few Eclipse-related features, such as the window icon, could
also be reconfigured if desired.)
</p>
<p>
Hopefully this example helps clarify what's exciting about the Rich Client Platform. Let's take a look under the covers so we
can learn what's involved in building one. We'll assume that you are familiar with the basic workbench extensions discussed in
<a href="workbench.htm">Plugging into the workbench</a>.
</p>
</BODY>
</HTML>