Release notes for 100.10

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

Enhancements

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

API keys

With ArcGIS Runtime 100.10.0, you can access content on ArcGIS Online, such as web maps, web scenes, layers, items, and services, with an API key. An API key provides an access token that authenticates access to secured resources. You can use this API key to monitor service usage from your apps. Configure an API key with the following:

ArcGIS Location Services your key is permitted to access.
Map or layer content (items) accessible with the key, such as hosted feature services, web maps, web scenes, tile layers, and so on.

API key authentication has been improved. You now use an API key credential item to create a long-lived API key access token. All API keys created before June 2024 will continue to function, and are known as API keys (legacy). From June 2024, you will no longer be able to create API keys (legacy). It is recommended that developers replace all existing API keys (legacy) with access tokens from API key credentials.

See Migrate from API keys (legacy) to API key credentials for instructions on how to move away from API keys (legacy).
See Create an API key to learn how to create API key credentials to get a long-lived access token.

For more information about using and monitoring API keys, see the API keys topic in the guide.

New basemap styles

ArcGIS Runtime 100.10 introduces a new enum, AGSBasemapStyle, that defines a set of Esri basemaps for use in a map or scene. These basemaps are based on services that are secured and globally load-balanced for high performance. They can be accessed via an API key (described above) or user authentication. When using an API key, you can monitor the usage of the basemap services from your apps.

Features

Support for Arcade 1.11 in popups

With ArcGIS Runtime 100.10.0, the following Arcade 1.11 functions in popups are now supported:

Domain
Schema
SubtypeCode
SubtypeName
Subtypes

Support for all other Arcade 1.11 functions in popups was added at 100.9.0. See the Arcade version matrix for more details about Arcade support.

Session management for branch versioned feature services

ArcGIS Runtime 100.10 now provides an option to limit viewing and editing access to branch versioned feature services through session types (AGSFeatureServiceSessionType). A service geodatabase in a persistent session will acquire a shared lock from the server during load which may be upgraded to an exclusive lock during an edit to allow multiple simultaneous viewers or a single editor. A service geodatabase in a transient session will not hold a lock in order to allow concurrent viewers and editors. A new close method has been added to service geodatabase that will stop any active viewing or editing by releasing any acquired locks. A web map or web scene with feature layers and tables from branch versioned feature services will load in a transient session by default and may be changed to load in a persistent session at the map or scene level via load settings.

Graphics

Performance improvement

There is a significant improvement in this release when creating graphics with multiple attributes or setting multiple attribute values on graphics. Compared to the previous release, performance for such operations is up to 40% faster.

Location

High-accuracy GPS location

ArcGIS Runtime 100.10 includes a new location data source,AGSNmeaLocationDataSource, for parsing NMEA messages from high-accuracy GNSS devices (GPS receivers). NMEA versions 4.11 and earlier are supported. The locations that are generated contain advanced metadata, such as satellite configuration, dilution of precision (HDOP, VDOP, PDOP), differential correction age, etc. This is similar to the functionality included in ArcGIS Collector.

Maps and scenes

Feature tiles in 3D

Feature layers displayed in a scene now use tile-based requests to fetch and display features when the underlying feature service supports this capability. Feature tiles enable ArcGIS Runtime to display more features from the service, and provides faster initial load time by generalizing complex geometries for display. Feature tiles use a Protocol Buffers binary format to compress the data being transferred, along with advanced HTTP caching semantics to reduce the impact of network latency and improve performance. This functionality was added at 100.9 for 2D maps.

Labeling in 3D

You can now enable labeling in an AGSSceneView in the same way you could previously in an AGSMapView. Point, line, and polygon feature layers from web scenes, line and polygon feature layers from mobile scene packages (.MSPK), and graphics overlays can all display labels on or around features rendered in the 3D scene.

The same AGSLabelDefinition specification for each label class attached to a feature layer or graphics overlay is used to control positioning of the text labels.

Labeling of point feature layers from a mobile scene package or using a LabelSymbol3D from a web scene is not supported in this release.

Single request mode for rendering Image Service raster in maps

Rendering of Image Service rasters in a map has been improved by using a single request to fetch image data from the server. This results in a single, consistent, contiguous image that fills the view extent, rather than displaying a patchwork of individual tiles, and in some cases, reduces the latency of displaying the data.

Supported web map specification

At this version, ArcGIS Runtime supports version 2.18 of the web map specification. The supported specification governs which properties are preserved when loading and saving maps. See the web map specification documentation for more information.

Network analysis

Enhanced abbreviations for route directions

Network/Transportation datasets can now include an abbreviation table, which allows ArcGIS Runtime to apply more accurate and flexible abbreviation expansion when generating voice guidance instructions from the direction text. These tables can be created and populated using ArcGIS Pro.

Offline maps

Take a map offline using web map authors settings for online layers

In this release, AGSOfflineMapTask has been updated to recognize settings made by the web map author, to allow leaving layers online. In previous releases, offline workflows either skipped online-only content entirely, or required the developer to specify which layers should remain online. With this update, using the web map author's settings now allows apps to be much more data-driven and gives the author more options for configuring workflows. For example, an author can set up a map to include online-only layers (such as traffic or weather), or they can mandate that a specific layer always remain online (perhaps because it is updated on a regular basis). Currently, there is no online authoring experience to allow the web map author to configure these settings.

Support for .tpkx file format in ExportTileCacheTask

This release of ArcGIS Runtime supports the newer, Compact Cache V2 (.tpkx) format for exporting tiles using AGSExportTileCacheTask. This is in addition to the existing .tpk format already supported. Data in Compact Cache V2 format conform to this open Tile Package Specification, which is used widely across the Esri platform, including ArcGIS Pro. Exporting tiles in the Compact Cache V2 (.tpkx) format is supported by ArcGIS Server, beginning with version 10.9, and by Esri's public basemaps.

Opt in to use the "reduced fonts" version of Esri vector basemaps

When taking Esri's vector basemaps offline, the full set of fonts provided by the Esri’s World Basemaps are included in the vector tile package (vtpk file). This can add significant overhead and bloat the size of the download, especially when taking small areas offline. This release includes the option to download Vector Basemaps (for Export), which provides a reduced set of fonts instead. This option includes fewer fonts and can significantly reduce the time required to export and download a vector tile package (vtpk) file. Note that because not all fonts are included, some styles containing labels and text in non-latin characters will not display correctly, so this option is not appropriate for all use-cases.

Troubleshoot geodatabase synchronization

At 100.10.0, if you are experiencing problems synchronizing your geodatabase, you can retain, inspect and troubleshoot the synchronization delta geodatabase files. If you set the keepGeodatabaseDeltas parameter on the AGSSyncGeodatabaseParameters or AGSOfflineMapSyncParameters then the delta geodatabase files will be saved to the app user’s temp directory. There are two types of delta files:

Upload delta files contains local geodatabase changes to be sent to the originating feature service.
Download delta files contains changes from the feature service to be applied to the local geodatabase.

OGC API - features

Filter features with a time extent

At this release, ArcGIS Runtime supports filtering OGC API feature collections using a query based on the TimeExtent of the AGSGeoView that contains them.

Support for Common Query Language JSON

At this release, ArcGIS Runtime provides additional support for Common Query Language (CQL). Version 100.9 introduced support for CQL_text, and this release extends CQL support to include CQL_JSON expressions in the AGSQueryParameters.WhereClause.

Load and query non-spatial feature collections

At 100.10.0, ArcGIS Runtime supports loading and querying of features from a non-spatial OGC feature collection table.

Populate features in the map's spatial reference

When populating or updating a local table from an OGC service, you can now request features in a specified spatial reference (also referred to as SRS in ArcGIS or CRS in OGC). This leverages the power of the server to return features in the same spatial reference as your map rather than having to reproject them on the client.

Honor spatial reference when querying or filtering with geometry

With this release, the spatial reference will be honored when using a bounding box (AGSEnvelope) or output spatial reference to query a feature collection. This allows you to return features in the specified spatial reference without having to reproject them on the client.

Symbols

New simple line symbol styles

The following new styles are available for AGSSimpleLineSymbol:

Long dash
Long dash dot
Short dash
Short dash dot
Short dash dot dot
Short dot

Note that the default cap style for AGSSimpleLineSymbol is now butt which matches ArcGIS Pro and ArcGIS Online. This differs from the previous ArcGIS Runtime release, which used a rounded cap style. To create dash patterns with rounded caps use AGSMultiLayerSymbol with a rounded cap style.

Read and write web maps that contain advanced symbols

Cartographic Information Model (CIM) symbols, also known as advanced symbols, are now included in the web map specification for representing points. At this release, ArcGIS Runtime is able to read advanced point symbols saved in a web map, and also save them.

Use a web style the same way you use a local style

ArcGIS Pro release 2.6 allows you to publish a style file to ArcGIS online or Enterprise portal. This published style is referred to as a "web style". At this release, you can work with a web style just as you would a style file stored on your local filesystem or device. You can create a style from a URL or portal item and then search and retrieve symbols as you would a local style. You can also use the Esri web styles for 2D and Esri web styles for 3D in your maps and scenes.

Support for web styles when taking a map offline

At this version of ArcGIS Runtime, the desktop style that corresponds to a given web style stored with a dictionary renderer will be discoverable when taking a map offline. This will be available as a URL in the WebStyle2DesktopStyle relationship. Publishing a web style with a related desktop style is available with Pro 2.7 and ArcGIS portal 10.9.

Scale expressions in a dictionary renderer

At this release, ArcGIS Runtime SDK honors a scale expression defined in a dictionary renderer.

Utility networks

Utility network information preserved when opening or saving web maps

With ArcGIS Runtime 100.10.0, you can now read a web map that contains utility network information (available when published with ArcGIS Pro 2.6). A new utilityNetworks property returns a collection of utility networks stored with the map. All utility networks in this collection are also saved in the web map.

Branch versioned utility network

ArcGIS Runtime 100.10.10 can now run a trace and get associations on a named version. A new read-only service geodatabase property has been added to allow feature tables participating in a utility network to be grouped and collectively switch to a named version, apply service-level editing, and run related record queries. The service feature tables for every utility network source will load in a transient session and connect to the default version. When loading a utility network from a web map, use the AGSLoadSettings for the map to change the session type and then switch versions on the AGSServiceGeodatabase to work on a named version.

Nonspatial association queries

With ArcGIS Runtime 100.10.0, you can now query connectivity associations between spatial features and nonspatial junction and edge objects in a utility network with schema version 4 or later. New nonspatial enumeration values that describe nonspatial connectivity have been added to AGSUtilityAssociationType, as well as a new property FractionAlongEdge to AGSUtilityAssociation that defines how far the junction is located from the nonspatial edge. Nonspatial associations may be returned when a utility element is used to get associations.

Filter barriers

At 100.10.0, you can now collect and send filter barriers when running a trace in a utility network from ArcGIS Enterprise 10.8.1 or later. Feature barriers can now be treated like filter barriers in subnetwork-based traced where they would otherwise restrict traversal from the trace starting points to the subnetwork controllers. A new property, FilterBarriers, has been added to AGSUtilityTraceParameters for this purpose.

Support for trackpad, mouse, and keyboard on iPad

AGSMapView and AGSSceneView have been enhanced to support interaction and navigation on an iPad using keyboard shortcuts and accessories, such as a mouse or a trackpad. Users can pan, zoom, rotate, and tilt the map or scene using familiar gestures, such as click, tap, pinch, drag, and swipe. To see the full list of supported keyboard shortcuts, users can long-press the command (⌘) key when the pointer is over the map or scene.

Breaking API changes

ArcGIS Runtime is now distributed as a binary XCFramework (.xcframework file). This format was introduced in Xcode 11 and has several advantages that, through a single bundle, make it easy to package, distribute, and integrate code for various target platforms and architectures. Also, the location of the framework has changed from $HOME\Library\SDKs\ArcGIS\iOS\Frameworks\Dynamic to $HOME\Library\SDKs\ArcGIS\Frameworks.

If you use cocoapods to integrate ArcGIS Runtime into your projects, these changes will be hidden from you. However, if you download the installer and manually configure your projects, you will need to make the following changes when upgrading to ArcGIS Runtime 100.10:

Under the target's Build Phases settings, remove the Run Script phase that you previously added to invoke the strip-frameworks.sh script. This phase is no longer needed.
Under the target's General settings, remove the reference to ArcGIS.framework from Frameworks, Libraries, and Embedded Content section.
Drag and drop the ArcGIS.xcframework file found under the $HOME\Library\SDKs\ArcGIS\Frameworks directory to the Frameworks, Libraries, and Embedded Content section.

Behavior changes

A utility network created from a map with feature layers from standalone service feature tables will no longer be composed of shared table instances. This means a branch version is not guaranteed and utility element to feature conversion needs to use the utility network source’s name instead of a table reference. To ensure table instances are shared, the map could either be created from a web map or its feature layers created from a service geodatabase matching the utility network’s feature service.
When taking Esri basemap services offline (using the AGSExportTileCacheTask, the AGSExportVectorTilesTask or the AGSOfflineMapTask) you are no longer required to specify an export-enabled version of the service. Starting with version 100.10.0, ArcGIS Runtime will automatically switch to an appropriate export-enabled service when exporting a .tpk or .vtpk. Be aware that exporting tiles from Esri basemap services requires you to be authenticated with the service using user authentication or an API key.
The default cap style for AGSSimpleLineSymbol is now butt which matches ArcGIS Pro and ArcGIS Online. This differs from the previous ArcGIS Runtime release, which used a rounded cap style. To create dash patterns with rounded caps use AGSMultiLayerSymbol with a rounded cap style.

Deprecations

Locators created with the Create Address Locator tool (Geocoding toolbox) will not be supported after ArcGIS Runtime version 100.11. With the 100.12 release, only the locators created with the Create Locator tool (Geocoding toolbox) will be supported. The deprecated locator format is composed of the files .loc, .loc.xml, .locb, and .lox. The newer locator format is composed of the files .loc and .loz.

Support for deploying apps to iOS 12 is deprecated. A minimum of iOS 13 will be required at the next release.

Issues resolved

BUG-000135039 Japanese characters are not correctly displayed in Vector Tiled Layer

BUG-000132755 MrSID imagery renders slowly compared to previous versions

BUG-000132824 Importing delta fails during sync with a geodatabase containing many-to-many relationship

BUG-000133218 The DictionaryRenderer is not honoring Size overrides specified in the .stylx file's Arcade script.

Generalized feature geometry returned when loading featurelayer See Esri Community post

BUG-000134479 Identify operation fails to identify circular polygon features on large scales.

ENH-000105118 Functionality to track locations using GPS, other than the system's built-in location provider, should be included in ArcGIS Runtime

BUG-000133727 ArcGIS Runtime does not display french accent characters correctly from Shapefile.

BUG-000133310 The GroupLayer sublayer labels are visible despite the layers being toggled off in a mobile map package.

BUG-000134839 ArcGIS Runtime does not render all features from a point operational layer residing in a mobile map package.

ENH-000134742 Provide support for KMLGroundOverlay class with a 2D MapView

BUG-000132920 The error message, "SQL error or missing database" is returned when syncing a large number of edits.

ENH-000128888 Improve Dark Mode View of Map Attribution Control

BUG-000131598 The login prompt continues to show if the wrong password is entered on the first attempt to access a portal with Integrated Windows Authentication (IWA).

BUG-000133956 The activity indicator continues to show in some iPhone models after loading a basemap residing in a portal with Integrated Windows Authentication (IWA).

Known issues

BUG-000133189 Labels in a mobile map package (.mmpk) don't give a nice user experience when the map rotates in the Navigation mode.

BUG-000135349 Layers with refresh interval are visibly redrawn on the map, causing a flicker effect.

BUG-000135111 Poor performance during zoomin and zoomout with WMTS layer

BUG-000136638 Renderer.getSymbol returns Null if renderer references a dictionary web style.

BUG-000136545 Unable to add photo/video attachments using Popups when limiting access to only selected items in iOS 14