.NET Assembly Strong-Name Signer
- Posted in:
- Automation
- Software
-- Download (v3.5.0.0) --
-- NuGet Package --
Automatic strong-name signing of referenced assemblies. Build tasks and utility software to strong-name sign .NET assemblies, including assemblies you do not have the source code for. If you strong-name sign your own projects you may have noticed that if you reference an unsigned third party assembly you get an error similar to “Referenced assembly 'A.B.C' does not have a strong name”. If you did not create this assembly, you can use this tool to sign the assembly with your own (or temporarily generated) strong-name key. The tool will also re-write the assembly references (as well as any InternalsVisibleTo references) to match the new signed versions of the assemblies you create.
Why?
I decided to write this tool because I have needed to sign assemblies myself a number of times. When contacting the developer fails, it leaves you little choice. You either leave your projects unsigned which is often not an option, or find a way around the problem.
I first learnt how to do this trick from OJ Reeve’s article on signing and unsigned assembly. The information is somewhat dated and doesn’t mention using the /TYPELIST option which is crucial to make the round-trip in some scenarios. There are some other tools out there that do this but are also out of date, lack features, are difficult to configure and sometimes create unpredictable results.
Developers still struggle to overcome this problem so I wanted to create a really simple UI, command-line and API to simplify the process. I used the existing tools for inspiration and made sure that Strong-Name Signer overcame all the issues that they currently have.
Strong-Name Signer
This application is the answer to your assembly signing needs. Whether you prefer to use an GUI, the command-line or an API, Strong-Name Signer covers all those bases.
Features
- Supports strong-name signing assemblies built in v1.0 to v4.5 of the .NET framework.
- Accessible via GUI, command-line or programmatic API.
- Round-trips assembly attributes (32-bit preferred, x64 only etc.) correctly.
- No need for an existing SNK file, one can be generated for you.
- Automatically backs up your files before signing.
- Does not require specific command-prompts or framework/SDK tools.
- Update BAML resources with new references.
User Interface
Drag-and-drop files or directories and .NET assemblies will be detected. Kept it very simple so it’s accessible and understandable by any user.
Console
Simple command-line options to automate from script files. At minimum you can provide an assembly file, the rest will be done automatically.
API
A public API is exposed you can reference Brutal.Dev.StrongNameSigner.dll and make use of the static methods on SigningHelper to perform strong-name signing tasks from code or PowerShell scripts.
-- Download (v3.5.0.0) --
-- NuGet Package --
Other Existing Tools
I investigated the following tools when developing Strong-Name Signer. I want to give the authors credit since it was the shortcomings in these tools that were the basis for a lot of the features in Strong-Name Signer.
Assembly Signer
This tool was last released in 2010 and contains some bugs that don’t make it a very reliable option.
- Manual configuration to identify external tools location.
- Doesn’t handle spaces in assembly paths.
- Fails on certain round-trips (not using /TYPELIST).
- Requires an existing SNK file.
- Can only sign DLL files and not EXE files (which are also assemblies).
- Requires user input from the command-line / cannot be easily automated.
- Can cause problems for a 2.0 assembly if the wrong tools are used.
- Fails to recompile 64-bit platform targeted assemblies.
- No graphical user interface.
Signer
This tool appears to be the most promising but has been abandoned since early 2007. It does most things correctly but has a number of open bugs that Strong-Name Signer fixes. I had the option of contributing to this project but I wanted to change the architecture in a way that I could unit test the functionality easily.
- Requires running in Visual Studio 2005 command-prompt (2010 does not work).
- Does not support .NET 4.x+ assemblies.
- Requires an existing SNK file.
- Requires special handling to recompile 64-bit platform targeted assemblies.
- Performs manual re-writing of IL that are not required anymore with newer tools.
- No graphical user interface.
Open Source
The source code for this project is available on GitHub.