Class ObfuscateTask

This is an MSBuild task to automate obfuscation using ArmDot.

Read more about how to use ObfuscateTask to obfuscate assemblies while building a project.

Inheritance

System.Object

ObfuscateTask

Namespace: ArmDot.Engine.MSBuildTasks

Assembly: ArmDot.Engine.MSBuildTasks.dll

Syntax

public class ObfuscateTask : Build.Utilities.Task, IAsyncOperationEvents

Properties

EmbeddedFiles

Inputs stores a list of files to embed.

Notes: use %24 to encode $

For example, use %24(AssemblyDirectory) to encode $(AssemblyDirectory)

<ItemGroup>
  <FilesInfo Include="$(TargetDir)Embed\virtual_file_content2.txt">
    <RuntimePath>%24(AssemblyDirectory)\embedded_file2.txt</RuntimePath>
  </FilesInfo>
  <FilesInfo Include="$(TargetDir)Embed\virtual_file_content3.txt">
    <RuntimePath>%24(AssemblyDirectory)\embedded_file3.txt</RuntimePath>
  </FilesInfo>
</ItemGroup>

<Target Name="Protect" AfterTargets="Build">
  <ItemGroup>
     <Assemblies Include="$(TargetDir)$(TargetFileName)" />
  </ItemGroup>
  <ArmDot.Engine.MSBuildTasks.ObfuscateTask
    Inputs="@(Assemblies)"
    EmbeddedFiles="@(FilesInfo)" />
</Target>

This parameter is optional.

Declaration

public ITaskItem[] EmbeddedFiles { get; set; }

Property Value

Type	Description
ITaskItem[]

Inputs

Inputs stores a list of assemblies to protect:

<Target Name="Protect" AfterTargets="Build">
  <ItemGroup>
     <Assemblies Include="$(TargetDir)$(TargetFileName)" />
  </ItemGroup>
  <ArmDot.Engine.MSBuildTasks.ObfuscateTask Inputs="@(Assemblies)" />
</Target>

This parameter is required.

Declaration

public ITaskItem[] Inputs { get; set; }

Property Value

Type	Description
ITaskItem[]

License

Set it to a purchased ArmDot license key.

If License is not set, ArmDot works in the demo mode.

This parameter is optional.

Declaration

public string License { get; set; }

Property Value

Type	Description
System.String

NoWarn

Suppresses the ArmDot's ability to generate warnings.

NoWarn specifies warning number or numbers.

If you specify multiple warning numbers, separate them with a comma:

<Target Name="Protect" AfterTargets="Build">
  <ItemGroup>
     <Assemblies Include="$(TargetDir)$(TargetFileName)" />
  </ItemGroup>
  <ArmDot.Engine.MSBuildTasks.ObfuscateTask
    Inputs="@(Assemblies)"
    NoWarn="4" />
</Target>

This parameter is optional.

Declaration

public string NoWarn { get; set; }

Property Value

Type	Description
System.String

ProjectPath

ProjectPath specifies a path to a project file that is used to store cryptography constants to generate license keys, and blacklisted license keys.

If ProjectPath doesn't exist, a new project file is created.

Declaration

public string ProjectPath { get; set; }

Property Value

Type	Description
System.String

Methods

Execute()

You never call this method.

Declaration

public override bool Execute()

Returns

Type	Description
System.Boolean

OnError(String)

You never call this method.

Declaration

public void OnError(string text)

Parameters

Type	Name	Description
System.String	text

OnFinished(Exception)

You never call this method.

Declaration

public void OnFinished(Exception error)

Parameters

Type	Name	Description
System.Exception	error

OnInfo(String)

You never call this method.

Declaration

public void OnInfo(string text)

Parameters

Type	Name	Description
System.String	text

OnProgress(Int32)

You never call this method.

Declaration

public void OnProgress(int percent)

Parameters

Type	Name	Description
System.Int32	percent

OnWarning(BaseWarning)

You never call this method.

Declaration

public void OnWarning(BaseWarning warning)

Parameters

Type	Name	Description
ArmDot.Engine.Warnings.BaseWarning	warning