Pre requisites to build ADAL.NET and MSAL.NET

Components required to build the library

The following are instructions to setup Visual Studio to build the LibsAndSamples.sln or LibsNoSamples.sln

Minimal Visual Studio 2019 installation

We recommend using MSAL

• Install or update Visual Studio 2019 (any edition: Community, Pro, or Enterprise) with the following workloads:

  • .NET desktop development
  • Universal Windows Platform development
  • Mobile Development with .NET
  • .NET Core cross-platform development

• Then from the "Individual Components" tab,make sure these additional items are selected:

  • .NET Framework 4.5 targeting pack
  • .NET Framework 4.5.2 targeting pack
  • .NET Framework 4.6.1 SDK
  • .NET Framework 4.6.1 targeting pack
  • .NET Framework 4.6.2 targeting pack
  • Android SDK setup (API level 29)
  • Windows 10 SDK 10.0.17134.0
  • Windows 10 SDK 10.0.17763.0

• Android 9.0 Pie and Android 8.1 Oreo are also required. These are not necessarily installed through the VS Installer, so instead use the Android SDK Manager (Visual Studio > Tools > Android > Android SDK Manager…)

Troubleshooting

• If you get an exception similar to "System.InvalidOperationException: Could not determine Android SDK location" while restoring the NuGet packages, make sure you have the latest Android SDK installed (29 at the time of writing). If you do, you probably hit a bug with the VS installer - uninstall and reinstall the SDK from the Visual Studio Installer.
• IF you get an exception similar to "{System.TypeLoadException: Could not set up parent class, due to: Could not load type of field 'Microsoft.Identity.Core.UI.WebviewBase:asWebAuthenticationSession' (5) due to: Could not resolve type with token 0100004c from typeref (expected class 'AuthenticationServices.ASWebAuthenticationSession' in assembly 'Xamarin.iOS" when running on an iOS simulator, make sure that you have installed the latest Visual Studio 2019 and at least XCode 10 on the Mac to get the classes needed to run ASWebAuthenticationSession (ex. AuthenticationServices)