| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"><HTML> | |
| <HEAD> | |
| <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"> | |
| <title>Deploying a plug-in</title> | |
| </head> | |
| <BODY BGCOLOR="#ffffff"> | |
| <h1>Deploying a plug-in</h1> | |
| <p>During the design phase, plug-ins and fragments in your workspace are used | |
| as-is so that you can quickly test and debug. Once you reach the stage where you | |
| are satisfied with your code, you need to publish it in a form fit for delivery on | |
| the platform. </p> | |
| <p>The easiest way to do so is through the 'Export Plug-ins and Fragments' | |
| Wizard. It shields you from ant scripts and does not pollute your | |
| workspace with resources generated during the build operations:</p> | |
| <ol> | |
| <li>Select <b>File>Export...>Deployable plug-ins and fragments</b></li> | |
| <li>Select the plug-ins and fragments you want to export. The 'single | |
| deployable ZIP file' option will create one zip file containing all the | |
| selected plug-ins and fragments, which can be directly unzipped into any | |
| Eclipse product. The 'individual JAR archives' option will create a jar | |
| file for every selected plug-in and fragment. The jar files are named | |
| according to the format: <b><plug-in id>_<plug-in version>.jar</b></li> | |
| </ol> | |
| <p align="center"> | |
| <img border="0" src="images/plugin-export.gif" width="470" height="550" alt="Export plug-ins and fragments wizard"></p> | |
| <p> | |
| </p> | |
| <p> | |
| An alternate way is to build a plug-in or a fragment manually:</p> | |
| <ol> | |
| <li>Select the plugin.xml file for your plug-in (or the fragment.xml file for | |
| your fragment) and choose 'Create Ant Build File'. This will create a | |
| build.xml file.</li> | |
| <li>Select the build.xml file and choose 'Runt Ant...'. This will open | |
| the Ant build script wizard.</li> | |
| <li>Choose the target(s) of your choice and then press 'Run'.</li> | |
| </ol> | |
| <p align="center"> | |
| <img border="0" src="images/feature-jar.gif" width="539" height="572" alt="Ant launch wizard"></p> | |
| <p align="center"> | |
| </p> | |
| <p> | |
| You can also package your plug-in(s) and fragment(s) into a <b>feature</b>. | |
| This lets you use the platform Install and Update Manager to deliver your | |
| feature. You can make it available on a server and publish the URL. The | |
| platform Update Manager can be used to download and install your feature.</p> | |
| <p>The remaining sections describe features and how to build them.</p> | |
| <p> <br> | |
| <a href="../hglegal2003.htm"> | |
| <img src = "../images/ngibmcpy2003.gif" alt="Copyright IBM Corporation and others 2000, 2003" border="0" width="324" height="14"></a> | |
| </p> | |
| </body> | |
| </html> |