sitedocs/tycho-compiler-plugin/compile-mojo.html - www.eclipse.org/tycho - Git at Google

 <!DOCTYPE html>
 <!--
  | Generated by Apache Maven Doxia Site Renderer 1.9.1 from target/generated-site/xdoc/compile-mojo.xml at 2019-11-14
  | 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 Compiler Plugin &#x2013; tycho-compiler:compile</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 Compiler 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: 2019-11-14<span class="divider">|</span>
 </li>
           <li id="projectVersion">Version: 1.5.1-SNAPSHOT</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-compiler:compile"></a>tycho-compiler:compile</h2>

 <p><b>Full name</b>:</p>

 <p>org.eclipse.tycho:tycho-compiler-plugin:1.5.1-SNAPSHOT:compile</p>

 <p><b>Description</b>:</p>

 <div>Compiles application sources with eclipse plugin dependencies</div>

 <p><b>Attributes</b>:</p>

 <ul>

 <li>Requires a Maven project to be executed.</li>

 <li>Requires dependency resolution of artifacts in scope: compile.</li>

 <li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: compile.</li>
       </ul>
       <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="#annotationProcessors">&lt;annotationProcessors&gt;</a></td>

 <td>String[]</td>

 <td>0.16.0</td>

 <td>Qualified class names of annotation processors to run. If
 specified, the <a class="externalLink" href="http://java.sun.com/javase/6/docs/api/javax/annotation/processing/Processor.html">normal
 processor discovery process</a> will be skipped. This parameter
 requires a 1.6 VM or above and is used only if the compliance is
 1.6<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#compilerArgs">&lt;compilerArgs&gt;</a></td>

 <td>List</td>

 <td>0.17.0</td>

 <td>Arguments to be passed to the compiler.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#compilerArgument">&lt;compilerArgument&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>
 <p>Unformatted argument string to be passed to the compiler if fork
 is set to true.</p>

 <p>This is because the list of valid arguments passed to a Java
 compiler varies based on the compiler version.</p><br /></td>
           </tr>

 <tr class="a">

 <td><a href="#compilerArguments">&lt;compilerArguments&gt;</a></td>

 <td>Map</td>

 <td>-</td>

 <td><b>Deprecated.</b> use compilerArgs instead.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#compilerId">&lt;compilerId&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The compiler id of the compiler to use.<br /><b>Default value is</b>: jdt.<br /><b>User property is</b>: maven.compiler.compilerId.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#compilerVersion">&lt;compilerVersion&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>Version of the compiler to use, ex. &quot;1.3&quot;, &quot;1.5&quot;, if fork is set to
 true<br /><b>User property is</b>: maven.compiler.compilerVersion.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#copyResources">&lt;copyResources&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Whether all resources in the source folders should be copied to
 ${project.build.outputDirectory}. true (default) means
 that all resources are copied from the source folders to
 ${project.build.outputDirectory}. false
 means that no resources are copied from the source folders to
 ${project.build.outputDirectory}. Set this to
 false in case you want to keep resources separate from
 java files in src/main/resources and handle them using
 <a class="externalLink" href="http://maven.apache.org/plugins/maven-resources-plugin/">maven-resources-plugin</a>
 (e.g. for <a class="externalLink" href="http://maven.apache.org/plugins/maven-resources-plugin/examples/filter.html">resource
 filtering</a>.<br /><b>Default value is</b>: true.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#debug">&lt;debug&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Whether to include debugging information in the compiled class
 files. The default value is true.<br /><b>Default value is</b>: true.<br /><b>User property is</b>: maven.compiler.debug.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#encoding">&lt;encoding&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The -encoding argument for the Java compiler<br /><b>User property is</b>: project.build.sourceEncoding.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#excludeResources">&lt;excludeResources&gt;</a></td>

 <td>Set</td>

 <td>-</td>

 <td>A list of exclusion filters for non-java resource files which
 should not be copied to the output directory.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#excludes">&lt;excludes&gt;</a></td>

 <td>Set</td>

 <td>-</td>

 <td>A list of exclusion filters for the compiler.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#executable">&lt;executable&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The executable of the compiler to use when fork is true.<br /><b>User property is</b>: maven.compiler.executable.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#extraClasspathElements">&lt;extraClasspathElements&gt;</a></td>

 <td>Dependency[]</td>

 <td>-</td>

 <td>Transitively add specified maven artifacts to compile classpath in
 addition to elements calculated according to OSGi rules. All
 packages from additional entries will be accessible at compile
 time. Useful when OSGi runtime classpath contains elements not
 defined using normal dependency mechanisms. For example, when
 Eclipse Equinox is started from application server with
 -Dosgi.parentClassloader=fwk parameter.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#failOnWarning">&lt;failOnWarning&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Fail on warnings<br /><b>Default value is</b>: false.<br /><b>User property is</b>: maven.compiler.failOnWarning.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#fork">&lt;fork&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Allows running the compiler in a separate process. If &quot;false&quot; it
 uses the built in compiler, while if &quot;true&quot; it will use an
 executable.<br /><b>Default value is</b>: false.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#generatedSourcesDirectory">&lt;generatedSourcesDirectory&gt;</a></td>

 <td>File</td>

 <td>0.16.0</td>

 <td>The directory where source files generated by annotation processors
 will be created. This parameter requires a 1.6 VM or above and is
 used only if the compliance is 1.6.<br /><b>Default value is</b>: ${project.build.directory}/generated-sources/annotations.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#includes">&lt;includes&gt;</a></td>

 <td>Set</td>

 <td>-</td>

 <td>A list of inclusion filters for the compiler.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#log">&lt;log&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The format of the compiler log file. plain will log
 into a plain text file (.log), xml will log in xml
 format (.xml). If omitted, no logging into files is done. The log
 file name is derived from the jar file name:

 <div>
 <pre>
 Example:
 build.properties:

 output.lib1/library.jar = lib1bin/
 output.lib2/library.jar = lib2bin/
 output.. = bin/

 And a configuration:

 &lt;configuration&gt;
   &lt;logEnabled&gt;true&lt;/logEnabled&gt;
   &lt;logDirectory&gt;${project.build.directory}/logfiles&lt;/logDirectory&gt;
   &lt;log&gt;xml&lt;/log&gt;
 &lt;/configuration&gt;

 Will produce the following log files

 ${project.build.directory}/logfiles/@dot.xml
 ${project.build.directory}/logfiles/lib1_library.jar.xml
 ${project.build.directory}/logfiles/lib2_library.jar.xml
 </pre></div><br /></td>
           </tr>

 <tr class="b">

 <td><a href="#logDirectory">&lt;logDirectory&gt;</a></td>

 <td>File</td>

 <td>-</td>

 <td>The directory where the compiler log files should be placed. For
 each output jar a log file will be created and stored in this
 directory. Logging into files is only enabled if log
 is specified. Default:
 ${project.build.directory}/compile-logs<br /><b>Default value is</b>: ${project.build.directory}/compile-logs.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#maxmem">&lt;maxmem&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>maximum size, in megabytes, of the memory allocation pool, ex.
 &quot;128&quot;, &quot;128m&quot; if fork is set to true<br /><b>User property is</b>: maven.compiler.maxmem.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#meminitial">&lt;meminitial&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>Initial size, in megabytes, of the memory allocation pool, ex.
 &quot;64&quot;, &quot;64m&quot; if fork is set to true<br /><b>User property is</b>: maven.compiler.meminitial.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#optimize">&lt;optimize&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Optimize compiled code using the compiler's optimization methods<br /><b>Default value is</b>: false.<br /><b>User property is</b>: maven.compiler.optimize.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#outputFileName">&lt;outputFileName&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>Used to control the name of the output file when compiling a set of
 sources to a single file.<br /><b>User property is</b>: project.build.finalName.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#proc">&lt;proc&gt;</a></td>

 <td>String</td>

 <td>0.16.0</td>

 <td>If only is specified, the annotation processors will run
 but no compilation will be performed. If none is
 specified, annotation processors will not be discovered or run;
 compilation will proceed as if no annotation processors were found.
 By default the compiler must search the classpath for annotation
 processors, so specifying none may speed compilation if
 annotation processing is not required. This parameter requires a
 1.6 VM or above and is used only if the compliance is 1.6<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#requireJREPackageImports">&lt;requireJREPackageImports&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Whether a bundle is required to explicitly import non-java.*
 packages from the JDK. This is the design-time equivalent to the
 equinox runtime option <a class="externalLink" href="http://wiki.eclipse.org/Equinox_Boot_Delegation#The_solution">osgi.compatibility.bootdelegation</a>.<br /><b>Default value is</b>: false.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#showDeprecation">&lt;showDeprecation&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Output source locations where deprecated APIs are used<br /><b>Default value is</b>: false.<br /><b>User property is</b>: maven.compiler.showDeprecation.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#showWarnings">&lt;showWarnings&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Output warnings<br /><b>Default value is</b>: false.<br /><b>User property is</b>: maven.compiler.showWarnings.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#source">&lt;source&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The -source argument for the Java compiler<br /><b>User property is</b>: maven.compiler.source.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#staleMillis">&lt;staleMillis&gt;</a></td>

 <td>int</td>

 <td>-</td>

 <td>The granularity in milliseconds of the last modification date for
 testing whether a source needs recompilation<br /><b>Default value is</b>: 0.<br /><b>User property is</b>: lastModGranularityMs.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#strictCompilerTarget">&lt;strictCompilerTarget&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>If set to false (the default) issue a warning if
 effective compiler target level is incompatible with bundle minimal
 execution environment. If set to true will fail the
 build if effective compiler target and minimal BREE are
 incompatible.<br /><b>Default value is</b>: false.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#target">&lt;target&gt;</a></td>

 <td>String</td>

 <td>-</td>

 <td>The -target argument for the Java compiler<br /><b>User property is</b>: maven.compiler.target.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#useJDK">&lt;useJDK&gt;</a></td>

 <td>ToolchainProvider$JDKUsage</td>

 <td>-</td>

 <td>Which JDK to use for compilation. Default value is SYSTEM which
 means the currently running JDK. If BREE is specified, MANIFEST
 header Bundle-RequiredExecutionEnvironment is used to
 define the JDK to compile against. In this case, you need to
 provide a <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-using-toolchains.html">toolchains.xml</a>
 configuration file. The value of BREE will be matched against the
 id of the toolchain elements in toolchains.xml. Example:

 <div>
 <pre>
 &lt;toolchains&gt;
   &lt;toolchain&gt;
      &lt;type&gt;jdk&lt;/type&gt;
      &lt;provides&gt;
          &lt;id&gt;J2SE-1.5&lt;/id&gt;
      &lt;/provides&gt;
      &lt;configuration&gt;
         &lt;jdkHome&gt;/path/to/jdk/1.5&lt;/jdkHome&gt;
      &lt;/configuration&gt;
   &lt;/toolchain&gt;
 &lt;/toolchains&gt;
 </pre></div>

 The default value of the bootclasspath used for compilation is
 &lt;jdkHome&gt;/lib/*;&lt;jdkHome&gt;/lib/ext/*;&lt;jdkHome&gt;/lib/endorsed/*
 . For JDKs with different filesystem layouts, the bootclasspath can
 be specified explicitly in the configuration section. Example:

 <div>
 <pre>
 &lt;configuration&gt;
   &lt;jdkHome&gt;/path/to/jdk/1.5&lt;/jdkHome&gt;
   &lt;bootClassPath&gt;
     &lt;includes&gt;
       &lt;include&gt;jre/lib/amd64/default/jclSC160/*.jar&lt;/include&gt;
     &lt;/includes&gt;
     &lt;excludes&gt;
       &lt;exclude&gt;**/alt-*.jar&lt;/exclude&gt;
     &lt;/excludes&gt;
   &lt;/bootClassPath&gt;
 &lt;/configuration&gt;
 </pre></div><br /><b>Default value is</b>: SYSTEM.<br /></td>
           </tr>

 <tr class="b">

 <td><a href="#useProjectSettings">&lt;useProjectSettings&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>If set to true, the settings file
 ${project.basedir}/.settings/org.eclipse.jdt.core.prefs will be
 passed to the compiler. If the file is not present, the build will
 not fail.<br /><b>Default value is</b>: true.<br /></td>
           </tr>

 <tr class="a">

 <td><a href="#verbose">&lt;verbose&gt;</a></td>

 <td>boolean</td>

 <td>-</td>

 <td>Whether to output messages about what the compiler is doing<br /><b>Default value is</b>: false.<br /><b>User property is</b>: maven.compiler.verbose.<br /></td>
           </tr>
         </table>
       </section>
       <section>
 <h3><a name="Parameter_Details"></a>Parameter Details</h3>
         <section>
 <h4><a name="a.3CannotationProcessors.3E"></a><b><a name="annotationProcessors">&lt;annotationProcessors&gt;</a></b></h4>

 <div>Qualified class names of annotation processors to run. If
 specified, the <a class="externalLink" href="http://java.sun.com/javase/6/docs/api/javax/annotation/processing/Processor.html">normal
 processor discovery process</a> will be skipped. This parameter
 requires a 1.6 VM or above and is used only if the compliance is
 1.6</div>

 <ul>

 <li><b>Type</b>: java.lang.String[]</li>

 <li><b>Since</b>: 0.16.0</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcompilerArgs.3E"></a><b><a name="compilerArgs">&lt;compilerArgs&gt;</a></b></h4>

 <div>Arguments to be passed to the compiler.</div>

 <ul>

 <li><b>Type</b>: java.util.List</li>

 <li><b>Since</b>: 0.17.0</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcompilerArgument.3E"></a><b><a name="compilerArgument">&lt;compilerArgument&gt;</a></b></h4>

 <div>
 <p>Unformatted argument string to be passed to the compiler if fork
 is set to true.</p>

 <p>This is because the list of valid arguments passed to a Java
 compiler varies based on the compiler version.</p></div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcompilerArguments.3E"></a><b><a name="compilerArguments">&lt;compilerArguments&gt;</a></b></h4>

 <div><b>Deprecated.</b> use compilerArgs instead.</div>

 <div>
 <p>Arguments to be passed to the compiler (prepending a dash) if
 fork is set to true.</p>

 <p>This is because the list of valid arguments passed to a Java
 compiler varies based on the compiler version.</p></div>

 <ul>

 <li><b>Type</b>: java.util.Map</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcompilerId.3E"></a><b><a name="compilerId">&lt;compilerId&gt;</a></b></h4>

 <div>The compiler id of the compiler to use.</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.compilerId</li>

 <li><b>Default</b>: jdt</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcompilerVersion.3E"></a><b><a name="compilerVersion">&lt;compilerVersion&gt;</a></b></h4>

 <div>Version of the compiler to use, ex. &quot;1.3&quot;, &quot;1.5&quot;, if fork is set to
 true</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.compilerVersion</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CcopyResources.3E"></a><b><a name="copyResources">&lt;copyResources&gt;</a></b></h4>

 <div>Whether all resources in the source folders should be copied to
 ${project.build.outputDirectory}. true (default) means
 that all resources are copied from the source folders to
 ${project.build.outputDirectory}. false
 means that no resources are copied from the source folders to
 ${project.build.outputDirectory}. Set this to
 false in case you want to keep resources separate from
 java files in src/main/resources and handle them using
 <a class="externalLink" href="http://maven.apache.org/plugins/maven-resources-plugin/">maven-resources-plugin</a>
 (e.g. for <a class="externalLink" href="http://maven.apache.org/plugins/maven-resources-plugin/examples/filter.html">resource
 filtering</a>.</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.3Cdebug.3E"></a><b><a name="debug">&lt;debug&gt;</a></b></h4>

 <div>Whether to include debugging information in the compiled class
 files. The default value is true.</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.debug</li>

 <li><b>Default</b>: true</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cencoding.3E"></a><b><a name="encoding">&lt;encoding&gt;</a></b></h4>

 <div>The -encoding argument for the Java compiler</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: project.build.sourceEncoding</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CexcludeResources.3E"></a><b><a name="excludeResources">&lt;excludeResources&gt;</a></b></h4>

 <div>A list of exclusion filters for non-java resource files which
 should not be copied to the output directory.</div>

 <ul>

 <li><b>Type</b>: java.util.Set</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cexcludes.3E"></a><b><a name="excludes">&lt;excludes&gt;</a></b></h4>

 <div>A list of exclusion filters for the compiler.</div>

 <ul>

 <li><b>Type</b>: java.util.Set</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cexecutable.3E"></a><b><a name="executable">&lt;executable&gt;</a></b></h4>

 <div>The executable of the compiler to use when fork is true.</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.executable</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CextraClasspathElements.3E"></a><b><a name="extraClasspathElements">&lt;extraClasspathElements&gt;</a></b></h4>

 <div>Transitively add specified maven artifacts to compile classpath in
 addition to elements calculated according to OSGi rules. All
 packages from additional entries will be accessible at compile
 time. Useful when OSGi runtime classpath contains elements not
 defined using normal dependency mechanisms. For example, when
 Eclipse Equinox is started from application server with
 -Dosgi.parentClassloader=fwk parameter.</div>

 <ul>

 <li><b>Type</b>: org.apache.maven.model.Dependency[]</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CfailOnWarning.3E"></a><b><a name="failOnWarning">&lt;failOnWarning&gt;</a></b></h4>

 <div>Fail on warnings</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.failOnWarning</li>

 <li><b>Default</b>: false</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cfork.3E"></a><b><a name="fork">&lt;fork&gt;</a></b></h4>

 <div>Allows running the compiler in a separate process. If &quot;false&quot; it
 uses the built in compiler, while if &quot;true&quot; it will use an
 executable.</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.3CgeneratedSourcesDirectory.3E"></a><b><a name="generatedSourcesDirectory">&lt;generatedSourcesDirectory&gt;</a></b></h4>

 <div>The directory where source files generated by annotation processors
 will be created. This parameter requires a 1.6 VM or above and is
 used only if the compliance is 1.6.</div>

 <ul>

 <li><b>Type</b>: java.io.File</li>

 <li><b>Since</b>: 0.16.0</li>

 <li><b>Required</b>: No</li>

 <li><b>Default</b>: ${project.build.directory}/generated-sources/annotations</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cincludes.3E"></a><b><a name="includes">&lt;includes&gt;</a></b></h4>

 <div>A list of inclusion filters for the compiler.</div>

 <ul>

 <li><b>Type</b>: java.util.Set</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Clog.3E"></a><b><a name="log">&lt;log&gt;</a></b></h4>

 <div>The format of the compiler log file. plain will log
 into a plain text file (.log), xml will log in xml
 format (.xml). If omitted, no logging into files is done. The log
 file name is derived from the jar file name:

 <div>
 <pre>
 Example:
 build.properties:

 output.lib1/library.jar = lib1bin/
 output.lib2/library.jar = lib2bin/
 output.. = bin/

 And a configuration:

 &lt;configuration&gt;
   &lt;logEnabled&gt;true&lt;/logEnabled&gt;
   &lt;logDirectory&gt;${project.build.directory}/logfiles&lt;/logDirectory&gt;
   &lt;log&gt;xml&lt;/log&gt;
 &lt;/configuration&gt;

 Will produce the following log files

 ${project.build.directory}/logfiles/@dot.xml
 ${project.build.directory}/logfiles/lib1_library.jar.xml
 ${project.build.directory}/logfiles/lib2_library.jar.xml
 </pre></div></div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3ClogDirectory.3E"></a><b><a name="logDirectory">&lt;logDirectory&gt;</a></b></h4>

 <div>The directory where the compiler log files should be placed. For
 each output jar a log file will be created and stored in this
 directory. Logging into files is only enabled if log
 is specified. Default:
 ${project.build.directory}/compile-logs</div>

 <ul>

 <li><b>Type</b>: java.io.File</li>

 <li><b>Required</b>: No</li>

 <li><b>Default</b>: ${project.build.directory}/compile-logs</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cmaxmem.3E"></a><b><a name="maxmem">&lt;maxmem&gt;</a></b></h4>

 <div>maximum size, in megabytes, of the memory allocation pool, ex.
 &quot;128&quot;, &quot;128m&quot; if fork is set to true</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.maxmem</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cmeminitial.3E"></a><b><a name="meminitial">&lt;meminitial&gt;</a></b></h4>

 <div>Initial size, in megabytes, of the memory allocation pool, ex.
 &quot;64&quot;, &quot;64m&quot; if fork is set to true</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.meminitial</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Coptimize.3E"></a><b><a name="optimize">&lt;optimize&gt;</a></b></h4>

 <div>Optimize compiled code using the compiler's optimization methods</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.optimize</li>

 <li><b>Default</b>: false</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CoutputFileName.3E"></a><b><a name="outputFileName">&lt;outputFileName&gt;</a></b></h4>

 <div>Used to control the name of the output file when compiling a set of
 sources to a single file.</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: project.build.finalName</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Cproc.3E"></a><b><a name="proc">&lt;proc&gt;</a></b></h4>

 <div>If only is specified, the annotation processors will run
 but no compilation will be performed. If none is
 specified, annotation processors will not be discovered or run;
 compilation will proceed as if no annotation processors were found.
 By default the compiler must search the classpath for annotation
 processors, so specifying none may speed compilation if
 annotation processing is not required. This parameter requires a
 1.6 VM or above and is used only if the compliance is 1.6</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Since</b>: 0.16.0</li>

 <li><b>Required</b>: No</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CrequireJREPackageImports.3E"></a><b><a name="requireJREPackageImports">&lt;requireJREPackageImports&gt;</a></b></h4>

 <div>Whether a bundle is required to explicitly import non-java.*
 packages from the JDK. This is the design-time equivalent to the
 equinox runtime option <a class="externalLink" href="http://wiki.eclipse.org/Equinox_Boot_Delegation#The_solution">osgi.compatibility.bootdelegation</a>.</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.3CshowDeprecation.3E"></a><b><a name="showDeprecation">&lt;showDeprecation&gt;</a></b></h4>

 <div>Output source locations where deprecated APIs are used</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.showDeprecation</li>

 <li><b>Default</b>: false</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CshowWarnings.3E"></a><b><a name="showWarnings">&lt;showWarnings&gt;</a></b></h4>

 <div>Output warnings</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.showWarnings</li>

 <li><b>Default</b>: false</li>
         </ul><hr /></section><section>
 <h4><a name="a.3Csource.3E"></a><b><a name="source">&lt;source&gt;</a></b></h4>

 <div>The -source argument for the Java compiler</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.source</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CstaleMillis.3E"></a><b><a name="staleMillis">&lt;staleMillis&gt;</a></b></h4>

 <div>The granularity in milliseconds of the last modification date for
 testing whether a source needs recompilation</div>

 <ul>

 <li><b>Type</b>: int</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: lastModGranularityMs</li>

 <li><b>Default</b>: 0</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CstrictCompilerTarget.3E"></a><b><a name="strictCompilerTarget">&lt;strictCompilerTarget&gt;</a></b></h4>

 <div>If set to false (the default) issue a warning if
 effective compiler target level is incompatible with bundle minimal
 execution environment. If set to true will fail the
 build if effective compiler target and minimal BREE are
 incompatible.</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.3Ctarget.3E"></a><b><a name="target">&lt;target&gt;</a></b></h4>

 <div>The -target argument for the Java compiler</div>

 <ul>

 <li><b>Type</b>: java.lang.String</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.target</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CuseJDK.3E"></a><b><a name="useJDK">&lt;useJDK&gt;</a></b></h4>

 <div>Which JDK to use for compilation. Default value is SYSTEM which
 means the currently running JDK. If BREE is specified, MANIFEST
 header Bundle-RequiredExecutionEnvironment is used to
 define the JDK to compile against. In this case, you need to
 provide a <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-using-toolchains.html">toolchains.xml</a>
 configuration file. The value of BREE will be matched against the
 id of the toolchain elements in toolchains.xml. Example:

 <div>
 <pre>
 &lt;toolchains&gt;
   &lt;toolchain&gt;
      &lt;type&gt;jdk&lt;/type&gt;
      &lt;provides&gt;
          &lt;id&gt;J2SE-1.5&lt;/id&gt;
      &lt;/provides&gt;
      &lt;configuration&gt;
         &lt;jdkHome&gt;/path/to/jdk/1.5&lt;/jdkHome&gt;
      &lt;/configuration&gt;
   &lt;/toolchain&gt;
 &lt;/toolchains&gt;
 </pre></div>

 The default value of the bootclasspath used for compilation is
 &lt;jdkHome&gt;/lib/*;&lt;jdkHome&gt;/lib/ext/*;&lt;jdkHome&gt;/lib/endorsed/*
 . For JDKs with different filesystem layouts, the bootclasspath can
 be specified explicitly in the configuration section. Example:

 <div>
 <pre>
 &lt;configuration&gt;
   &lt;jdkHome&gt;/path/to/jdk/1.5&lt;/jdkHome&gt;
   &lt;bootClassPath&gt;
     &lt;includes&gt;
       &lt;include&gt;jre/lib/amd64/default/jclSC160/*.jar&lt;/include&gt;
     &lt;/includes&gt;
     &lt;excludes&gt;
       &lt;exclude&gt;**/alt-*.jar&lt;/exclude&gt;
     &lt;/excludes&gt;
   &lt;/bootClassPath&gt;
 &lt;/configuration&gt;
 </pre></div></div>

 <ul>

 <li><b>Type</b>: org.eclipse.tycho.core.maven.ToolchainProvider$JDKUsage</li>

 <li><b>Required</b>: No</li>

 <li><b>Default</b>: SYSTEM</li>
         </ul><hr /></section><section>
 <h4><a name="a.3CuseProjectSettings.3E"></a><b><a name="useProjectSettings">&lt;useProjectSettings&gt;</a></b></h4>

 <div>If set to true, the settings file
 ${project.basedir}/.settings/org.eclipse.jdt.core.prefs will be
 passed to the compiler. If the file is not present, 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.3Cverbose.3E"></a><b><a name="verbose">&lt;verbose&gt;</a></b></h4>

 <div>Whether to output messages about what the compiler is doing</div>

 <ul>

 <li><b>Type</b>: boolean</li>

 <li><b>Required</b>: No</li>

 <li><b>User Property</b>: maven.compiler.verbose</li>

 <li><b>Default</b>: false</li>
         </ul>
       </section></section>
     </section>


         </main>
       </div>
     </div>
     <hr/>
     <footer>
       <div class="container-fluid">
         <div class="row-fluid">
             <p>Copyright &#169;      2008&#x2013;2019<a href="http://www.eclipse.org/">Eclipse Foundation</a>.
 .</p>
         </div>
       </div>
     </footer>
   </body>
 </html>