blob: 93fea4a123122b7f89eb0d3e726a7e6c538e70e7 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link REL="STYLESHEET" HREF="../../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Plugin-in Archives</title>
</head>
<body>
<h1>
Plug-in Archives</h1>
Plug-ins and plug-in fragments are individually packaged as separate Java
.jars. Standard Java jar facilities are used for constructing plug-in archives.
There is no distinction made between a plug-in archive containing a plug-in
and one containing a plug-in fragment.
<p>The recommended convention for naming the plug-in archives is
<br><tt>&lt;id>_&lt;version>.jar</tt>
<p>Where <tt>&lt;id></tt> is the plug-in or fragment identifier and <tt>&lt;version></tt>
is the full version identifier contained in the respective plugin.xml or
fragment.xml. Note that this is a recommended convention that minimizes
chance of collisions, but is not required by the Eclipse architecture.
For example, the following are valid plug-in archive names
<p><tt>org.eclipse.platform_1.0.3.jar</tt>
<br><tt>org.eclipse.ui.nl_2.0.jar</tt>
<br><tt>my_plugin.jar</tt>
<p>Internally, each plug-in archive packages all the relevant plug-in or
fragment files relative to its plug-in or fragment directory (but not including
the directory path element). The archive has the following structure
<p><tt>plugin.xml *OR* fragment.xml</tt>
<br><tt>other plug-in or feature files and subdirectories</tt>
<br><tt>META-INF/</tt>
<br><tt>&nbsp;&nbsp;&nbsp; Java jar manifest and security files</tt>
<p>
<a href="hglegal.htm"><img src="ngibmcpy.gif" alt="Copyright IBM Corporation and others 2000, 2003." border="0" width="250" height="12"></a>
</body>
</html>