This page provides details about enhancements in the 100.7 release of ArcGIS Runtime SDK for .NET . It also lists this release's deprecations, resolved issues, and known issues.
.NET Core
This release adds support for building Windows Desktop applications using WPF with .NET Core 3.1. This marks a significant step for the popular WPF UI framework by liberating it from the system-wide .NET Framework on which it currently depends, enabling you to deploy smaller, self-contained apps that may target different .NET Core versions while continuing to benefit from future enhancements beyond .NET Framework. To get started building Windows Desktop apps on .NET Core you need Visual Studio 2019 16.4 (or later) with the workloads .NET desktop development and .NET Core cross-platform development. ArcGIS Runtime for .NET also provides a project template, "ArcGIS Runtime App (WPF .NET Core)". For more information see .NET Core 3 for Windows Desktop.
Enhancements
This section describes new features and improvements (what's new).
Utility network
Utility network functionality has been greatly enhanced in this release. You can now trace your electric circuits, and gas and water systems using upstream, downstream and subnetwork traces. Set numerous trace configuration options to enhance and fine-tune all of these traces. In addition, your users can now query the contents of a network container, such as a switch cabinet or regulator station, using association queries. Finally, using the new subtype feature layer, you can now efficiently display different asset groups within a single feature class.
Maps and scenes
New raster types as offline elevation sources
With ArcGIS Pro 2.5 you can create mobile scene packages that utilize a range of raster types as elevation sources within a scene. Use these packages to take your scenes offline. With this release you do not need to unpack packages that contain raster data.
Custom styles available with vector tiles in a mobile map package
With ArcGIS Pro 2.5 you can create mobile map packages that include vector tile layers along with their own custom style. This release of ArcGIS Runtime adds support for displaying vector tile layers using the custom style included in the package.
Offline routing with a scene
With ArcGIS Pro 2.5 you can create mobile scene packages that contain transportation networks. You can now use these packages with ArcGIS Runtime to perform routing analysis entirely offline in a scene.
Map background color
A map's background color is now honored when displaying maps in a map view. This color will be displayed in transparent areas of the map as well as areas where there is no basemap or operational data. The background color can be defined programmatically or specified while creating webmaps and mobile map packages.
Drape 2D markers on a surface
Rather than always being billboarded, 2D markers can now be draped on the ground on a 3D surface when drawn in dynamic rendering mode. This matches the existing behavior of lines and polygons.
MrSID performance improvement
Display times are considerably faster when initially displaying and interacting with MrSID raster datasets at this release.
Closest Facility and Service Area inputs
Additional properties have been added to the Facility and Incident classes to help model and accurately locate moving features used as inputs. These properties are used to describe the speed, bearing, bearing tolerance, and latency for an input.
Feature table performance improvements
Performance of Feature, Service, and Wfs has been improved, in some cases by up to 65%. This applies to the initial population and subsequent navigation for ServiceFeatureTable and WfsFeatureTable when using On Interaction Cache or On Interaction No Cache feature request modes, as well as the manual population of these tables if using Manual Cache mode with calls to Populate. It also applies to the insertion of large numbers of features into Feature.
Symbology
Model scene symbol support for glTF
Model scene symbols now support glTF 2.0 , a standardized file format for describing 3D objects. Model symbols can be created from .glTF or .glb files (a binary form). See the glTF Overview for more information about the glTF 2.0 specification.
Support for v3.0 dictionary styles
This release of ArcGIS Runtime adds support for version 3.0 of the ArcGIS dictionary style. This is the latest version used by ArcGIS Pro 2.5.
Visible scale range for symbols
ArcGIS Runtime now honors the visible scale range for symbols when displaying maps from mobile map packages. This is useful to limit the amount and type of data displayed at different map scales. You can use ArcGIS Pro to define the scale range for symbols in a Unique Value or Class Breaks renderer of a feature layer.
Improved support for visual variables with 3D Symbols
Model scene symbols now support size and rotation from visual variables along a user-defined axis. Geographic and arithmetic rotation from visual variables is supported along the heading axis. Color and size from visual variables are now supported on 3D primitive marker symbols, such as cube, cylinder, etc.
Create and modify KML screen overlays
Previous releases introduced the creation and modification of certain types of KML content, such as placemarks and ground overlays. This release adds support for creating, editing, and saving screen overlays (Screen) within KML datasets. API additions comprise:
- A constructor for ScreenOverlay
- Read-write properties for color, icon, and draw order on ScreenOverlay
- New properties on ScreenOverlay to support positioning, sizing, and rotating screen overlays
Augmented reality
The AR Toolkit now allows you to clip the contents of a scene by setting the clippingDistance property. This allows you to build more realistic table-top experiences where you can limit the 3D content being displayed to the surface upon which it is placed, and also helps improve the performance of full-scale experiences by prioritizing the content that is nearby over data that may be far away.
Licensing enhancements
With ArcGIS Runtime 100.7, you can now unlock Standard and Advanced license levels and the Analysis extension when using the User authentication licensing mechanism with ArcGIS Online or ArcGIS Enterprise 10.8 or higher. Previously these license entitlements were only available using a license string.
API changes
Behavior changes
-
Utility Network license extension—Starting with ArcGIS Runtime 100.7 and ArcGIS Enterprise 10.8, Utility Network capabilities now require an explicit Utility Network license extension. This extension can be unlocked using a Utility Network license string, or a user that has been assigned a Utility Network user type extension.
-
When you take a web map offline you can navigate between the map's min and max scale. This scale range is now specified by the original web map (either defined by the service or the basemap layer). Previously, this scale range was limited by levels of detail downloaded when taking the map offline.
-
When building an app that uses the WPF NuGet package and not building for AnyCPU (prefer 32-bit or x86/x64, in other words), the native DLLs were previously copied to the
arcgisruntime100.x/clientfolders. With 100.7, they are now placed in the same folder as the executable.XX
Deprecations
Support for iOS 11 is deprecated. A minimum of iOS 12 will be required at the next release.
Support for Android API level 19 (Android 4.4, KitKat) is deprecated. A minimum of API level 21 (Android 5.0, Lollipop) will be required at the next release.
Support for Windows 7 SP1 is deprecated. A minimum of Windows 10 version 1803 will be required at the next release.
Support for Windows 10 version 1709 is deprecated. A minimum of Windows 10 version 1803 will be required at the next release.
In addition to being billboarded, 2D marker symbols displayed in a scene can now be draped on the ground to match the behavior of lines and polygons. This is supported for dynamic rendering, allowing you to move and rotate the symbols at sub-second intervals. To support this change, the Draped enum value of Surface is deprecated. Use either Draped or Draped instead.
The Portal property has been deprecated. The preferred way to obtain license information for a user is by using the new Portal.fetch method. This method returns ArcGIS Runtime license entitlements of members in ArcGIS Online and ArcGIS Enterprise 10.8, and is backwards-compatible with older versions of ArcGIS Enterprise.
Raster data can now be read directly from a mobile map/scene package without the need for it to be unpacked. You do not need to check whether a package can be read directly. The Is method on the Mobile and Mobile have been deprecated. From this version they will always return a value of true. Since this method is no longer required, it can be removed from your calling code along with any subsequent use of Unpack method.
Support for ArcGIS Desktop 10.x packages with ArcGIS Runtime Local Server is deprecated. Version 100.8 will be the last ArcGIS Runtime Local Server release to support ArcGIS Desktop 10.x packages. The next version will require packages to be created with ArcGIS Pro.
Support for VMWare Horizon View 6.5 is deprecated. A minimum of VMWare Horizon 7.0 will be required at the next release.
Support for Citrix XenDesktop 7.17 and 7.18 is deprecated. A minimum of Citrix XenDesktop 7.6 will be required at the next release.
Support for Citrix Virtual Apps and Desktops 7 1909 is deprecated. A minimum of Citrix Virtual Apps and Desktops 7 1912 LTSR will be required at the next release.
Issues resolved
-
ENH-000124453 Provide the ability to display a mobile map package and respect the visible scale range set for each symbol class in ArcGIS Pro for that mobile map package.
-
BUG-000126697 Application crashes when attempting to load a certain mobile map package (.mmpk).
-
Callout appears "collapsed" if it was initially hidden.
-
BUG-000126144 Crash in Map_renderer::Labelable.
-
BUG-000124577 Poor performance with large MrSID rasters.
-
ENH-000115312: Clarify and improve the documentation for requirement and approaches for offline preplanned workflow.
-
BUG-000120409 WMTS service does not load if the tile matrices of the service in the GetCapabilities file are not in sequential order.
-
BUG-000109943 When creating the points, if the coordinate value is lower than decimal point third place, the raster is added to the map with an unexpected rendering result.
-
BUG-000122510 Selecting features on a feature layer using
featureuses the geometry of the polygon extent rather than the geometry of the polygon itself when querying from an event listener.Layer. Select Features Async() -
BUG-000115811 Blend renderer for scene view renders in different color range than for map view.
-
ENH-000120897 Support draped mode for symbols in dynamic mode 3D.
-
BUG-000126415 Application crashes when rendering labels with query with the EXC_BAD_ACCESS error
-
BUG-000126467 Display fails for online and synced offline annotation layers with certain spatial reference characteristics
-
BUG-000125578 The
Labelmethod returns an empty symbol value.Definition. To Json() -
Regression: Refresh token is being exchanged when an access token refresh is required. See Esri Community post.
-
BUG-000123380
Callis unable to display the message box when the camera pitch angle is more than 100 degrees.Out Definition Class -
BUG-000109177 Xamarin.iOS Storyboard Error: "Custom Components are not being rendered because problems were detected"
Known issues
-
BUG-000127070 The WGS 1984 (Transit) spatial reference (WKID 104016) is no longer recognized, and data or services using this WKID may fail to load. As a workaround, the EPSG replacement code 8888 can be used instead.
-
BUG-000125987 The watermark is not removed without rotating the screen after setting the license from user authentication.
-
BUG-000125249 A small outline added to graphics when
Navigationis set to none.Constraint