NAnt

Top  Previous  Next

DeepSea Obfuscator comes with a NAnt <deepsea> task found in DeepSea.NAnt.dll assembly in the program files folder.

Task parameters

Attribute

Type

Description

Required

todir

directory

The output directory.

False

mapdir

directory

The directory where the obfuscation map is written to.

False

mapfile

file

File name and folder of the obfuscation map.

This setting overwrites the mapdir attribute.

False

configfile

file

File name and folder of an external configuration file. The external configuration is used in additional to obfuscation attributes found in the assemblies.


inputmapfiles

file(s)

File name and folder of an input map file(s). Input map files are used to rename types & members to the same name for each obfuscation. Typically used to deploy partial updates. Multiple filenames can be separated by a semi colon ';'.

False

keyfile

file

Strong name key used to re-sign strong named assemblies.

False

keypassword

password

Password of strong name key (for pfx keys)

False

signfile

file

Code signing certificate used to sign the obfuscated assemblies with.

False

signpassword

password

Password of the code signing certificate.

False

verify

None, All, IL, MD

Set the assembly verification mode.

None: No verification

All: Verify both IL and metadata.

IL: Verify only IL

MD: Verify only metadata.

False

xapexcludes

pattern

Exclude all assembly parts in a XAP file that match the given pattern from obfuscation. Multiple patterns can be separated by a semi colon ';'.

False

xapincludes

pattern

Include all assembly parts in a XAP file that match the given pattern in the obfuscation process. Include overrides Exclude and default behavior. Multiple patterns can be separated by a semi colon ';'.

False

failonwarnings

bool

If true, the obfuscation will fail when error warnings are raised.

False

failonevaluation

bool

If true, the obfuscation will fail when running in evaluation mode.

False

quiet

bool

If true, all information except for warnings and errors will be suppressed.

False

Nested elements

Element

Type

Description

Required

assemblies

assembly-fileset

A fileset specifying all assemblies that should be obfuscated.

True

references

assembly-fileset

A fileset specifying all assemblies used as reference assembly in on the the obfuscated assemblies.

The nested <lib> element can be used to pass reference directories.

False

Sample

In the following sample, DeepSea Obfuscator will obfuscate all assemblies with the dll extension in the ${basedir} directory. The obfuscated assemblies will be written to ${basedir}\Out.

The nant.core.dll assembly is referenced.

 

<deepsea todir="${basedir}\Out">

 <assemblies basedir="${basedir}">

         <include name="*.dll"/>

 </assemblies>

 <references>

         <lib>

                 <include name="${basedir}\Binaries"/>

         </lib>        

         <include name="nant.core.dll" />

 </references>

</deepsea>