Command Line Reference
Agile.NET can be driven by the command line. This enables you to execute it as part of your build process (for example as a step in your build script or CI/CD pipeline).
To execute the command line tool, open a command prompt and cd to the Agile.NET application folder. This is normally:
C:\Program Files\Secureteam\Agile.NET
Type:
AgileDotNet.Console /?
to view the help message.
Usage
AgileDotNet.Console.exe [/Project:<project_file>] [/target:<file>] [/Obfuscate] [/Secure] [/Out:<path>] [/help]
Options
| Option | Description |
|---|---|
| /Project:<project_file> | Specifies a project file that will be used to read and apply processing settings. You can use the Agile.NET UI tool to generate a project file to be used with the command line. |
| /target:<file> | Identifies the target assembly. To specify more than one assembly, separate each assembly with a semicolon. Example: /target:C:\App.exe;C:\AppDependsOn.dll |
| /Out:<path> | Specifies the directory for the protected file(s). |
| /SecureStrings | Instructs Agile.NET to secure user strings embedded within an assembly. User strings may include sensitive data such as license codes, time lock expiration date, database connection string, etc. Setting this option will encrypt those strings and hand them to the jitter only when they are demanded by your application code. (Short form: /us) |
| /Secure | Instructs Agile.NET to secure the IL code stored in an assembly. Upon execution it binds to the .NET execution engine, handing it the code for execution. The MSIL code is never kept inside the memory space of your application. |
| /Obfuscate | Instructs Agile.NET to obfuscate an assembly. |
| /ObfuscationMap | The file name used to document the mapping between original symbols (such as class and method names) and their obfuscated equivalents. |
| /UseUnprintableChars | Sets the renaming scheme to use unprintable characters. Unprintable characters are commonly displayed as an unrecognizable character such as a small block, an underscore, a space, etc. (Short form: /u) |
| /RedistFileName | Sets the file name of the native runtime component that needs to be redistributed with the protected code (x86 platform). |
| /Redist64FileName | Sets the file name of the native runtime component that needs to be redistributed with the protected code (x64 platform). |
| /Resign:<signature_file> | Resigns any strong named or delay-signed assembly using the signature file provided. |
| /DisableRuntimeEmbedding | If set to true, native runtime components are created during the protection process. Using this option you'll have to package the runtime components and ship them together with the protected assemblies. |
| /help | Displays a detailed help screen. (Short form: /?, /h) |
Exit Codes
| Exit Code | Definition |
|---|---|
| 0 | Success. |
| 1 | Error occurred. A warning message is displayed explaining why and how the failure occurred. |