Releases: Esri/arcgis-pro-sdk
ArcGIS Pro 2.4 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 2.4
Supported platforms
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
- Windows 7 SP1 (Ultimate, Professional and Enterprise) (64 bit)
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2019 (Professional, Enterprise, and Community Editions)
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
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
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
ArcGIS Pro 2.4 SDK for .NET
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.
What's new
The following functionality is available at the ArcGIS Pro 2.4 SDK for .NET release:
1. New Project and Item Visual Studio templates
CoreHost Application project template
This Visual Studio project template is used to create ArcGIS Pro CoreHost Applications.
Custom Item item template
This Visual Studio item template is used to create a custom item in your Add-in and Configurations.
Custom Project Item item template
This Visual Studio item template is used to create a custom project item in your Add-in and Configurations.
2. API Enhancements
Visual Studio 2019:
- New support for Visual Studio 2019, with continued support for Visual Studio 2017.
Newtonsoft.Json NuGet
- At 2.4 ArcGIS Pro is using version 12.0.1 of the Newtonsoft Json NuGet. If you require Newtonsoft NuGet in your add-ins we recommend using the same version.
Enhanced Scene Layer API:
- Enhancements to work with filters and filter blocks, queries, selections, and symbology.
New Stream Layer API:
- Manage real-time data, streaming, selection, filters, tracking and events.
Map Authoring API Updates:
- Layer creation enhancements, symbol lookup, JSON support for the CIM.
Geometry API Updates:
- Access to multipatch feature properties.
Vector Tiles Styling:
- Support for manipulating vector tile styles.
Custom Items:
- Catalog support for custom items.
Report API:
- Enhancements to work with reports.
ArcGIS Pro Extensions NuGet:
- Full support availability.
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.
3. SDK Resources
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:
- ProConcepts: Framework
- ProConcepts: Map Authoring
- ProConcepts: Layouts
- ProConcepts: Scene Layers
- ProConcepts: Stream Layers
- ProConcepts: Custom Items
- ProGuide: Custom Items
- The Pro Community Samples and Snippets have new samples and snippets.
- The API Changes section of the What’s New for Developers 2.4 page.
ArcGIS Pro 2.3 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 2.3
Supported platforms
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
- Windows 7 SP1 (Ultimate, Professional and Enterprise) (64 bit)
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
- Visual Studio 2015 (Professional, Enterprise, and Community Editions) (Deprecated at 2.3)
Deprecation Notice
Visual Studio 2015 has been deprecated at 2.3. Support will be removed with the next release.
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
ArcGIS Pro 2.3 SDK for .NET
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.
What's new
The following functionality is available at the ArcGIS Pro 2.3 SDK for .NET release:
1. New Project and Item Visual Studio templates
Plugin Datasource project template
This Visual Studio project template is used to build and interact with a Plugin Datasource at Pro 2.3+.
ProWindow item template
This Visual Studio item template is used to create a ProWindow UI element in your Add-in and Configurations.
2. API Enhancements
Framework:
- Creating a new ArcGIS Pro project using a system template has changed. See Create project using template available with ArcGIS Pro.
Map Exploration:
- New Table control, and reports customization with the CIM.
Geodatabase:
- Plug-in data sources and additional version management support.
Layout:
- Additional map series support.
Dimension:
- First release of this new API, to be expanded in future releases.
Content:
- Additional support for metadata.
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.
3. SDK Resources
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:
- ProConcepts: Framework
- ProConcepts: Configurations
- ProGuide: ArcGIS Pro Extensions NuGet
- ProConcepts: Plugin Datasources
- ProGuide: TableControl
- The Pro Community Samples and Snippets have new samples and snippets.
- The API Changes section of the What’s New for Developers 2.3 page.
ArcGIS Pro 2.2 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 2.2
Supported platforms
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
- Windows 7 SP1 (Ultimate, Professional and Enterprise) (64 bit)
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
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
ArcGIS Pro 2.2 SDK for .NET
These release notes describe details of the ArcGIS Pro 2.2 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
What's new
The following functionality is available at the ArcGIS Pro 2.2 SDK for .NET release:
1. API Enhancements
Content API:
- Additional Item methods for metadata access and management
Editing API:
- Additional support for annotation editing and split operations
Geodatabase API:
- Table methods for sorting and calculating statistics
Geometry API:
- Performance improvements for buffering and use of relational operators
Utility Network API:
- Support for ValidateNetworkTopology, Tier groups, access to network system tables
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.2
topic in the ArcGIS Pro API Reference Guide.
2. SDK Resources
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:
- ProConcepts: Framework
- ProConcepts: Editing
- ProConcepts: Geodatabase
- ProConcepts: Geometry
- ProConcepts: Utility Network
- The Pro Community Samples and Snippets have new samples and snippets.
- The API Changes section of the What’s New for Developers 2.2 page.
ArcGIS Pro 2.1 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 2.1
Supported platforms
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
- Windows 7 SP1 (Ultimate, Professional and Enterprise) (64 bit)
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
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
ArcGIS Pro 2.1 SDK for .NET
These release notes describe details of the ArcGIS Pro 2.1 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
What's new
The following functionality is available at the ArcGIS Pro 2.1 SDK for .NET release:
1. API Enhancements
Annotation API:
- Create and edit annotation features
- Assign and manage annotation geometries
Content API:
- Working with Metadata
- Portal API enhancements
Layout API:
- Create new layouts from scratch with dynamic settings
- Author layout element types
- Interact with layout views and manage element selections
Utility Network API:
- Create custom utility network traces
- Develop tools for utility-focused workflows
For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.1 topic in the ArcGIS Pro API Reference Guide.
2. SDK Resources
There are many new ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
- The ProConcepts: Annotation which goes over the fine-grained Annotation API.
- The ProConcepts: Layouts which goes over managing layouts, layout elements and working with layout views. This includes creating new layouts and layout elements, modifying existing elements, managing selections, and layout view control and navigation.
- The ProConcepts: Utility Network which goes over the comprehensive framework of functionality in ArcGIS for modeling utility systems such as electric, gas, water, storm water, wastewater, and telecommunications.
- The ProGuide: Annotation Construction Tools and ProGuide: Annotation Editing Tools.
- The API Changes section of the What’s New for Developers 2.1 page.
- The Pro Community Samples and Snippets have new samples and snippets.
ArcGIS Pro 2.0 SDK for .NET
Breaking Changes at 2.0
ArcGIS Pro 2.0 is a breaking change release. This means that all 1.4 and earlier add-ins and configurations must be recompiled against ArcGIS Pro 2.0 assemblies to work with ArcGIS Pro 2.0. There are additional changes that will be required to migrate your add-ins and configurations beyond recompilation. Please consult the ProConcepts 2.0 Migration Guide for more details.
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 2.0
Supported platforms
- Windows 10 (Home, Pro, Enterprise) (64 bit [EM64T])
- Windows 8.1 Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise and Professional (64 bit [EM64T])
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2017 (Professional, Enterprise, and Community Editions)
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
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
ArcGIS Pro 2.0 SDK for .NET
These release notes describe details of the ArcGIS Pro 2.0 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
What's new
The following functionality is available at the ArcGIS Pro 2.0 SDK for .NET release:
1. Breaking Changes at 2.0
ArcGIS Pro 2.0 is a breaking change release. This means that all 1.4 and earlier add-ins and configurations must be recompiled against ArcGIS Pro 2.0 assemblies to work with ArcGIS Pro 2.0. There are additional changes that will be required to migrate your add-ins and configurations beyond recompilation. Please consult the ProConcepts 2.0 Migration Guide for more details.
2. Installation changes
Starting with version 2.0, ArcGIS Pro SDK for .NET will be exclusively available as VSIX installer packages only. If you have previously installed ArcGIS Pro SDK for .NET using the MSI mechanism, uninstall it from the control panel. ProGuide: Installation and Upgrade
3. Map Pane Impersonation Item Template
The Map Pane Impersonation is a new item template for customizing the Pro UI/UX. A custom Map pane can be created to impersonate any active Map Pane. This is done by overriding the new ArcGIS.Desktop.Mapping.TOCMapPaneProviderPane class. The new map pane you create will allow you to interact with the TOC that displays the layers in the active map pane that is being impersonated. ImpersonateMapPane sample
4. API Enhancements
Pro API enhancements include support for Raster, Geodatabase, Mapping, Geometry, Content Management, and Editing. For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 2.0 topic in the ArcGIS Pro API Reference Guide.
5. SDK Resources
There are many new ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
- The ProConcepts 2.0 Migration Guide which details the different breaking changes as well as the step-by-step migration procedure
- The ProSnippets 2.0 Migration with examples of before and after code changes.
- The FAQ has a new migration section to answer most common questions on add-in and configuration migration
- The API Changes section of the What’s New for Developers 2.0 page.
- The Pro Community Samples and Snippets are all changed to reflect 2.0 API usage.
- The ArcGIS Pro Style Guide contains all the new WPF styles, brushes, and colors.
ArcGIS Pro 1.4 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 1.4
Supported platforms
- Windows 10 (Pro, Enterprise, Home) (64 bit [EM64T])
- Windows 8.1 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise, Professional, and Home Premium (64 bit [EM64T])
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
- Visual Studio 2013 (Professional, Premium, Ultimate, and Community Editions)
Note: ArcGIS Pro system requirements
Installing ArcGIS Pro SDK for .NET
ArcGIS Pro SDK for .NET can be downloaded and installed using either one of the following options:
- Download and install from within Visual Studio (recommended option)
- Download from MyEsri.com
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
Release notes
ArcGIS Pro 1.4 SDK for .NET
These release notes describe details of the ArcGIS Pro 1.4 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
####What's new
The following functionality is available at the ArcGIS Pro 1.4 SDK for .NET release:
1. Configurations.
The Managed Configuration is a brand new add-in pattern and template for customizing the Pro UI/UX at start-up. Managed Configurations are implemented by overriding the new ArcGIS.Desktop.Framework.Contracts.ConfigurationManager class. A step by step ProGuide on customizing Pro with a Managed Configuration is also available.
#####2. Light and Dark Theme
With the new light and dark theme capability at Pro 1.4, the SDK provides the ability to style your add-ins and configurations for whichever theme you choose. Styling your add-ins and configurations for Windows' High Contrast mode (for vision impaired users) is also supported.
3. API Enhancements
Pro API enhancements include support for geodatabase joins, database SQL syntax, horizontal/vertical datums, new UI controls. For a detailed list of changes to the ArcGIS Pro API refer to the What's new for developers at 1.4 topic in the ArcGIS Pro API Reference Guide.
4. SDK Resources
There are many new ProConcepts, ProGuide, ProSnippets, and samples to help you get up and running with the new SDK features including:
- ProConcepts Configuration Manager
- ProGuide Configuration Manager
- ProGuide Style Guide
- ProGuide Applying Custom Styles
- ProConcepts Advanced Topics
5. Other
Deprecation Notice: Tool and Sketch tool item templates are no longer available.
Please use the Map tool item template. Refer to the new ProGuides for Map Tools under the Map Exploration section. Also refer to the Map Tool section in the ProConcepts: Map Exploration.
Build Server configuration: Compile ArcGIS Pro Add-ins and Configurations without a full installation of ArcGIS.
Starting with ArcGIS Pro SDK 1.4 it is now possible to configure a build server to compile add-ins and configurations without a full installation of ArcGIS Pro. Please refer to Configure build server to build add-ins and configurations
ArcGIS Pro 1.3 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 1.3
Supported platforms
- Windows 10 (Pro, Enterprise, Education) (64 bit [EM64T])
- Windows 8.1 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 8 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise, Professional, and Home Premium (64 bit [EM64T])
Supported .NET framework
- Microsoft .NET Framework 4.6.1 Developer Pack
Supported IDEs
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
- Visual Studio 2013 (Professional, Premium, Ultimate, and Community Editions)
Note: ArcGIS Pro system requirements
Installing ArcGIS Pro SDK for .NET
ArcGIS Pro SDK for .NET can be downloaded and installed using either one of the following options:
- Download and install from within Visual Studio (recommended option)
- Download from MyEsri.com
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
Release notes
ArcGIS Pro 1.3 SDK for .NET
These release notes describe details of the ArcGIS Pro 1.3 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
What's new
The following functionality is available at the ArcGIS Pro 1.3 SDK for .NET release:
1. .NET Framework 4.6.1 is now supported.
The default target framework for ArcGIS Pro add-ins is now .NET Framework 4.6.1.
2. Sketch tool item template is deprecated.
Please use the Map tool item template. Refer to the new ProGuides for Map Tools under the Map Exploration section. Also refer to the Map Tool section in the ProConcepts: Map Exploration.
3. New classes and methods in the Pro API
For a detailed list of changes to the ArcGIS Pro API refer to the What is new for developers at 1.3 topic in the ArcGIS Pro API Reference Guide.
ArcGIS Pro 1.2 SDK for .NET
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 1.2
Supported platforms
- Windows 10 (Home, Pro, Enterprise, Education) (64 bit [EM64T])
- Windows 8.1 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 8 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise, Professional, and Home Premium (64 bit [EM64T])
Supported .NET framework
- 4.5.6
- 4.5.2
- 4.5.1
- 4.5
Supported IDEs
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
- Visual Studio 2013 (Professional, Premium, Ultimate, and Community Editions)
Installing ArcGIS Pro SDK for .NET
ArcGIS Pro SDK for .NET can be downloaded and installed using either one of the following options:
- Download and install from within Visual Studio (recommended option)
- Download from MyEsri.com
Read the ProGuide: Installation and Upgrade for detailed installation instructions.
Release notes
ArcGIS Pro 1.2 SDK for .NET
These release notes describe details of the ArcGIS Pro 1.2 SDK for .NET release. Here you will find information about available functionality as well as known issues and limitations.
What's new
The following functionality is available at the ArcGIS Pro 1.2 SDK for .NET release:
1. The following four new templates have been added to ArcGIS Pro SDK for .NET:
| C# | VB | Name |
|---|---|---|
 |
 |
ArcGIS Pro Backstage Tab  |
 |
 |
ArcGIS Pro Custom Control |
 |
 |
ArcGIS Pro Embeddable Control |
 |
 |
ArcGIS Pro Property Sheet |
Known issues
The following are known issues or limitations with the ArcGIS Pro 1.2 SDK for .NET release:
1. In a Visual Basic add-in, adding two items with the same name (for example, button.vb) in two different project folders causes a conflict in namespace compile error.
Visual Basic does not automatically create the .vb file prepopulated with the namespace. To fix it, open the button.vb in the folder, and enclose the Button class with the namespace. See the following example:
Namespace ProAppModule9.Test
Friend Class Button
Inherits Button
Protected Overrides Sub OnClick()
End Sub
End Class
End NamespaceArcGIS Pro 1.1 SDK for .NET (Visual Studio 2015 Update)
We are pleased to announce an update to our existing ArcGIS Pro SDK for .NET 1.1 to add support for the Visual Studio 2015 IDE. Visual Studio 2015 Professional, Enterprise, and Community Editions are now supported. This is in addition to Visual Studio 2013 which has been supported (and continues to be supported) since our initial 1.1 release.
Developers using the Visual Studio 2015 IDE can now download the 1.1 SDK from within Visual Studio via the Visual Studio Extensions and Updates feature. Visual Studio 2015 support will be available for download on the MyEsri.com website with the ArcGIS Pro 1.2 release. You can find out more information on the ArcGIS Pro SDK for .NET at https://github.com/Esri/arcgis-pro-sdk
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 1.1
Supported platforms
- Windows 8.1 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 8 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise, Professional, and Home Premium (64 bit [EM64T])
Supported .NET framework
- 4.5.2
- 4.5.1
- 4.5
Supported IDEs
- Visual Studio 2015 (Professional, Enterprise, and Community Editions)
- Visual Studio 2013 (Professional, Premium, Ultimate, and Community Editions)
Download
ArcGIS Pro SDK for .NET can be downloaded and installed using either one of the following options:
- Download and install from within Visual Studio
- Download from MyEsri.com (Visual Studio 2013 only)
Read the Installing ArcGIS Pro SDK for .NET section for more information.
Release notes
These release notes describe details of the ArcGIS Pro 1.1 SDK for .NET release. Here you will find information about functionality available in the release and known issues and limitations.
What's new
Support for Visual Studio 2015 is now available for download from within Visual Studio.
Known issues
The following are known issues or limitations with the ArcGIS Pro 1.1 SDK for .NET release.
1. API Reference guide TOC display issues on some desktops
- When you browse to the API Reference guide on some desktop machines, the TOC appears as in the following screen shot:
- The TOC layout has adapted to a touch device. In that mode, the TOC, search, index, etc., are available from the icons on the toolbar at the top of the page. This occurs mainly in the Chrome browser, which sometimes identifies a device as touch capable if you have a touchscreen laptop or are running on a virtual machine.
Workaround
Use this URL to view the API Reference guide when you notice this issue.
2. Add-in is not loaded by Pro when you build it in Visual Studio
- You've deleted the add-in file (*.esriAddinX file) from the
C:\Users\<UserName>\Documents\ArcGIS\AddIns\ArcGISProfolder. - Without making any code changes, you build the add-in project in Visual Studio and start ArcGIS Pro or click the Start button in Visual Studio to start the debugger.
- Your add-in does not load in ArcGIS Pro.
Workaround
- From the Visual Studio Build menu, click the Rebuild Solution menu item. This will create the add-in file (*.esriAddinX file) under the
C:\Users\<UserName>\Documents\ArcGIS\AddIns\ArcGISProfolder. When you start ArcGIS Pro, your add-in will now load.
3. Controls do not work in ArcGIS Pro after the add-in project's namespace and/or assembly is changed
- You changed one or more of the following:
- The Assembly name and/or default namespace in your project application properties in Visual Studio
- The namespace in your add-in module and/or add-in class files
When ArcGIS Pro loads your add-in, one or more of the controls defined in your add-in do not work. For example, a new button in your add-in is unresponsive when you click it and becomes permanently disabled.
Fix
One or more of the following conditions may need to be fixed:
- The defaultAssembly and defaultNamespace attributes on the root
ArcGISdaml element within your Config.daml must be changed to match any changes you made to the corresponding Visual Studio project application properties.
<?xml version="1.0" encoding="utf-8"?>
<ArcGIS defaultAssembly="MyRenamedAssembly.dll" defaultNamespace="MyRenamedAssembly" xmlns="..." xmlns:xsi="..." xsi:schemaLocation="...">
<AddInInfo id="...
....
- If the namespace of an add-in class (in the code file) does not match the
defaultNamespaceattribute of the<ArcGIS>element in the Config.daml, you must fully qualify theclassNameattribute of its daml element (with "namespace.classname") in Config.daml.
For example: Assume this is the class file of a button. Note the namespace.
namespace MyRenamedAssembly.Addins {
class Button1 : Button
{
protected override void OnClick() {Assume this is the Config.daml. Note the <ArcGIS defaultNamespace.
<!-- the defaultNamespace is MyRenamedAssembly -->
<ArcGIS defaultAssembly="MyRenamedAssembly.dll" defaultNamespace="MyRenamedAssembly" xmlns="...
<!-- the button className attribute is fully qualified -->
<button .... className="MyRenamedAssembly.Addins.Button1" ... />- Rebuild the add-in project
4. In a Visual Basic add-in, adding two items with the same name (for example, button.vb) in two different project folders causes a conflict in namespace compile error.
Visual Basic does not automatically create the .vb file prepopulated with the namespace. To fix it, open the button.vb in the folder, and enclose the Button class with the namespace. See the following example:
Namespace ProAppModule9.Test
Friend Class Button
Inherits Button
Protected Overrides Sub OnClick()
End Sub
End Class
End Namespace5. Custom Project Settings - ProjectService::SaveProjectAsync Failed
If the ArcGIS.Desktop.Framework.Contracts.Module overrides for reading and writing custom Add-in project settings are used in an Add-in, the project file can no longer be saved. A message box will be displayed with the error message: ProjectService::SaveProjectAsync Failed.
This will be fixed in 1.1.1
The overrides in question on the Module class are:
protected override Task OnReadSettingsAsync(ModuleSettingsReader settings) {
}
protected override Task OnWriteSettingsAsync(ModuleSettingsWriter settings) {
}ArcGIS Pro 1.1 SDK for .NET
Extend ArcGIS Pro with ArcGIS Pro SDK for .NET. ArcGIS Pro SDK for .NET is based on the add-in extensibility pattern (first introduced at 10.0). Leverage modern .NET features and patterns such as Task Asynchronous Programming (TAP), LINQ, WPF Binding, and MVVM to write integrated 2D/3D add-ins using Pro’s new APIs.
Requirements
The requirements for the machine on which you develop your ArcGIS Pro add-ins are listed here.
ArcGIS Pro
- ArcGIS Pro 1.1
Supported platforms
- Windows 8.1 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 8 Basic, Professional, and Enterprise (64 bit [EM64T])
- Windows 7 SP1 Ultimate, Enterprise, Professional, and Home Premium (64 bit [EM64T])
Supported .NET framework
- 4.5.2
- 4.5.1
- 4.5
Supported IDEs
- Visual Studio 2013 (Professional, Premium, Ultimate, and Community Editions)
Download
ArcGIS Pro SDK for .NET can be downloaded and installed using either one of the following options:
- Download and install from within Visual Studio
- Download from MyEsri.com