Task to assemble .net 'Intermediate Language' files. The task will only work on windows until other platforms support csc.exe or an equivalent. ilasm.exe must be on the execute path too.
All parameters are optional: <il/> should suffice to produce a debug build of all *.il files. The option set is roughly compatible with the CSharp class; even though the command line options are only vaguely equivalent. [The low level commands take things like /OUT=file, csc wants /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] It would be nice if someone made all the command line tools consistent (and not as brittle as the java cmdline tools)
The task is a directory based task, so attributes like includes="*.il" and excludes="broken.il" can be used to control the files pulled in. Each file is built on its own, producing an appropriately named output file unless manually specified with outfile
Attribute | Description | Example |
defaultexcludes | indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted. | |
debug | include debug information | true (default) |
excludes | comma separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted. | |
excludesfile | the name of a file. Each line of this file is taken to be an exclude pattern | |
extraOptions | Any extra options which aren't explicitly supported by the ilasm task, primarily because they arent really documented: use ilasm /? to see them | |
failOnError | Should a failed compile halt the build? | "true"(default) |
fullpaths | Should error text provide the full path to files | "true"(default) |
includes | comma separated list of patterns of files that must be included. All files are included when omitted. | |
includesfile | the name of a file. Each line of this file is taken to be an include pattern | |
keyfile | the name of a file containing a private key, with which the assembly output is checksumed and then MD5 signed to have a strong name | |
listing | Produce a listing (off by default). Listings go to the current output stream | "on", "off" (default) |
outputFile | filename of output | "example.exe" |
resourceFile | name of resource file to include | "resources.res" |
srcDir | source directory (default = project directory) | |
targetType | Type of target. library means DLL is output. | "exe"(default), "library" |
verbose | output progress messages | "on", "off" (default) |
Example
<ilasm outputFile="app.exe" verbose="on" listing="on" owner="secret" />