Skip to content

A .NET Core CLI tool for strong-name keys and assembly signing.

License

Notifications You must be signed in to change notification settings

AppCoreNet/SigningTool

Repository files navigation

AppCore .NET Signing Tool

Build Status

The AppCore .NET Signing Tool is a .NET CLI tool which can be used to sign assemblies.

The motivation behind this project is to provide a cross-platform replacement of the 'sn' tool provided by the classic .NET Framework.

Installation

The tool is distributed as a NuGet package and can be easily installed by invoking the following command:

dotnet tool install -g AppCore.SigningTool

Usage

The tool can be invoked using the command dotnet-signtool. If you need help about available commands and options add --help to the command line.

Quickstart

The easiest way to add strong-naming to your assemblies is by signing them directly during the build.

First, create a key pair using the following command:

dotnet-signtool create-key my_key.snk

Next, edit your project file and add the following tags:

<PropertyGroup>
  <SignAssembly>true</SignAssembly>
  <AssemblyOriginatorKeyFile>my_key.snk</AssemblyOriginatorKeyFile>
</PropertyGroup>

For more information please read the Microsoft Docs about strong-named assemblies.

Contributing

Contributions, whether you file an issue, fix some bug or implement a new feature, are highly appreciated. The whole user community will benefit from them.

If you want to try out the latest development version you can specify our MyGet feed during installation:

dotnet tool install -g AppCore.SigningTool --add-source https://www.myget.org/F/appcorenet/api/v3/index.json

Please refer to the Contribution guide.