ArcGIS Pro SDK for Microsoft .NET is the new .NET SDK for the ArcGIS Pro Application.
We recommend installing a minimum version of 17.2 of Visual Studio. This version includes .NET 6.0.5 as part of the Visual Studio 2022 install (.NET SDK 6.0.3). Installing a lesser version of Visual Studio 2022 may require a separate install of the .NET Desktop Runtime 6.0.5 and/or .NET SDK 6.0.3. Consult Microsoft’s Download .NET 6.0 site for more information.
Newtonsoft Json
WebView2
ArcGIS Pro system requirements
At 3.2 you can take advantage of API enhancements for:
3D Analyst:
Arcade:
Knowledge Graph:
Geodatabase:
Editing:
Map Authoring:
Layout:
A complete list of the API enhancements is provided in the API Changes section of the API Reference.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features. Updates to the SDK Resources include, but are not limited to:
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio. There will be 2 separate extensions you can install:
Notes: Moving to ArcGIS Pro 3.2 SDK (or 3.0 SDK) from 2.x is not an upgrade. To install ,
Read the ProGuide: Installation for detailed installation instructions.
We recommend installing a minimum version of 17.2 of Visual Studio. This version includes .NET 6.0.5 as part of the Visual Studio 2022 install (.NET SDK 6.0.3). Installing a lesser version of Visual Studio 2022 may require a separate install of the .NET Desktop Runtime 6.0.5 and/or .NET SDK 6.0.3. Consult Microsoft’s Download .NET 6.0 site for more information.
Newtonsoft Json
WebView2
ArcGIS Pro system requirements
At 3.1 you can take advantage of API enhancements for:
Geodatabase:
Editing:
Framework:
Map Authoring:
Layout:
A complete list of the API enhancements is provided in the API Changes section of the API Reference.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features. Updates to the SDK Resources include, but are not limited to:
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio. There will be 2 separate extensions you can install:
Notes: Moving to ArcGIS Pro 3.1 SDK (or 3.0 SDK) from 2.x is not an upgrade. To install ,
Read the ProGuide: Installation for detailed installation instructions.
Newtonsoft Json
WebView2
Note: Cef and use of Cef sharp was deprecated at 2.9. Now, at 3.0, Cef is no longer supported.
ArcGIS Pro system requirements
At 3.0 you can take advantage of API enhancements for:
Editing:
Geodatabase:
Layout:
Map Authoring:
Geometry:
A complete list of the API enhancements is provided in the API Changes section of the API Reference.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features. Updates to the SDK Resources include, but are not limited to:
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio. Note: ArcGIS Pro 3.0 SDK is not an upgrade. To install ArcGIS Pro 3.0 SDK, you must use the Extensions > Manage Extensions > Online and search for it from the Visual Studio marketplace. Use the search string "ArcGIS Pro SDK". There will be 3 separate extensions you can install:
Some things to keep in mind: ArcGIS Pro SDK requires Visual Studio 2022. Make sure you search for the ArcGIS Pro SDK inside Visual Studio 2022 or you will find ArcGIS Pro 2.9 SDK. Also ensure you have .NET 6.0.5. There will not be an update notification from Visual Studio even if you have a previous version of the SDK installed and "Automatic updates" turned on.
Read the ProGuide: Installation for detailed installation instructions.
Note: ArcGIS Pro 2.9 is the last release with .NET Framework 4.8. ArcGIS Pro 3.0 will introduce support for .NET 6.0, Microsoft's latest edition of .NET. Support for .NET 6.0 will replace support for .NET Framework 4.8. With 3.0, .NET Framework 4.8 will no longer be supported. This will be a breaking change.
Note: ArcGIS Pro 2.9 SDK is the last release with support for Visual Studio 2017 and 2019. The ArcGIS Pro 3.0 SDK will introduce support for Visual Studio 2022, Microsoft's latest edition of its IDE. Support for Visual Studio 2022 will replace support for Visual Studio 2017 and 2019. With 3.0, Visual Studio 2017 and 2019 will no longer be supported.
Newtonsoft Json
CefSharp
At 2.9 ArcGIS is using version 92.0.260 of CefSharp. Pro includes the CefSharp.dll, CefSharp.Core.dll and CefSharp.Wpf.dll in the "C:\Program Files\ArcGIS\Pro\bin\cef" installation location.
ChromiumWebBrowser has been been deprecated at 2.9. If you are currently using ChromiumWebBrowser control, please switch to using WebViewBrowser instead. WebViewBrowser control
WebView2
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
At 2.9 you can take advantage of API enhancements for:
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.9 topic in the ArcGIS Pro API Reference Guide.
As with the release of ArcGIS Pro 2.5, the minimum .NET target was switched to 4.8, and is no longer 4.6.1. What does this mean for you and your add-ins?
To migrate add-ins previously developed with 4.6.1 to 4.8, please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features. Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
.NET Framework 4.8:
To migrate add-ins previously developed with 4.6.1 to 4.8, please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
Notes
Starting at ArcGIS Pro 2.8, when recompiling add-ins made with previous versions, it is recommended that you change the Platform Target in Visual Studio from "Any CPU" to "x64". Starting at ArcGIS Pro 2.8, a number of the ArcGIS Pro extensions are now being built x64 to accommodate the latest CEF upgrade. This means that if you continue to compile previous add-ins with "Any CPU" you will receive compilation warnings similar to:
"There was a mismatch between the processor architecture of the project being built "MSIL" and the processor architecture of the reference "ArcGIS.Desktop.XXX", "AMD64". This mismatch may cause runtime failures. Please consider changing the targeted processor architecture of your project through the Configuration Manager so as to align the processor architectures between your project and references, or take a dependency on references with a processor architecture that matches the targeted processor architecture of your project."
These warnings can be ignored but we recommend changing your Platform Target in your add-ins and configurations to remove them. Note: this is not an issue for new Add-ins made with the ArcGIS Pro SDK for version 2.8. Starting at version 2.8, the default Platform Target for add-ins has been changed to “x64”. This is also documented in the following KB: https://support.esri.com/en/Technical-Article/000025544.
Refer to the links below on how to change the build configuration to use x64 platform.
Also starting at 2.8, when opening a user control .xaml using the Visual Studio Designer, it can result in the error "Could not load file or assembly 'ArcGIS.Desktop.Framework". The XAML Designer that currently ships with Visual Studio 2017 and 2019 is not capable of loading x64 assemblies. Therefore, starting at 2.8, if a user control references other controls residing in ArcGIS Pro x64-built assemblies, such as "ArcGIS.Desktop.Framework" in this particular case, the Designer can trigger these assembly loading errors. These errors, if they do occur, have no effect on compiling, debugging, and running ArcGIS Pro extensions and can be ignored. Note: simply closing the Designer tab or switching to the XAML view will clear them.
This is also documented in the following KB: https://support.esri.com/en/Technical-Article/000025543.
Note: The following entry on the Microsoft ‘Developer Community’ support website describes this Visual Studio limitation: XAML Designer does not display x64 User Controls from external projects - Visual Studio Feedback.
Newtonsoft Json
CefSharp
Please consult technical support article How To: Fix compiler error(s) using CefSharp and the ArcGIS Pro SDK ChromiumWebBrowser Control in an add-in for more information
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.8 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.8 SDK for .NET release:
Content
Geodatabase
Geometry:
Layout
Map Exploration:
.NET Framework 4.8:
Notes
Please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.8 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
.NET Framework 4.8:
To migrate add-ins previously developed with 4.6.1 to 4.8, please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
Newtonsoft Json
CefSharp
Please consult technical support article How To: Fix compiler error(s) using CefSharp and the ArcGIS Pro SDK ChromiumWebBrowser Control in an add-in for more information
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.7 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.7 SDK for .NET release:
Editing
Geodatabase
Layout
GraphicsLayer
Map Authoring:
Map Exploration:
Parcel Fabric:
3D Layers :
Geometry:
.NET Framework 4.8:
Please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.5 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
.NET Framework 4.8:
To migrate add-ins previously developed with 4.6.1 to 4.8, please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
Newtonsoft Json
CefSharp
Please consult technical support article How To: Fix compiler error(s) using CefSharp and the ArcGIS Pro SDK ChromiumWebBrowser Control in an add-in for more information
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.6 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.6 SDK for .NET release:
Map Authoring API:
Editing API
Parcel Fabric API Pre-Release:
Custom Settings:
Other API Enhancements:
.NET Framework 4.8:
Please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.5 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
.NET Framework 4.8:
Please consult technical support article How To: Convert a version 2.0 to 2.4 ArcGIS Pro SDK add-in solution to Pro 2.5 and later versions for more information
Newtonsoft Json
CefSharp
Please consult technical support article How To: Fix compiler error(s) using CefSharp and the ArcGIS Pro SDK ChromiumWebBrowser Control in an add-in for more information
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.5 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.5 SDK for .NET release:
Geometry API:
Content API
Map Authoring API:
Other API Enhancements:
.NET Framework 4.8:
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.5 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
Deprecation notice: Visual Studio 2015 has been deprecated at 2.3. ArcGIS Pro SDK 2.4 works with Visual Studio 2017 and 2019.
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.4 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.4 SDK for .NET release:
This Visual Studio project template is used to create ArcGIS Pro CoreHost Applications.
This Visual Studio item template is used to create a custom item in your Add-in and Configurations.
This Visual Studio item template is used to create a custom project item in your Add-in and Configurations.
Visual Studio 2019:
Newtonsoft.Json NuGet
Enhanced Scene Layer API:
New Stream Layer API:
Map Authoring API Updates:
Geometry API Updates:
Vector Tiles Styling:
Custom Items:
Report API:
ArcGIS Pro Extensions NuGet:
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.4 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include, but are not limited to:
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
Visual Studio 2015 has been deprecated at 2.3. Support will be removed with the next release.
Note: ArcGIS Pro system requirements
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
These release notes describe details of the ArcGIS Pro 2.3 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
The following functionality is available at the ArcGIS Pro 2.3 SDK for .NET release:
This Visual Studio project template is used to build and interact with a Plugin Datasource at Pro 2.3+.
This Visual Studio item template is used to create a ProWindow UI element in your Add-in and Configurations.
Framework:
Map Exploration:
Geodatabase:
Layout:
Dimension:
Content:
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.3 topic in the ArcGIS Pro API Reference Guide.
There are many ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
Updates to the SDK Resources include: