Release notes for 100.8

This page provides details about enhancements in the 100.8 release of ArcGIS Runtime SDK for .NET. It also lists this release's deprecations, resolved issues, and known issues.

Enhancements

This section describes new features and improvements (what's new).

Maps and scenes

Image overlays in scene views

ArcGIS Runtime 100.8 introduces image overlays, which can be used to quickly render frequently changing images in a scene view. For example, rendering realtime sensor data, such as weather, where each static image represents a single frame from the radar. Image overlays render above all operational layers in the scene, but below any graphics overlays in the scene view. Designed for quick display, image overlays do not support the rich processing and rendering capabilities of a raster layer, which still provides the best option for workflows that require static image rendering, analysis, and persistence.

Online services supported in mobile map and scene packages

This release of ArcGIS Runtime now supports online services in mobile map and scene package files (.mmpk and .mspk). With ArcGIS Pro 2.6, users will be able to create packages that have a mix of local on-device content as well as online service content (such as weather or traffic information). If network connectivity is available, your app users can utilize online services, but if there is no connection, users can keep working with their local content. Apps that use packages that reference online services may need to handle authentication to ensure access to these services.

Relative to scene placement of features and graphics

Features and graphics can now be placed relative to objects in a scene, such as an elevation surface, buildings in a scene layer, integrated mesh layers, and extruded polygons. Note that some objects do not affect relative to scene placement (such as extruded points or lines, KML layers, or model symbols).

Improved text rendering in scene views

Text rendering in scene views has been greatly improved with a signed distance field (SDF) algorithm. In addition to being more efficient, and therefore using less resources, text in a scene view now supports background, outline, and halo colors, rotation relative to the screen or local north, strikethrough, underline, and better support for languages with connected characters (such as Bengali, Thai, or Arabic).

Support for visual variables for point features in 2D with dynamic rendering

To accurately represent visual variables, maintain consistency with static rendering mode, and enable developers to take advantage of the optimized display experience associated with dynamic rendering mode, ArcGIS Runtime 100.8 supports the use of visual variables for point feature layers in a map using dynamic rendering mode.

Arcade FeatureSet expressions in pop-ups

ArcGIS Runtime now supports pop-ups with Arcade expressions that use the FeatureSet capability. Feature sets allow you to create pop-up expressions that consume information from other layers in the map, from feature services, from portal items, or from related records. The new functions supported at this release are: FeatureSetById, FeatureSetByName, FeatureSetByPortalItem, and FeatureSetByRelationshipName. These expressions can be configured and saved in a web map and displayed in your ArcGIS Runtime apps. See the following blog for a description and example of using feature sets in your pop-ups: Pump up your popups with Arcade and the Living Atlas

Geocoding

Support for 32-bit apps

The newer *.loz locators, introduced with ArcGIS Pro 2.3 and ArcGIS Runtime 100.5, are now supported for 32-bit apps.

Network analysis

Simulated location data source

A new simulated location data source allows you to mock incoming GPS positions using a polyline. This is can be used to test or demonstrate functionality that requires a device to be moving, such as navigating a route, when the device is not in motion. A location change event is raised for each point in the simulated data source and locations in the collection are visited in order, allowing you to simulate travel along a path at a defined rate of speed.

Directions engine improvements

The Directions engine in ArcGIS Runtime has been upgraded to match what is used in the rest of the ArcGIS. It is fully backwards compatible with existing transportation network datasets, requires no API changes, and provides results that are consistent with other ArcGIS products such as ArcGIS Pro, Server, and Online. Furthermore, the performance of generating routes and turn-by-turn driving directions has increased by an average of 50% on desktop machines, and by 30% on mobile devices.

Raster

Identify raster layers

New to this release of the ArcGIS Runtime is the ability to perform identify operations on raster layers to obtain individual raster cell (or pixel) values. Identify is supported for raster layers referencing ArcGIS Image Services, or local raster files (on disk or device). The raster cell values can be displayed in well-formatted UI pop-ups created by the developer or from pop-ups defined in web maps and web scenes authored in ArcGIS Online or ArcGIS Enterprise.

Utility network

Isolation trace

A new trace type, called the isolation trace, has been added. Isolation traces are used to determine the minimum set of operable features required to stop a network's resource, effectively isolating an area of the network. For instance, when a leak occurs on a water network, a manager can use the isolation trace to identify the valves that must be closed to eliminate water flow at the leak location.

Trace filters

Trace filters are a new configuration option for utility networks that restrict the results returned by a trace without preventing it from traversing to the source. These filters allow utility managers to examine the nearest upstream protective devices.

Visualize utility network associations

New with ArcGIS Runtime 100.8 is the ability to visualize network associations on a map using a geometry that represents structural attachment and connectivity associations.

As ArcGIS Runtime continues to add utility network functionality with the 100.8 release, the following describes some of the capabilities that are not currently supported.

• You cannot take the utility network offline. However, you can take simple features (that are in the utility network) offline and edit them with Collector for ArcGIS or other ArcGIS Runtime apps.
• Editing capabilities are limited. You can edit utility network features as simple features, but you cannot perform utility-network-specific edits such as creating or removing associations. Attribute rules will run on the server, and dirty areas will be created, but there are no capabilities to validate network topology from ArcGIS Runtime.
• You can connect only to the default version of the feature service.

Licensing enhancements

You no longer need a Utility Network extension license to load or display a UtilityNetwork object. The license is needed only to perform traces.

Miscellaneous

• A consistent error code for ArcGISRuntimeException is now thrown for null arguments. In previous releases, in cases where a core ArcGISRuntimeException was thrown to report an unsupported null argument, the error code may have been either 1 (null pointer exception) or 2 (invalid argument exception). In this release, error code 1 (null pointer exception) will be reported consistently in this situation.

API changes

Behavior changes

• In some cases, for example some null object errors and parameter out of range errors, the additional information message returned from ArcGISRuntimeException may use a generic term such as object instead of the specific parameter name resulting in the error.
• The isSketchValid members of SketchEditor and GeometryBuilder now check for a minimum number of points in each existing part of a multipart geometry. A polyline must contain at least two valid points in each part, and at least one part. A polygon must contain at least three valid points in each part, and at least one part. Prior to version 100.8, only one part was required to have the minimum number of points. There are no changes for other geometry types.

Deprecations

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 Citrix XenDesktop 7.6 is deprecated. Customers are encouraged to migrate to Citrix new product line, branded Citrix Virtual Apps and Desktops. A minimum of Citrix Virtual Apps and Desktops 7 1912 LTSR will be supported at the next release.

The classic geocode locator format (.loc) will not be supported after ArcGIS Runtime version 100.9. After that release, only the newer .loz locators, introduced with ArcGIS Pro 2.3 and ArcGIS Runtime 100.5, will be supported.

Issues resolved

• BUG-000129571 ArcGIS Earth crashes on adding layer from ArcGIS online when the symbology property for a 3D web layer is set to a Procedural Fill.
• BUG-000119455 GeocodeResult.Label property returns no value for some geocoded addresses.
• ENH-000114198 Provide a functionality to retrieve Raster Information through identify operation.
• BUG-000121574 The downloaded vector tile package does not contain any attribution.
• BUG-000126426 MapView.identifyLayerAsync does not return results from a map service containing a large number of layers.
• BUG-000125810 Changing the FeatureLayer.ScaleSymbols property when the feature layer is a point layer and part of a GroupLayer causes a crash.
• BUG-000128841 HaloColor and HaloWidth properties of the Text symbol are not displayed correctly in SceneView.
• BUG-000128759 Graphics flicker on MapView when the mouse moves over the view.
• ENH-000124541 Provide functionality to retrieve raster cell values through identify or query operation.
• BUG-000113124 Secondary raster will not appear when added to mosaic dataset that is currently being displayed.
• ENH-000126129 While defining LabelExpression for Symbol using JSON, properties like borderLineColor and borderSize do not work as expected for FeatureLayers/Graphic Overlays.
• BUG-000129806 Labels flicker when identifying graphics on the map.
• BUG-000129488 A line graphic is still visible when a point is removed from the Point Collection for specific line symbols GFGPGLB and GFGPGAG in mil2525c style.
• ENH-000125141 Provide support for fast refreshing of raster data.
• Esri Community Post: FeatureLayer.Clone drops DefinitionExpression, Renderer, SelectionColor, SelectionWidth.
• BUG-000122974 ShowCalloutForGeoElement method in SceneView Class causes the application to crash when the background of the identified graphic is not on the earth surface.
• BUG-000128886 An exception is thrown when several Windows Form windows with embedded MapControls are opened.
• BUG-000128196 Clearing or removing the GraphicsOverlay does not cause applications to recover the memory allocated to load the graphics.
• BUG-000122234 Finger-tapping a button inside a CalloutDefintion fails to pop up a message box.
• BUG-000118353 OAuth workflow fails for when authenticating a WebMap containing layers that are added to ArcGIS Portal as item with stored credentials.

Known issues

• BUG-000127369 ArcGIS Runtime applications do not display label callout angle in a mobile map package (.mmpk).
• BUG-000126599 Feature symbology fails to display halos.
• BUG-000127371 ArcGIS Runtime applications fail to display raster symbology in a mobile map package (.mmpk).
• BUG-000127860 Labels fail to display when querying the esriFieldTypeDate field in definitionExpression.
• BUG-000129458 Large vector tile package (vtpk) crashes in x86 Runtime application while zooming or panning
• BUG-000128862 Slow layer rendering performance from a local mobile geodatabase containg large amounts of data.
• BUG-000122413 Querying a not nullable shapefile field ("FID") in the WhereClause causes application to crash.
• BUG-000126301 A tile package (.tpkx) created using the Export Map Server Cache tool fails to load
• BUG-000127930 Panning and zooming in the Xamarin.Forms iOS app causes a crash on when running on an iPad.
• BUG-000123820 The display freezes when minimizing or maximizing the ArcGIS Runtime UWP and Xamarin Forms application with navigation enabled.

Related topics

• Release notes
• System requirements
• Install and set up
• Display a map (Tutorial)