Install the SDK

ArcGIS Runtime SDK for .NET contains APIs for developing apps for Windows Presentation Foundation (WPF), Universal Windows Platform (UWP), Xamarin.Android, Xamarin.iOS, and Xamarin Forms. You can work with it in your project by ...

  • Downloading and installing a Visual Studio Extension
  • Referencing online or local NuGet packages

Download the Visual Studio Extension

ArcGIS Runtime SDK for .NET provides a Visual Studio Extension (.vsix file) with project templates and NuGet packages for supported platforms. Installing the extension will add the Visual Studio templates and configure a local NuGet package source. If you want to add the ArcGIS Runtime NuGet packages from an online source (NuGet.org), there is no need to download and install them locally. The Visual Studio templates, however, are only available by installing the extension.

  1. Make sure your development computer meets the system requirements.
  2. Download the Visual Studio Extension from the Downloads page. You will need to log in with an ArcGIS developer account. Sign up for a free account if you don't already have one.
  3. Save the file to a location accessible from your development machine.

Install ArcGIS Runtime SDK for .NET Visual Studio Extension

Note:

The extension installs NuGet packages and Visual Studio templates for all supported platforms. Depending on the configuration of your development machine, you may not be able to develop for all of these platforms (a Mac computer is required for developing iOS apps, for example). For details, see the system requirements topic.

  1. Double-click the file (downloaded previously) to extract the setup files from the archive and start the install.
  2. Chose the products you want to install the extension to (Visual Studio 2017, 2015, 2013, for example). You will only see supported versions of Visual Studio as options. Click Install to accept the license terms.
    Visual Studio Extension license

    The install will start for all products you selected.

    Visual Studio Extension installer running

  3. When complete, you will see an installation confirmation for the selected products. Click Close and make sure to close and restart any open instances of Visual Studio.
    Visual Studio Extension installation complete
  4. To use a project template from the extension, start Visual Studio and choose to create a new project. For the supported project types, you will see an ArcGIS Runtime SDK template.

    Visual Studio ArcGIS Runtime project template

  5. To add a local NuGet package, open the NuGet Package Manager (Project > Manage NuGet Packages, for example). Choose the Browse tab in the manager and the local Esri package source (configured by the Visual Studio Extension installer). Select the appropriate package for your project and click Install to add the package to your project.

    NuGet Package Manager with local ArcGIS Runtime packages

Referencing online ArcGIS Runtime SDK NuGet packages

ArcGIS Runtime SDK NuGet packages are hosted on NuGet.org. If you have an internet connection, you can access these packages and add them to your Visual Studio project without having to install anything locally.

Note:

If you need locally available NuGet packages but cannot install the Visual Studio Extension (perhaps you're developing while offline on a Mac computer using Xamarin Studio, for example), you can download the packages you need from NuGet.org.

  1. Open the NuGet Package Manager (Project > Manage NuGet Packages, for example).
  2. Choose the Browse tab in the manager and the nuget.org package source. NuGet hosts over 67,000 packages, so you'll need to use the Search text box to locate the ArcGIS Runtime packages.
  3. Type ArcGIS Runtime in the Search text box. You will see several matches (for various versions and platforms).
    ArcGIS Runtime NuGet packages
  4. Select a version 100.1.0 package for your platform. Click Install to add the package to your project.
  5. Choose OK to proceed with the installation and then I Accept to accept the license agreement.

After adding the package, you'll be able to work with the components in ArcGIS Runtime SDK for .NET.

What you get

ArcGIS Runtime SDK for .NET contains everything you need to develop ArcGIS Runtime apps.

  • APIs: .NET assemblies and controls.
  • Visual Studio project templates to give you a head start on your app development.
  • Online documentation: SDK Guide and API Reference doc for all supported platforms.
  • Code samples: Visual Studio sample projects available on GitHub. See the code samples page for more information.

Next steps

You are ready to begin developing ArcGIS applications using ArcGIS Runtime SDK for .NET. Here are a few ways you can get started:

Related topics