blob: 2dc4892adfdb9a3dfb24083a87365bb11af13988 [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.9.1 from target/generated-site/xdoc/package-feature-mojo.xml at 2020-01-13
| Rendered using Apache Maven Fluido Skin 1.8
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
<title>Tycho OSGi Packaging Plugin &#x2013; tycho-packaging:package-feature</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
<link rel="stylesheet" href="./css/site.css" />
<link rel="stylesheet" href="./css/print.css" media="print" />
<script src="./js/apache-maven-fluido-1.8.min.js"></script>
</head>
<body class="topBarDisabled">
<div class="container-fluid">
<header>
<div id="banner">
<div class="pull-left"><div id="bannerLeft"><h2>Tycho OSGi Packaging Plugin</h2>
</div>
</div>
<div class="pull-right"></div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2020-01-13<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.6.0</li>
</ul>
</div>
</header>
<div class="row-fluid">
<header id="leftColumn" class="span2">
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Tycho</li>
<li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
<li><a href="../tycho-compiler-plugin/plugin-info.html" title="Compiler Plugin"><span class="none"></span>Compiler Plugin</a></li>
<li><a href="../tycho-packaging-plugin/plugin-info.html" title="Packaging Plugin"><span class="none"></span>Packaging Plugin</a></li>
<li><a href="../BuildProperties.html" title="Build Properties"><span class="none"></span>Build Properties</a></li>
<li><a href="../tycho-surefire-plugin/plugin-info.html" title="Surefire Plugin"><span class="none"></span>Surefire Plugin</a></li>
<li><a href="../tycho-p2/tycho-p2-publisher-plugin/plugin-info.html" title="p2 Publisher Plugin"><span class="none"></span>p2 Publisher Plugin</a></li>
<li><a href="../tycho-p2/tycho-p2-repository-plugin/plugin-info.html" title="p2 Repository Plugin"><span class="none"></span>p2 Repository Plugin</a></li>
<li><a href="../tycho-p2/tycho-p2-director-plugin/plugin-info.html" title="p2 Director Plugin"><span class="none"></span>p2 Director Plugin</a></li>
<li><a href="../tycho-source-plugin/plugin-info.html" title="Source Plugin"><span class="none"></span>Source Plugin</a></li>
<li><a href="../tycho-release/tycho-versions-plugin/plugin-info.html" title="Versions Plugin"><span class="none"></span>Versions Plugin</a></li>
<li><a href="../tycho-pomgenerator-plugin/plugin-info.html" title="POM Generator Plugin"><span class="none"></span>POM Generator Plugin</a></li>
<li><a href="../TychoProperties.html" title="Tycho Properties"><span class="none"></span>Tycho Properties</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
<hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
<div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
</div>
</div>
</header>
<main id="bodyColumn" class="span10" >
<section>
<h2><a name="tycho-packaging:package-feature"></a>tycho-packaging:package-feature</h2>
<p><b>Full name</b>:</p>
<p>org.eclipse.tycho:tycho-packaging-plugin:1.6.0:package-feature</p>
<p><b>Description</b>:</p>
<div>(no description)</div>
<p><b>Attributes</b>:</p>
<ul>
<li>Requires a Maven project to be executed.</li>
<li>Requires dependency resolution of artifacts in scope: runtime.</li>
<li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: package.</li>
</ul>
<section>
<h3><a name="Required_Parameters"></a>Required Parameters</h3>
<table class="table table-striped" border="0">
<tr class="a">
<th>Name</th>
<th>Type</th>
<th>Since</th>
<th>Description</th>
</tr>
<tr class="b">
<td><a href="#finalName">&lt;finalName&gt;</a></td>
<td>String</td>
<td>-</td>
<td>Name of the generated JAR.<br /><b>User property is</b>: project.build.finalName.<br /><b>Alias is</b>: jarName.</td>
</tr>
</table>
</section>
<section>
<h3><a name="Optional_Parameters"></a>Optional Parameters</h3>
<table class="table table-striped" border="0">
<tr class="a">
<th>Name</th>
<th>Type</th>
<th>Since</th>
<th>Description</th>
</tr>
<tr class="b">
<td><a href="#archive">&lt;archive&gt;</a></td>
<td>MavenArchiveConfiguration</td>
<td>-</td>
<td>The <a class="externalLink" href="http://maven.apache.org/shared/maven-archiver/">maven
archiver</a> to use. One of the archiver properties is the
addMavenDescriptor flag, which indicates whether the
generated archive will contain the pom.xml and pom.properties file.
If no archive configuration is specified, the default value is
false. If the maven descriptor should be added to the
artifact, use the following configuration:
<div>
<pre>
&lt;plugin&gt;
&lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;
&lt;artifactId&gt;tycho-packaging-plugin&lt;/artifactId&gt;
&lt;version&gt;${tycho-version}&lt;/version&gt;
&lt;configuration&gt;
&lt;archive&gt;
&lt;addMavenDescriptor&gt;true&lt;/addMavenDescriptor&gt;
&lt;/archive&gt;
&lt;/configuration&gt;
&lt;/plugin&gt;
</pre></div><br /></td>
</tr>
<tr class="a">
<td><a href="#basedir">&lt;basedir&gt;</a></td>
<td>File</td>
<td>-</td>
<td>(no description)<br /><b>User property is</b>: project.basedir.<br /></td>
</tr>
<tr class="b">
<td><a href="#deployableFeature">&lt;deployableFeature&gt;</a></td>
<td>boolean</td>
<td>-</td>
<td>If set to true, standard eclipse update site directory
with feature content will be created under target folder.<br /><b>Default value is</b>: false.<br /></td>
</tr>
<tr class="a">
<td><a href="#outputDirectory">&lt;outputDirectory&gt;</a></td>
<td>File</td>
<td>-</td>
<td>The output directory of the jar file By default this is the Maven
target/ directory.<br /><b>User property is</b>: project.build.directory.<br /></td>
</tr>
<tr class="b">
<td><a href="#qualifier">&lt;qualifier&gt;</a></td>
<td>String</td>
<td>-</td>
<td>Build qualifier. Recommended way to set this parameter is using
build-qualifier goal.<br /><b>User property is</b>: buildQualifier.<br /></td>
</tr>
<tr class="a">
<td><a href="#strictBinIncludes">&lt;strictBinIncludes&gt;</a></td>
<td>boolean</td>
<td>-</td>
<td>If set to true (the default), missing build.properties
bin.includes will cause build failure. If set to
false, missing build.properties bin.includes will be
reported as warnings but the build will not fail.<br /><b>Default value is</b>: true.<br /></td>
</tr>
<tr class="b">
<td><a href="#target">&lt;target&gt;</a></td>
<td>File</td>
<td>-</td>
<td>(no description)<br /><b>Default value is</b>: ${project.build.directory}/site.<br /></td>
</tr>
<tr class="a">
<td><a href="#useDefaultExcludes">&lt;useDefaultExcludes&gt;</a></td>
<td>boolean</td>
<td>-</td>
<td>(no description)<br /><b>Default value is</b>: true.<br /></td>
</tr>
</table>
</section>
<section>
<h3><a name="Parameter_Details"></a>Parameter Details</h3>
<section>
<h4><a name="a.3Carchive.3E"></a><b><a name="archive">&lt;archive&gt;</a></b></h4>
<div>The <a class="externalLink" href="http://maven.apache.org/shared/maven-archiver/">maven
archiver</a> to use. One of the archiver properties is the
addMavenDescriptor flag, which indicates whether the
generated archive will contain the pom.xml and pom.properties file.
If no archive configuration is specified, the default value is
false. If the maven descriptor should be added to the
artifact, use the following configuration:
<div>
<pre>
&lt;plugin&gt;
&lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;
&lt;artifactId&gt;tycho-packaging-plugin&lt;/artifactId&gt;
&lt;version&gt;${tycho-version}&lt;/version&gt;
&lt;configuration&gt;
&lt;archive&gt;
&lt;addMavenDescriptor&gt;true&lt;/addMavenDescriptor&gt;
&lt;/archive&gt;
&lt;/configuration&gt;
&lt;/plugin&gt;
</pre></div></div>
<ul>
<li><b>Type</b>: org.apache.maven.archiver.MavenArchiveConfiguration</li>
<li><b>Required</b>: No</li>
</ul><hr /></section><section>
<h4><a name="a.3Cbasedir.3E"></a><b><a name="basedir">&lt;basedir&gt;</a></b></h4>
<div>(no description)</div>
<ul>
<li><b>Type</b>: java.io.File</li>
<li><b>Required</b>: No</li>
<li><b>User Property</b>: project.basedir</li>
</ul><hr /></section><section>
<h4><a name="a.3CdeployableFeature.3E"></a><b><a name="deployableFeature">&lt;deployableFeature&gt;</a></b></h4>
<div>If set to true, standard eclipse update site directory
with feature content will be created under target folder.</div>
<ul>
<li><b>Type</b>: boolean</li>
<li><b>Required</b>: No</li>
<li><b>Default</b>: false</li>
</ul><hr /></section><section>
<h4><a name="a.3CfinalName.3E"></a><b><a name="finalName">&lt;finalName&gt;</a></b></h4>
<div>Name of the generated JAR.</div>
<ul>
<li><b>Type</b>: java.lang.String</li>
<li><b>Required</b>: Yes</li>
<li><b>User Property</b>: project.build.finalName</li>
<li><b>Alias</b>: jarName</li>
</ul><hr /></section><section>
<h4><a name="a.3CoutputDirectory.3E"></a><b><a name="outputDirectory">&lt;outputDirectory&gt;</a></b></h4>
<div>The output directory of the jar file By default this is the Maven
target/ directory.</div>
<ul>
<li><b>Type</b>: java.io.File</li>
<li><b>Required</b>: No</li>
<li><b>User Property</b>: project.build.directory</li>
</ul><hr /></section><section>
<h4><a name="a.3Cqualifier.3E"></a><b><a name="qualifier">&lt;qualifier&gt;</a></b></h4>
<div>Build qualifier. Recommended way to set this parameter is using
build-qualifier goal.</div>
<ul>
<li><b>Type</b>: java.lang.String</li>
<li><b>Required</b>: No</li>
<li><b>User Property</b>: buildQualifier</li>
</ul><hr /></section><section>
<h4><a name="a.3CstrictBinIncludes.3E"></a><b><a name="strictBinIncludes">&lt;strictBinIncludes&gt;</a></b></h4>
<div>If set to true (the default), missing build.properties
bin.includes will cause build failure. If set to
false, missing build.properties bin.includes will be
reported as warnings but the build will not fail.</div>
<ul>
<li><b>Type</b>: boolean</li>
<li><b>Required</b>: No</li>
<li><b>Default</b>: true</li>
</ul><hr /></section><section>
<h4><a name="a.3Ctarget.3E"></a><b><a name="target">&lt;target&gt;</a></b></h4>
<div>(no description)</div>
<ul>
<li><b>Type</b>: java.io.File</li>
<li><b>Required</b>: No</li>
<li><b>Default</b>: ${project.build.directory}/site</li>
</ul><hr /></section><section>
<h4><a name="a.3CuseDefaultExcludes.3E"></a><b><a name="useDefaultExcludes">&lt;useDefaultExcludes&gt;</a></b></h4>
<div>(no description)</div>
<ul>
<li><b>Type</b>: boolean</li>
<li><b>Required</b>: No</li>
<li><b>Default</b>: true</li>
</ul>
</section></section>
</section>
</main>
</div>
</div>
<hr/>
<footer>
<div class="container-fluid">
<div class="row-fluid">
<p>Copyright &#169; 2008&#x2013;2020<a href="http://www.eclipse.org/">Eclipse Foundation</a>.
.</p>
</div>
</div>
</footer>
</body>
</html>