|
|
@@ -221,6 +221,200 @@ Example |
|
|
|
/> |
|
|
|
</pre> |
|
|
|
<hr> |
|
|
|
<h2><VBC></h2> |
|
|
|
|
|
|
|
This task compiles VisualBasic.NET source into executables or modules. |
|
|
|
|
|
|
|
This task compiles VisualBasic.NET source into executables or modules. |
|
|
|
The task will only work on win2K/XP or other platforms with vbc.exe |
|
|
|
or an equivalent. VBC must be on the execute path. |
|
|
|
|
|
|
|
<p> |
|
|
|
All parameters are optional: <vbc/> should suffice to produce a debug |
|
|
|
build of all *.vb files. References to external files do require explicit |
|
|
|
enumeration, so are one of the first attributes to consider adding. </p> |
|
|
|
|
|
|
|
<p> |
|
|
|
|
|
|
|
The task is a directory based task, so attributes like |
|
|
|
<b>includes="**/*.vb"</b> and |
|
|
|
<b>excludes="broken.vb"</b> can be used to control |
|
|
|
the files pulled in. By default, |
|
|
|
all *.vb files from the project folder down are included in the command. |
|
|
|
When this happens the destFile -if not specified- |
|
|
|
is taken as the first file in the list, which may be somewhat hard to control. |
|
|
|
Specifying the output file with <b>'destfile'</b> seems prudent. </p> |
|
|
|
<p> |
|
|
|
Also, dependency checking only works if destfile is set. |
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0"> |
|
|
|
<tr> |
|
|
|
<td valign="top"><b>Attribute</b></td> |
|
|
|
<td valign="top"><b>Description</b></td> |
|
|
|
<td align="center" valign="top"><b>Example Values</b></td> |
|
|
|
</tr> |
|
|
|
|
|
|
|
<tr> |
|
|
|
<td valign="top">additionalModules</td> |
|
|
|
<td valign="top">Semicolon separated list of modules to refer to</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">defaultexcludes</td> |
|
|
|
<td valign="top">indicates whether default excludes should be used or not |
|
|
|
</td> |
|
|
|
<td valign="top">"true"(default) or "false"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">definitions</td> |
|
|
|
<td valign="top">defined constants</td> |
|
|
|
<td valign="top"> "RELEASE;BETA1"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">debug</td> |
|
|
|
<td valign="top">include debug information</td> |
|
|
|
<td valign="top">"true"(default)</td> |
|
|
|
</tr> |
|
|
|
|
|
|
|
<tr> |
|
|
|
<td valign="top">destFile</td> |
|
|
|
<td valign="top">name of exe/library to create</td> |
|
|
|
<td valign="top">"example.exe"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">excludes</td> |
|
|
|
<td valign="top">comma- or space-separated list of patterns of files that must be |
|
|
|
excluded. No files (except default excludes) are excluded when omitted.</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">excludesfile</td> |
|
|
|
<td valign="top">the name of a file. Each line of this file is |
|
|
|
taken to be an exclude pattern</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">extraOptions</td> |
|
|
|
<td valign="top">Any extra options which aren't explicitly |
|
|
|
supported by the VisualBasicCompile task </td> |
|
|
|
<td>"/warnaserror+ /baseaddress:0x12840000"</td> |
|
|
|
</tr> |
|
|
|
|
|
|
|
<tr> |
|
|
|
<td valign="top">failOnError</td> |
|
|
|
<td valign="top">Should a failed compile halt the build?</td> |
|
|
|
<td valign="top">"true"(default) or "false"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">imports</td> |
|
|
|
<td valign="top">comma-separated list of global imports for namespaces |
|
|
|
in referenced metadata files.</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">includes</td> |
|
|
|
<td valign="top">comma- or space-separated list of patterns of files that must be |
|
|
|
included. All files are included when omitted.</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">includesfile</td> |
|
|
|
<td valign="top">the name of a file. Each line of this file is |
|
|
|
taken to be an include pattern</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">mainClass</td> |
|
|
|
<td valign="top">name of main class for executables</td> |
|
|
|
<td valign="top">"com.example.project.entrypoint"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">optimize</td> |
|
|
|
<td valign="top">optimisation flag</td> |
|
|
|
<td valign="top">"true" or "false"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">optionCompare</td> |
|
|
|
<td valign="top">Text or binary string comparisons.</td> |
|
|
|
<td valign="top">"text" or "binary"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">optionExplicit</td> |
|
|
|
<td valign="top">Require explicit declaration of variables?</td> |
|
|
|
<td valign="top">"true" or "false"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">optionStrict</td> |
|
|
|
<td valign="top">Enforce strict language semantics?</td> |
|
|
|
<td valign="top">"true" or "false"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">references</td> |
|
|
|
<td valign="top">Semicolon separated list of dlls to refer to</td> |
|
|
|
<td valign="top">"mylib.dll;nunit.dll"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">referenceFiles </td> |
|
|
|
<td valign="top">Ant Path descriptioon of references to include. |
|
|
|
Wildcards should work. </td> |
|
|
|
<td valign="top"></td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">removeIntChecks</td> |
|
|
|
<td valign="top">Remove integer checks?</td> |
|
|
|
<td valign="top">"true" or "false"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">rootNamespace</td> |
|
|
|
<td valign="top">Root namespace for all type declarations.</td> |
|
|
|
<td valign="top">com.example</td> |
|
|
|
</tr> |
|
|
|
|
|
|
|
<tr> |
|
|
|
<td valign="top">srcDir</td> |
|
|
|
<td valign="top">source directory (default = project directory)</td> |
|
|
|
<td valign="top">"."</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">targetType</td> |
|
|
|
<td valign="top">Type of target</td> |
|
|
|
<td valign="top">"exe", "module", "winexe" or "library"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">utf8output</td> |
|
|
|
<td valign="top">require all compiler output to be in utf-8 format</td> |
|
|
|
<td valign="top">"true" or "false"(default)</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">warnLevel</td> |
|
|
|
<td valign="top">level of warning currently between 1 and 4 with 4 |
|
|
|
being the strictest. </td> |
|
|
|
<td valign="top">"1"-"4"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">win32Icon</td> |
|
|
|
<td valign="top">filename of icon to include</td> |
|
|
|
<td valign="top">"res/myicon.ico"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">win32res</td> |
|
|
|
<td valign="top">filename of a win32 resource (.RES)file to include |
|
|
|
This is not a .NET resource, but it what windows is used to.</td> |
|
|
|
<td valign="top">"res/myapp.res"</td> |
|
|
|
</tr> |
|
|
|
|
|
|
|
</table> |
|
|
|
<p> |
|
|
|
Example |
|
|
|
</p> |
|
|
|
<pre><vbc |
|
|
|
optimize="true" |
|
|
|
debug="false" |
|
|
|
warnLevel="4" |
|
|
|
targetType="exe" |
|
|
|
definitions="RELEASE" |
|
|
|
excludes="src/unicode_class.vb" |
|
|
|
mainClass = "MainApp" |
|
|
|
destFile="NetApp.exe" |
|
|
|
optionExplicit="true" |
|
|
|
optionCompare="text" |
|
|
|
/> |
|
|
|
</pre> |
|
|
|
<hr> |
|
|
|
<h2><ilasm></h2> |
|
|
|
<p>Task to assemble .net 'Intermediate Language' files. |
|
|
|
The task will only work on windows until other platforms support csc.exe or |
|
|
|