README.md

Hsu.Obfuscar.DotNetTool

Use Obfuscar.GlobalTool to obfuscate .NET code.

Package Version

Name	Source	Stable	Preview
Hsu.Obfuscar.DotNetTool	Nuget
Hsu.Obfuscar.DotNetTool	MyGet

Usage

Install Obfuscar.GlobalTool

Global installation:

dotnet tool install --global Obfuscar.GlobalTool --version 2.2.38

Local installation:

dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local Obfuscar.GlobalTool --version 2.2.38

Install Hsu.Obfuscar.DotNetTool

See NuGet.

Configuration

• Add AssemblySearchPath file:

     <PropertyGroup>
         <ObfuscarAssembliesInclude>true</ObfuscarAssembliesInclude>
     </PropertyGroup>

  When you build the project, the obfuscar.xml file will be created to the root folder of project and obfuscar.assemblies.xml will be created to the output folder of project.

• Default obfuscar.xml contents

  <?xml version="1.0"?>
  <Obfuscator>
    <!-- https://docs.obfuscar.com/getting-started/configuration -->
    <!-- https://github.com/obfuscar/obfuscar/blob/master/Obfuscar/Settings.cs -->
    
    <Var name="InPath" value="." />
    <Var name="OutPath" value="obfuscated" />
    <Var name="RenameFields" value="true" />
    <Var name="RenameProperties" value="true" />
    <Var name="RenameEvents" value="true" />
    <Var name="KeepPublicApi" value="true" />
    <Var name="HidePrivateApi" value="true" />
    <Var name="ReuseNames" value="true" />
    <Var name="UseUnicodeNames" value="false" />
    <Var name="UseKoreanNames" value="false" />
    <Var name="HideStrings" value="false" />
    <Var name="OptimizeMethods" value="true" />
    <Var name="SuppressIldasm" value="false" />
  
    <Module file="ConsoleSample.dll">
      <SkipEnums value="true" />
    </Module>
    
    <!-- <Include path="obfuscar.assemblies.xml" /> -->
    <Include path="obfuscar.assemblies.xml" />
  </Obfuscator>

• Default obfuscar.assemblies.xml contents

  <?xml version="1.0"?>
  <Include>
      <AssemblySearchPath path='.' />
  </Include>

  You can also modify the obfuscar.xml file to change the default values.

  You can also modify the AssemblySearchNames property will auto gen AssemblySearchPath in obfuscar.assemblies.xml file.

• AssemblySearchNames

  <PropertyGroup>
      <AssemblySearchNames>Microsoft.CodeAnalysis.dll;Microsoft.CodeAnalysis.CSharp.dll</AssemblySearchNames>
  </PropertyGroup>

• obfuscar.assemblies.xml

  <?xml version="1.0"?>
  <Include>
      <AssemblySearchPath path='C:\Users\Administrator\.nuget\packages\microsoft.codeanalysis.csharp\4.7.0\lib\netstandard2.0' />
      <AssemblySearchPath path='C:\Users\Administrator\.nuget\packages\microsoft.codeanalysis.common\4.7.0\lib\netstandard2.0' />
  </Include>

License

MIT