libphonenumber-csharp: Unable to load PhoneNumbers.dll in signed assembly

When depending on PhoneNumbers.dll through NuGet in a project producing a strong name signed assembly this exception is thrown each time PhoneNumbers.dll would be used: System.IO.FileLoadException: Could not load file or assembly 'PhoneNumbers, Version=8.8.10.0, Culture=neutral, PublicKeyToken=null' or one of its dependencies. A strongly-named assembly is required. (Exception from HRESULT: 0x80131044) File name: 'PhoneNumbers, Version=8.8.10.0, Culture=neutral, PublicKeyToken=null'

This can be fixed by strong name signing PhoneNumbers.dll see PR #51

About this issue

  • Original URL
  • State: closed
  • Created 9 years ago
  • Comments: 16 (8 by maintainers)

Most upvoted comments

I don’t need strong name signing personally, but my 2c is it’s the right thing to do for libraries.

The msft documentation you linked says:

Because of the viral nature of strong-naming, it is recommended that publicly published .NET libraries are strong-named. Not strong-naming a .NET library excludes anyone who does need to strong-name their application or library from using it. Read more about .NET libraries and strong-naming in the .NET Library Guidance.

Strong name signing is not a security measure, it only provides a unique identity to an assembly.

The pros of strong name signing are:

  • Can be installed into GAC, or executed from COM, and it’s also a requirement for ClickOnce
  • Signed libraries can be used by both signed assemblies and unsigned assemblies, while unsigned libraries can only be used in unsigned assemblies.
  • SN is ignored in more modern frameworks (eg. .NET/core) so makes no difference there
  • Two different versions of the assembly can now be loaded at the same time
  • It’s non-trivial for a developer to strong name sign the package themselves: clone the repo, compile it, sign it, then copy the .dll into their project. Repeat when there is an update.

The cons:

  • You can only depend on libraries which are also SN signed (but I don’t think that applies here, as there are no dependencies)
  • Binding redirects can suck, but if you’re a .Net Framework developer you’ll be used to it, and it’s not always an issue.
  • Replacing a strong name signed dll with a compatible newer version (eg. to fix a bug) may not be possible without also replacing the exe.

How to do it?

  • Generate a .snk using sn.exe and check it in to the root of the repo.
  • Add SignAssembly and AssemblyOriginatorKeyFile to the csproj

Conclusion:

  • Strong name signing is free and easy to do.
  • For users of dotnet/core, this has zero impact whatsoever.
  • For users of .Net Framework, users requiring strong name signing will now be able to use the library. Users who do not use strong name signing may or may not be slightly inconvenienced depending on their specific setup, but there are common/expected workarounds and processes to deal with this.

In regards to this snippet you copied:

DO NOT add, remove, or change the strong naming key. Modifying an assembly’s strong naming key changes the assembly’s identity and breaks compiled code that uses it.

Yes, this is true, anybody who is updating the nuget package (eg. from v1 to v2) will need to re-compile their app. But I hardly see this as a problem. Who in their right mind updates a NuGet package by dropping in a new dll, without recompiling their software?

Please note that the author of the second link had second thoughts later in 2018:

https://www.pedrolamas.com/2018/09/11/start-strong-naming-your-assemblies/

Just some feedback to the quoted comment:

DO NOT add, remove, or change the strong naming key. Modifying an assembly’s strong naming key changes the assembly’s identity and breaks compiled code that uses it.

Applying common sense, the strong name would and likely should be applied moving forward. This would NOT impact current assemblies from previous releases and thus would not impact anyone using them. Nobody in their right mind would delay sign an in use assembly, unless it is required.

In short, I am all for strong naming and it will be required moving forward in several of my own projects using this library.

Perhaps the author might provide two NuGet packages, one signed and the other not.

This has been brought up a few times. https://github.com/twcclegg/libphonenumber-csharp/issues/18, https://github.com/twcclegg/libphonenumber-csharp/issues/48 and that which it references https://github.com/octokit/octokit.net/issues/405 Given that it has come up a few times now I’m going to take another look at it and make sure it don’t cause issue for any existing users.

Hi @twcclegg - Any update on this? We need strongly named version. Thanks