We’ve just released NServiceBus.Unity 8.1.3.
Changing the way we handle our Unity dependency
The Unity project is now being maintained by the community. This is a good thing. We now have .NET standard support, bugs are being fixed, and after a break we are now getting improvements.
Here at Particular Software we follow SemVer for our NuGet packages. Unfortunately not all of our dependencies strictly follow SemVer and Unity has recently introduced breaking changes in non-major versions. This does not work well when combined with broad dependency ranges in our NuGet packages.
We don’t want to stop you upgrading to the latest version of Unity. We will attempt to keep the optimistically broadest possible compatibility range in our NuGet packages.
This means our package will be dependent on the latest version of Unity we have compiled and tested against, through to the next major version of Unity. We strongly recommend testing dependency updates to Unity prior to running in production.
We will do our best to identify breaking changes as soon as possible, but we may not catch everything. If you notice a breaking change, please do not hesitate to let us know by raising an issue.
Breaking changes in Unity will be handled as follows:
- Changes that require a change to our own API (e.g. changes to
IUnityContainer) will be released in a new major version.
- Changes that do not require a change to our own API will be released as a hotfix to the latest minor version.
- If Unity releases a new major version, we will take a dependency on that version in a new minor version of our package.
- #70 Exception during UseContainer on endpointconfiguration-instance
- #72 Unity 5.7.4 introduces breaking API change
How to know if you are affected
You are affected if you are trying to use Unity 5.7.3 or later with NServiceBus.Unity 8.1.2 or before.
At runtime you receive a
MissingMethodException exception for
Should you upgrade immediately
If you are using Unity 5.7.3 or later, with NServiceBus version 6, you should upgrade.
Where to get it
You can download the updated version and see the full release notes here: https://github.com/Particular/NServiceBus.Unity/releases/tag/8.1.3.
The team in Particular
Please read our release policy for more details.