MSBuild

Top  Previous  Next

DeepSea Obfuscator comes with an MSBuild <DeepSeaObfuscation> task found in DeepSea.MSBuild.dll assembly in the program files folder.

This task is typically used in the Visual Studio integration, but can also be used outside Visual Studio.

Task parameters

Attribute

Type

Description

Required

Assemblies

Items

Array of task items specifying all assemblies that should be obfuscated.

True

References

Items

Array of task items specifying all assemblies used as reference assembly in on the the obfuscated assemblies.

False

DstDir

directory

The output directory.

False

ReferenceFolders

directories

Directories in which reference assemblies are searched.

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.

False

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.

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

Sample

The following sample will obfuscate the assembly MyComponent.dll to the Out directory relative to the directory that contains MyComponent.dll.

<DeepSeaObfuscate

 Assemblies="MyComponent.dll"

 DstDir="Out"

/>