ArcGIS Pro 2.9 SDK for .NET
Requirements
ArcGIS Pro
- ArcGIS Pro 2.9
Supported platforms
- Windows 11 (Home, Pro, Enterprise)
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
Supported .NET framework
- Microsoft .NET Framework 4.8 Developer Pack
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.
Supported IDEs
- Visual Studio 2019 (Professional, Enterprise, and Community Editions)
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
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.
Third party assemblies
Newtonsoft Json
- At 2.9 ArcGIS Pro is using version 12.0.1 of the Newtonsoft Json NuGet. If you require Newtonsoft NuGet in your add-ins it is recommended to use the same version.
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
- Starting at ArcGIS Pro 2.9, addin developers can use the new WebViewBrowser control based on Microsoft Edge WebView2. Consult the WebView2 manifest in the Pro bin\WebView folder for the current WebView2 fixed version runtime in use by ArcGIS Pro.
Note: ArcGIS Pro system requirements
Installing ArcGIS Pro SDK for .NET
ArcGIS Pro SDK for .NET can be downloaded and installed from within Visual Studio.
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
Release notes
What's New for Developers at 2.9
1. API Enhancements
At 2.9 you can take advantage of API enhancements for:
Visual Studio Templates
- The Layout Tool item template creates a layout tool for adding/editing graphics in layout and map views and elements in layout.
- The Table Construction Tool item template creates a table construction tool for creating rows in standalone tables.
Content:
- Catalog pane enhancements for accessing GDB, file, and CAD data.
- API access to application options.
Editing:
- Table templates, template commands, table editing, and sketch symbology customization.
Geodatabase
- DDL support for annotation layers and mobile geodatabases.
Map Authoring:
- Add tables to group layers and layer documents (.lyrx), and save map to web map format.
Map Exploration:
- Table Control enhancements like “Go to” row, open + customize table pane/view.
Utility Network:
- Named trace configurations can be stored and retrieved on server.
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.
2. .NET 6.0 and .NET Framework 4.8
- 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.
3. Visual Studio 2017, 2019, and 2022
- ArcGIS Pro 2.9 SDK is the last release with support for Visual Studio 2017 and 2019. 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.
4. ArcGIS Pro 2.5 and .NET Framework 4.8
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?
- Existing add-ins, already deployed, will work at 2.9 with no change to their forward compatibility.
- Existing add-ins which are recompiled at 2.9 (e.g. because a code change was made) will also require the minimum target framework set to 4.8 or they will not compile. Note: As always, if an existing add-in is changed for any reason, the desktopVersion attribute in its Config.daml file should be changed to reflect the version of Pro it was last compiled against, in this case, now 2.9.
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
5. Target platform has changed from AnyCPU to x64
- 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".
- Also starting at 2.8, when opening a user control .xaml using the Visual Studio Designer, it could result in the error "Could not load file or assembly 'ArcGIS.Desktop.Framework".
Please refer to the ArcGIS Pro FAQ for more information.
6. SDK Resources
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:
- ProConcepts: Framework
- ProConcepts: COGO
- ProConcepts: Project Content and items
- ProConcepts: Editing
- ProConcepts: Layouts
- ProConcepts: Parcel Fabric
- ProConcepts: Map Authoring
- ProConcepts: Reports
- ProConcepts: Geometry
- ProGuide: Regression Testing
- The Pro Community Samples and Snippets have new samples and snippets.