blob: a478507aebd3ad8281492cd41a886d3b85bb7bf4 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<script language="JavaScript" type="text/javascript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
<title>Feature Patch</title>
<link href="../../book.css" rel="stylesheet" type="text/css">
<style type="text/css">
<!--
.style1 {
font-size: 18px;
font-weight: bold;
}
.style3 {
font-size: 12pt;
font-weight: bold;
}
-->
</style>
</head>
<body>
<p class="style1">Feature Patch</p>
<p>The<strong> New Feature Patch</strong> creation wizard is available under <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.newWizard(newWizardId=org.eclipse.pde.ui.NewFeaturePatchWizard)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png"><strong>File &gt; New &gt; Project... &gt; Plug-in Development &gt; Feature Patch</strong></a>
from the top level menu. </p>
<p><img src="../../images/new_wizards/feature_patch.PNG" alt="Feature Patch" hspace="30"></p>
<p>&nbsp;</p>
<p class="style3">Project Settings </p>
<p>It is recommended to use the reverse domain naming convention (e.g. com.example.patch) for the <strong>Project name</strong>. </p>
<p>The project <strong>Location</strong> field specifies the default location as a subdirectory nested inside the workspace location. The project location can be changed to any writable location by unchecking the <strong>Use default location</strong> checkbox and entering the location of choice.</p>
<p>&nbsp;</p>
<p class="style3">Feature Patch Properties </p>
<p>A feature <strong>Patch ID</strong> is mandatory and must comply with the <a href="../../../../org.eclipse.platform.doc.isv/reference/misc/plugin_manifest.html">plugin.dtd</a>.</p>
<p>A feature <strong>Patch Name</strong> is the translatable presentation name of the plug-in. This field is required. </p>
<p>A feature <strong>Patch Provider</strong> is the translatable name of the feature provider. This field is optional. </p>
<p>An <strong>Install Handler Library</strong> may be optionally associated with a feature patch if the patch needs to do specific or additional setup upon installation. Specifying an install handler library in the wizard results in the generation of a Java project; otherwise, the feature project is a simple project by default.</p>
<p>&nbsp;</p>
<p class="style3">Properties of Patched Feature</p>
<p>The <strong>Feature ID</strong>, <strong>Feature Name</strong> and <strong>Feature Version</strong> of the feature being patched must be specified. These attributes must match those of a feature found in either the workspace or the target. </p>
<p>&nbsp;</p>
<p class="style3">Feature Patch Project Structure</p>
<p>A feature patch has a standard feature project structure and can be edited using the PDE feature manifest editor. </p>
<p><img src="../../images/new_wizards/feature_explorer.PNG" alt="Feature Explorer" hspace="30"> </p>
<p>&nbsp;</p>
<p>&nbsp; </p>
</body>
</html>