Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h2><code>&lt;groovyc&gt;</code></h2><h3>Description</h3>Compiles Groovy source files and, if the joint compilation option is used, Java source files.<h3>Required taskdef</h3>Assuming groovy-all-VERSION.jar is in my.classpath you will need to declare this task at some point in the build.xml prior to the groovyc task being invoked.<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;taskdef name="groovyc"
 classname="org.codehaus.groovy.ant.Groovyc"
 classpathref="my.classpath"/>
</pre></td></tr></table><h3>&lt;groovyc&gt; Attributes</h3><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Attribute</th><th class="confluenceTh">Description</th><th class="confluenceTh">Required</th></tr><tr><td class="confluenceTd">srcdir</td><td class="confluenceTd">Location of the Groovy (and possibly Java) source files.</td><td class="confluenceTd">Yes</td></tr><tr><td class="confluenceTd">destdir</td><td class="confluenceTd">Location to store the class files.</td><td class="confluenceTd">Yes</td></tr><tr><td class="confluenceTd">classpath</td><td class="confluenceTd">The classpath to use.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">classpathref</td><td class="confluenceTd">The classpath to use given as a path references.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">sourcepath</td><td class="confluenceTd">The sourcepath to use.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">sourcepathref</td><td class="confluenceTd">The sourcepath to use given as a path reference.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">encoding</td><td class="confluenceTd">Encoding of source files.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">verbose</td><td class="confluenceTd">Asks the compiler for verbose output; defaults to no.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">includeAntRuntime</td><td class="confluenceTd">Whether to include the Ant run-time libraries in the classpath; defaults to yes.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">includeJavaRuntime</td><td class="confluenceTd">Whether to include the default run-time libraries from the executing VM in the classpath; defaults to no.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">fork</td><td class="confluenceTd">Whether to execute groovyc using a spawned instance of the JVM; defaults to no.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">memoryInitialSize</td><td class="confluenceTd">The initial size of the memory for the underlying VM, if using fork mode; ignored otherwise. Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">memoryMaximumSize</td><td class="confluenceTd">The maximum size of the memory for the underlying VM, if using fork mode; ignored otherwise. Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">failonerror</td><td class="confluenceTd">Indicates whether compilation errors will fail the build; defaults to true.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">listfiles</td><td class="confluenceTd">Indicates whether the source files to be compiled will be listed; defaults to no.</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">stacktrace</td><td class="confluenceTd">if true each compile error message will contain a stacktrace</td><td class="confluenceTd">No</td></tr><tr><td class="confluenceTd">jointCompilationOptions*</td><td class="confluenceTd">Enable joint compilation, specifying the command line options. (Using a nested javac task is preferred.)</td><td class="confluenceTd">No</td></tr><tr><td colspan="1" class="confluenceTd">indy</td><td colspan="1" class="confluenceTd">Enable compilation with the &quot;invoke dynamic&quot; support when using Groovy 2.0 and beyond and running on JDK 7</td><td colspan="1" class="confluenceTd">No</td></tr></tbody></table>Notes: Joint compilation is only available since 1.1-beta-2, jointCompilationOptions is no longer supported, use the nested javac instead<h3>&lt;groovyc&gt; Nested Elements</h3><table class="confluenceTable"><tbody><tr><th class="confluenceTh">element</th><th class="confluenceTh">kind</th><th class="confluenceTh">Required</th><th class="confluenceTh">Replaces Attribute</th></tr><tr><td class="confluenceTd">src</td><td class="confluenceTd">a path structure</td><td class="confluenceTd">Yes (unless srcdir is used)</td><td class="confluenceTd">srcdir</td></tr><tr><td class="confluenceTd">classpath</td><td class="confluenceTd">a path structure</td><td class="confluenceTd">No</td><td class="confluenceTd">classpath</td></tr><tr><td class="confluenceTd">javac</td><td class="confluenceTd">javac task</td><td class="confluenceTd">No</td><td class="confluenceTd">jointCompilationOptions</td></tr></tbody></table>Notes:<ul><li>For path structures see for example <a href="http://ant.apache.org/manual/using.html#path">http://ant.apache.org/manual/using.html#path</a></li><li>For usages of the javac task see <a href="http://ant.apache.org/manual/CoreTasks/javac.html">http://ant.apache.org/manual/CoreTasks/javac.html</a></li><li>The nested javac task behaves more or less as documented for the top-level javac task. srcdir, destdir, classpath, encoding for the nested javac task are taken from the enclosing groovyc task. If these attributes are specified then they are added, they do not replace. In fact, you should not attempt to overwrite the destination. Other attributes and nested elements are unaffected, for example fork, memoryMaximumSize, etc. may be used freely.</li></ul><h3>Joint Compilation</h3>Joint compilation means that the Groovy compilation will parse the Groovy source files, create stubs for all of them, invoke the Java compiler to compile the stubs along with Java sources, and then continue compilation in the normal Groovy compiler way. This allows mixing of Java and Groovy files without constraint.To invoke joint compilation with the jointCompilationOptions attribute, you have to simulate the command line with compiler switches. -j enables the joint compilation mode of working. Flags to the Java compiler are presented to the Groovy compiler with the -F option. So, for example, flags like nowarn are specified with -Fnowarn. Options to the Java compiler that take values are presented to the Groovy compiler using -J options. For example -Jtarget=1.4 -Jsource=1.4 is used to specify the target level and source level. So a complete joinCompilationOptions value may look like: &quot;-j -Fnowarn -Jtarget=1.4 -J-source=1.4&quot;. Clearly, using this way of specifying things is a real nuisance and not very Ant-like. In fact there are thoughts to deprecate this way of working and remove it as soon as is practical.The right way of working is, of course, to use a nested tag and all the attributes and further nested tags as required. It is rare to specify srcdir and destdir, the nested javac task is provided with the srcdir and destdir values from the enclosing groovyc task, and it is invariable the right thing to do just to leave this as is. Here is an example:<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;groovyc srcdir="${testSourceDirectory}" destdir="${testClassesDirectory}">
 &lt;classpath>
 &lt;pathelement path="${mainClassesDirectory}"/>
 &lt;pathelement path="${testClassesDirectory}"/>
 &lt;path refid="testPath"/>
 &lt;/classpath>
 &lt;javac source="1.4" target="1.4" debug="on" />
&lt;/groovyc>
</pre></td></tr></table>To restate: the javac task gets the srcdir, destdir and classpath from the enclosing groovyc task.