ArcGIS Runtime SDK version 100.15 is a long-term support release focused exclusively on bug fixes and minor updates. ArcGIS Maps SDKs for Native Apps version 200.x builds on the proven architecture of 100.15, and is designed to leverage the latest developer framework innovations. This topic outlines areas of the API that have undergone changes and provides guidance for re-factoring 100.x code for a 200.x app.
Basic migration steps
Follow these general steps to migrate your existing apps built with ArcGIS Runtime SDK for .NET versions 100.0-100.15 to ArcGIS Maps SDK for .NET version 200.0:
- Review the OS and framework changes section below and make any recommended changes or updates.
- Open the source code for your application.
- Update all
Esri.
NuGet references to version 200.0.0.ArcGIS Runtime.* - Address any breaking API changes. APIs that were marked as deprecated for v100.x have been removed from 200.0 and any usage of these APIs now raises compilation errors.
- Build and run the upgraded app and verify that it functions correctly.
Migrate Xamarin apps
Version 100.15 was the last release of ArcGIS Runtime SDK for .NET to support Xamarin.Forms, Xamarin.Android, and Xamarin.iOS. Version 200.0 supports .NET MAUI, .NET for Android, and .NET for iOS. Existing Xamarin Forms applications must transition to .NET MAUI (Multi-platform App UI) and from Xamarin.Android and Xamarin.iOS to .NET for Android, and .NET for iOS respectively.
Initializing the ArcGIS Maps SDK package for .NET MAUI
To use ArcGIS Maps SDK for .NET with your .NET MAUI app, call Use
on the Maui
class when your app initializes. The following example shows how to do this.
public static class MauiProgram
{
// This class is part of the standard MAUI template.
// MAUI apps use CreateMauiApp to prepare the app.
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
// This line is required when using ArcGIS Runtime.
builder.UseArcGISRuntime();
return builder.Build();
}
}
See the following documentation for more information about migrating Xamarin Forms apps to .NET MAUI:
- Migrate your app from Xamarin.Forms (Microsoft documentation)
- Migrating from Xamarin.Forms (Preview) - Wiki
API changes
All deprecated APIs in 100.x have been removed in version 200.0. Usage of deprecated APIs results in compilation errors that must be addressed to successfully build your application using version 200.0.0.
System requirements changes
Several system requirements for developing and deploying apps with ArcGIS Runtime SDK for .NET have been updated with ArcGIS Maps SDK for .NET version 200.x. See the System requirements topic for details.
Frequently asked questions (FAQ)
Answers to some common migration-related questions can be found below.
Q: Do I have to immediately migrate my apps from ArcGIS Runtime SDK for .NET version 100.x to ArcGIS Maps SDK for .NET version 200.x?
No. ArcGIS Runtime SDK for .NET version 100.15 is a long-term support release. If your app does not require any of the new functionality provided by version 200.0 (or future 200.x releases), your app will continue to work as expected. See the Product Life Cycle document for more information.
However, to use the latest functionality provided by ArcGIS Maps SDK for .NET you will need to migrate your app.
Q: Is there any functionality available in ArcGIS Runtime SDK for .NET version 100.x that is missing from ArcGIS Maps SDK for .NET version 200.x?
No. All functionality found in version ArcGIS Runtime SDK for .NET 100.15 is available in ArcGIS Maps SDK for .NET version 200.0. Additionally, version 200.0 provides new functionality not available in 100.15, see the Release notes for details.
Q: Do I need to rewrite my apps built with ArcGIS Runtime SDK for .NET version 100.x to work with ArcGIS Maps SDK for .NET version 200.x?
No. Updating an app that uses ArcGIS Runtime SDK for .NET version 100.15 to use ArcGIS Maps SDK for .NET version 200.0 is generally straightforward. Migrating a Xamarin.Forms app to .NET MAUI will require some additional work that's not related to the use of ArcGIS Maps SDK for .NET.
Q: Is ArcGIS Maps SDK for .NET a completely new product?
No. The group of products collectively known as ArcGIS Runtime SDKs are now known as ArcGIS Maps SDKs for Native Apps. Version 200.x of these SDKs builds on the proven architecture of ArcGIS Runtime 100.15 and is designed to leverage the latest developer framework innovations.