<html><head> | |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |
<title>5.2 Manifest Template Format</title><link rel="stylesheet" href="css/stylesheet.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="index.html" title="Bundlor User Guide"><link rel="up" href="ch05.html" title="5. Manifest Templates"><link rel="prev" href="ch05.html" title="5. Manifest Templates"><link rel="next" href="ch05s03.html" title="5.3 Specifying property placeholders"><!--Begin Google Analytics code--><script type="text/javascript"> | |
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www."); | |
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); | |
</script><script type="text/javascript"> | |
var pageTracker = _gat._getTracker("UA-2728886-3"); | |
pageTracker._setDomainName("none"); | |
pageTracker._setAllowLinker(true); | |
pageTracker._trackPageview(); | |
</script><!--End Google Analytics code--></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5.2 Manifest Template Format</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch05.html">Prev</a> </td><th width="60%" align="center">5. Manifest Templates</th><td width="20%" align="right"> <a accesskey="n" href="ch05s03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="manifest.template.format"></a>5.2 Manifest Template Format</h2></div></div></div><p> | |
The following table lists the headers you can add to the manifest template, in addition to the standard | |
manifest headers. | |
</p><div class="table"><a name="d0e795"></a><p class="title"><b>Table 5.1. Headers for Manifest Template</b></p><div class="table-contents"><table summary="Headers for Manifest Template" style="border-collapse: collapse;border-top: 1.0pt solid ; border-bottom: 1.0pt solid ; border-left: 1.0pt solid ; border-right: 1.0pt solid ; "><colgroup><col><col></colgroup><thead><tr><th style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; ">Header</th><th style="border-bottom: 1.0pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "><code class="literal">Excluded-Exports</code></td><td style="border-bottom: 1.0pt solid ; "> | |
A comma-separated list of packages that must not be added to the manifest's | |
<code class="literal">Export-Package</code> header. This is useful for preventing implementation | |
packages from being exported. | |
</td></tr><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "><code class="literal">Excluded-Imports</code></td><td style="border-bottom: 1.0pt solid ; "> | |
By default, Bundlor adds imports for every package that Bundlor determines is referenced by | |
the code or for special files in the jar. Use this header to specify a comma-separated list | |
of packages for which imports Bundlor will <span class="emphasis"><em>not</em></span> generate. | |
</td></tr><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "><code class="literal">Export-Template</code></td><td style="border-bottom: 1.0pt solid ; "> | |
By default, Bundlor versions all exported packages at the specified | |
<code class="literal">Bundle-Version</code>. Use this header to specify that individual exported | |
packages be exported at different versions. For example, | |
<code class="literal">Export-Template com.foo.*;version="1.5"</code> results in Bundlor versioning any | |
<code class="literal">Export-Package</code> entries for <code class="literal">com.foo</code> or its subpackages | |
at <code class="literal">1.5</code>. | |
</td></tr><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "><code class="literal">Ignored-Existing-Headers</code></td><td style="border-bottom: 1.0pt solid ; "> | |
If the JAR for which you are generating a manifest already contains an OSGi-compliant | |
manifest, use this template header to list headers in the original manifest which Bundlor | |
should ignore. | |
</td></tr><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "><code class="literal">Import-Template</code></td><td style="border-bottom: 1.0pt solid ; "> | |
Use this header to augment package imports that Bundlor generates via bytecode and special | |
file analysis. Typically you use the header to version the import and, in some cases, to | |
mark them as optional. When you use this header to version the import, you can optionally | |
specify a version expansion pattern so that Bundlor sets the version to a range rather than | |
a single version. To use the header, set its value to a comma-separated list of package | |
names and attributes. | |
</td></tr><tr><td style="border-right: 1.0pt solid ; "><code class="literal">Version-Patterns</code></td><td style=""> | |
Use this header to declare one or more version expansion patterns and give each one a name. | |
You can then use these named patterns in the <code class="literal">Import-Template</code> header if | |
you want to specify an expansion pattern for the <code class="literal">version</code> of an imported | |
package. This feature is described in detail later in this section. | |
</td></tr></tbody></table></div></div><br class="table-break"><p> | |
A wilcard '<code class="literal">*</code>' at the end of the package name is supported to match multiple packages. For | |
example, the header <code class="literal">Import-Template: com.foo;version=[1.0,2.0);resolution:=optional,com.bar.*;version="[1.5,1.6)"</code> | |
will cause any import generated for the <code class="literal">com.foo</code> package to be versioned at 1.0 | |
(inclusive) to 2.0 (exclusive) and to be considered optional, and for any import of | |
<code class="literal">com.bar</code> or its sub-packages to be versioned at 1.5 (inclusive) to 1.6 (exclusive). | |
</p></div><!--Begin LoopFuse code--><script src="http://loopfuse.net/webrecorder/js/listen.js" type="text/javascript"></script><script type="text/javascript"> | |
_lf_cid = "LF_48be82fa"; | |
_lf_remora(); | |
</script><!--End LoopFuse code--><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch05s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5. Manifest Templates </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.3 Specifying property placeholders</td></tr></table></div></body></html> |