How to Fix the dreaded `Version conflict;` NuGet error in your Xamarin.Android projects


2 min read

It's a sunny day, your coffee is still hot, and you're ready to take on the world. You go to install a NuGet package into your Xamarin project, and that's when your day starts to fall apart:

Package restore failed.

This is not what you wanted to see.

NU1107: Version conflict detected for Xamarin.Android.Support.Compat. Reference the package directly from the project to resolve this issue. 
     MyApp -> Xamarin.Essentials -> Xamarin.Android.Support.CustomTabs 27.0.2 -> Xamarin.Android.Support.Compat (= 27.0.2) 
     MyApp -> Xamarin.Forms -> Xamarin.Android.Support.v4 -> Xamarin.Android.Support.Compat (=

All you wanted was to install a new package, or update an existing package, and your day just got more difficult.

Wait, we can fix this!

This is something that a lot of users encounter, especially when dealing with Xamarin.Android projects as they tend to all require Android Support libraries, which necessarily have a very complex dependency chain.

While this can be a daunting error to run into, if we take another sip of coffee and truly look at the error message, it becomes a bit more clear the action we need to take.

Let's pick this error apart. What it's telling us is:

  • Xamarin.Essentials requires some Xamarin.Android.Support bits >= 27.0.2
  • Xamarin.Forms requires some Xamarin.Android.Support bits >=

It's important to remember that a requirement of Android Support libraries is that they must all have the same version number in your project.

What NuGet is trying to tell us is that it can't figure out which version of Xamarin.Android.Support.Compat you want it to install, since your dependencies can't agree on what that version should be.

The solution is to help NuGet out a bit, by explicitly declaring the version it should use, in this case we can more easily deduce that since Xamarin.Forms is fine with Android Support greater than and since Xamarin.Essentials requires at least 27.0.2, we should pick 27.0.2 to install:

<PackageReference Include="Xamarin.Android.Support.Compat" Version="27.0.2" />

Now, you may run into this same type of issue multiple times in your project. In that case, just keep adding explicitly versioned dependency declarations to your project as NuGet asks you to help it decide.

I've also made a video to illustrate the process, which you can view below: