|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.tools.ant.ProjectComponent | +--org.apache.tools.ant.Task | +--org.apache.tools.ant.taskdefs.MatchingTask | +--org.apache.tools.ant.taskdefs.optional.dotnet.Ilasm
Assembles .NET Intermediate Language files. The task will only work on win2K 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
Field Summary | |
protected boolean |
debug
debug flag. |
protected static java.lang.String |
exe_name
Name of the executable. |
protected static java.lang.String |
exe_title
title of task for external presentation |
protected java.lang.String |
extraOptions
any extra command options? |
protected boolean |
failOnError
flag to control action on execution trouble |
protected static java.lang.String |
file_ext
what is the file extension we search on? |
protected static java.lang.String |
file_pattern
and now derive the search pattern from the extension |
protected boolean |
listing
listing flag |
protected java.io.File |
outputFile
output file. |
protected java.io.File |
resourceFile
resource file (.res format) to include in the app. |
protected java.lang.String |
targetType
type of target. |
protected boolean |
verbose
verbose flag |
Fields inherited from class org.apache.tools.ant.taskdefs.MatchingTask |
fileset, useDefaultExcludes |
Fields inherited from class org.apache.tools.ant.Task |
description, location, target, taskName, taskType, wrapper |
Fields inherited from class org.apache.tools.ant.ProjectComponent |
project |
Constructor Summary | |
Ilasm()
constructor inits everything and set up the search pattern |
Method Summary | |
void |
Clear()
reset all contents. |
void |
execute()
This is the execution entry point. |
void |
executeOneFile(java.lang.String targetFile)
do the work for one file by building the command line then calling it |
boolean |
getDebug()
query the debug flag |
protected java.lang.String |
getDebugParameter()
get the argument or null for no argument needed |
java.lang.String |
getExtraOptions()
Gets the ExtraOptions attribute |
protected java.lang.String |
getExtraOptionsParameter()
get any extra options or null for no argument needed |
boolean |
getFailFailOnError()
query fail on error flag |
protected java.lang.String |
getKeyfileParameter()
get the argument or null for no argument needed |
protected java.lang.String |
getListingParameter()
turn the listing flag into a parameter for ILASM |
protected java.lang.String |
getOutputFileParameter()
get the output file |
protected java.lang.String |
getResourceFileParameter()
Gets the resourceFileParameter attribute of the Ilasm task |
java.lang.String |
getTargetType()
accessor method for target type |
protected java.lang.String |
getTargetTypeParameter()
g get the target type or null for no argument needed |
protected java.lang.String |
getVerboseParameter()
turn the verbose flag into a parameter for ILASM |
protected boolean |
notEmpty(java.lang.String s)
test for a string containing something useful |
void |
setDebug(boolean f)
set the debug flag on or off. |
void |
setExtraOptions(java.lang.String extraOptions)
Any extra options which are not explicitly supported by this task. |
void |
setFailOnError(boolean b)
If true, fails if ilasm tool fails. |
void |
setKeyfile(java.io.File keyfile)
the name of a file containing a private key. |
void |
setListing(boolean b)
If true, produce a listing (off by default). |
void |
setOutputFile(java.io.File params)
Set the output file. |
void |
setOwner(java.lang.String s)
Sets the Owner attribute. |
void |
setResourceFile(java.io.File fileName)
name of resource file to include. |
void |
setSrcDir(java.io.File srcDirName)
Set the source directory containing the files to be compiled. |
void |
setTargetType(java.lang.String targetType)
Sets the type of target, either "exe" or "library". |
void |
setVerbose(boolean b)
If true, enable verbose ILASM output. |
Methods inherited from class org.apache.tools.ant.taskdefs.MatchingTask |
addAnd, addContains, addCustom, addDate, addDepend, addDepth, addFilename, addMajority, addNone, addNot, addOr, addPresent, addSelector, addSize, appendSelector, createExclude, createExcludesFile, createInclude, createIncludesFile, createPatternSet, getDirectoryScanner, getSelectors, hasSelectors, selectorCount, selectorElements, setCaseSensitive, setDefaultexcludes, setExcludes, setExcludesfile, setFollowSymlinks, setIncludes, setIncludesfile, setProject, XsetIgnore, XsetItems |
Methods inherited from class org.apache.tools.ant.Task |
getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorOutput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName |
Methods inherited from class org.apache.tools.ant.ProjectComponent |
getProject |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected static final java.lang.String exe_name
protected static final java.lang.String file_ext
protected static final java.lang.String file_pattern
protected static final java.lang.String exe_title
protected java.lang.String targetType
protected boolean verbose
protected boolean listing
protected java.io.File outputFile
protected java.io.File resourceFile
protected boolean failOnError
protected boolean debug
protected java.lang.String extraOptions
Constructor Detail |
public Ilasm()
Method Detail |
public void Clear()
public void setSrcDir(java.io.File srcDirName)
srcDirName
- The new SrcDir valuepublic void setTargetType(java.lang.String targetType) throws BuildException
targetType
- one of exe|library|
BuildException
- if target is not one of
exe|librarypublic java.lang.String getTargetType()
protected java.lang.String getTargetTypeParameter()
public void setOwner(java.lang.String s)
s
- The new Owner valueprotected boolean notEmpty(java.lang.String s)
s
- any string
public void setVerbose(boolean b)
b
- flag set to true for verbose onprotected java.lang.String getVerboseParameter()
public void setListing(boolean b)
b
- flag set to true for listing onprotected java.lang.String getListingParameter()
public void setOutputFile(java.io.File params)
params
- The new outputFile valueprotected java.lang.String getOutputFileParameter()
public void setResourceFile(java.io.File fileName)
fileName
- path to the file. Can be relative, absolute, whatever.protected java.lang.String getResourceFileParameter()
public void setFailOnError(boolean b)
b
- The new failOnError valuepublic boolean getFailFailOnError()
public void setDebug(boolean f)
f
- on/off flagpublic boolean getDebug()
protected java.lang.String getDebugParameter()
public void setKeyfile(java.io.File keyfile)
keyfile
- The new keyfile valueprotected java.lang.String getKeyfileParameter()
public void setExtraOptions(java.lang.String extraOptions)
extraOptions
- The new ExtraOptions valuepublic java.lang.String getExtraOptions()
protected java.lang.String getExtraOptionsParameter()
public void execute() throws BuildException
execute
in class Task
BuildException
- if the assembly failed and FailOnError is truepublic void executeOneFile(java.lang.String targetFile) throws BuildException
targetFile
- name of the the file to assemble
BuildException
- if the assembly failed and FailOnError is true
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |