Release notes for 100.13

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

For 100.13.2

Issue Resolved

BUG-000148092 Navigating a scene view crashes or freezes on newer iOS devices running iOS 15.4.

ArcGIS Runtime 100.13.2 fixes a bug that causes 3D apps on iOS 15.4 crash or freeze on newer devices with A14 chip or later while displaying or interacting with scene view.

For 100.13.1

Upgrade version of Expat library to 2.4.6

BUG-000146895 The version of Expat library has been upgraded to 2.4.6.

Expat is a 3rd-party library used by ArcGIS Runtime to provide stream-oriented XML parsing functionality. The library is used in open-source software like Apache, Mozilla, Perl, PHP, and Python, along with most Linux distributions.

Expat has recently patched vulnerabilities that expose XML processors to at least two exploit vectors: arbitrary code execution, or denial-of-service. ArcGIS Runtime 100.13.1 includes the patched version of the Expat library.

For 100.13.0

Enhancements

Scenes

Support for floor-aware scenes

The previous release added support for floor-aware maps, and ArcGIS Runtime 100.13 builds on that capability by adding support for floor-aware scenes. You can now filter data displayed by feature layers, point scene layers, and 3D object scene layers based on floor levels. This makes it easy to visualize building floor plans and explore indoor data in 3D.

Vector Tile layers in 3D

With this release, vector tile layers are now supported for basemaps in a scene. You can use ArcGIS vector tile layer basemaps with the default styles, as well as with your custom styles created with the ArcGIS Vector Tile Style Editor, or your own content. This can simplify the process of designing applications that work in both 2D and 3D, as well as data publishing workflows that support your apps.

Vector tiles basemaps provide high quality, resolution-independent display of complex cartography, and in general they deliver improved performance. In your ArcGIS Runtime applications, they provide an efficient way to deliver offline basemaps (whether exporting tiles from a vector tile service, or delivering vector tiles in vector tile packages or mobile scene packages, etc).

With support for vector tile layers in a scene, you can now take advantage of the API Key enabled basemap styles when working in 3D.

Indexed 3D Scene Layer (I3S) versions 1.7 and 1.8

ArcGIS Runtime now supports Indexed 3D Scene Layer (I3S) specification versions 1.7 and 1.8 for 3D Object Scene Layers and Integrated Mesh Scene Layers in applications deployed on iOS devices. This enhancement delivers an improved user experience during the initial load and rendering of scene layers and during scene view interaction and navigation. Depending on the size, complexity, and i3S version of your data, you may see rendering time reduced by up to 60%.

I3S version 1.7 provides improved indexing of nodes within scene services and scene layer packages that enables ArcGIS Runtime to optimize requests for data, resulting in reduced network traffic or file access and faster layer load times. I3S version 1.8 adds support for textures encoded in Basis Universal, a GPU-optimized texture compression format that significantly reduces the image storage size while maintaining quality.

To ensure that you can take advantage of the latest improvements with your data, use the I3S converter in the I3S GitHub repository to update the version of an integrated mesh or scene layer package (.slpk) to the latest version. You can also use ArcGIS Pro's Create 3D Object Scene Layer Package and Create Integrated Mesh Scene Layer Package geoprocessing tools to create scene layers at the latest version.

Layers

Display filters on feature layers

ArcGIS Runtime 100.13 adds support for display filters ( AGSFeatureLayer.displayFilterDefinition ) on feature layers. Display filters limit the number of features displayed to reduce clutter in a map or scene.

Use a display filter when you want to draw a subset of features while maintaining access to all of them. Unlike a definition expression, features hidden by a display filter are available for selection, identify, editing, and geoprocessing operations.

Display filters can be added to maps and scenes authored with ArcGIS Runtime, or published in web maps using ArcGIS Pro 2.9 or higher.

OGC API - Features

100.13 adds support for reading and writing web maps that contain OGCFeatureLayer.

Symbols

Composite and multilayer symbols for location display

With this release, you can use composite symbols or advanced (multilayer) Cartographic Information Model (CIM) symbols for different location display symbols. Note that if the symbol assigned is not appropriate for the geometry type, the symbol will not render. See the Device location topic for more information about customizing the location symbols.

Persisting CIM symbols in a web map

With 100.13, advanced (multilayer) symbols can be saved in a web map. At 100.12, only advanced point symbols ( AGSMultilayerPointSymbol ) were persisted when saving a web map, while advanced polyline ( AGSMultilayerPolylineSymbol ) and polygon ( AGSMultilayerPolygonSymbol ) symbols were dropped. With this release, all types of advanced symbols can be saved to a web map.

New conversion helper for picture fill and picture marker symbols

A new method, toMultilayerSymbol(), is now available on AGSPictureFillSymbol and AGSPictureMarkerSymbol . This helper method converts any simple picture symbol to a multilayer symbol.

Alternate symbols and scale-based symbols for unique value and class breaks renderers

At 100.12, ArcGIS Runtime only supported alternate symbols from a mobile map package (.mmpk). At 100.13, alternate symbols in a web map are now also honored. In addition to consuming the persisted symbols, you can define your own scale-based and alternate symbols for unique value and class breaks renderers in your app. If they are multilayer symbols, they can be persisted and saved to a web map.

Use of ordered anchor points for multipoint geometry

As announced in the 100.12 release notes, dictionary renderers support symbolizing control measure lines based on ordered anchor points according to standard military symbology specifications MIL-STD 2525 and APP-6. With the release of ArcGIS Pro 2.9, these updated military dictionary styles can be downloaded from ArcGIS Online.

Developers can now use these styles to render control measure lines by setting the AGSDictionarySymbolStyle model configuration property to "ORDERED ANCHOR POINTS".

Geodatabase

Honor server logic for feature service client edits

Feature service geodatabases may execute business logic on the server in response to edits made on the client. A composite relationship, for example, causes a feature in the destination table to be deleted when a related feature is deleted in the origin table. Other examples include attribute rules and utility network association editing. At 100.13, ArcGIS Runtime incorporates these changes from the server appropriately. Use AGSServiceGeodatabase 's AGSServiceGeodatabase.applyEditsWithCompletion: to take advantage of this functionality rather than calling AGSServiceFeatureTable.applyEditsWithCompletion: independently on the individual feature tables.

Contingent values support

Contingent values, sometimes referred as contingent attribute values, are a data design feature that allows making values in one field dependent on values of another field during attribute editing.

Attribute domains allow restricting the valid entries on a field to a defined list or range of values. Contingent values extend this model by making your choice for a value on one field further constrain the domain values that can be placed on another field.

ArcGIS Runtime now supports reading the contingent value definition from a feature service, an offline replica geodatabase, or a standalone mobile geodatabase as long as contingent values are defined for tables within these datasets. This can help you build a comprehensive UI for attribute editing. AGSContingentValuesDefinition provides information about contingent values. It contains a list of field groups, each of which defines contingencies for a set of fields. The AGSContingentValuesDefinition must be loaded after the table has loaded. If the list of field groups is empty after loading, no contingent values are defined for the table.

AGSArcGISFeatureTable has methods that encapsulate validation logic and provide the available options for each field.

Labeling

Support for dimension layers

Dimensions are used to represent schematic distance information, and include symbology definitions, position information, and text content. See Dimensions in the ArcGIS Pro documentation for more information.

At 100.13, your ArcGIS Runtime app can read dimension layers from:

• Mobile map packages
  • Known limitation: If an ArcGIS Pro map has a different spatial reference from the dimension layer spatial reference, and is published to an mmpk, then the dimension layer might not appear when the mmpk is imported (into ArcGIS Runtime or ArcGIS Pro).
• Mobile geodatabases
• Enterprise service layers
  • When replicating an online geodatabase locally, dimensions are automatically loaded.
  • Dimension layers are supported in versioned servers, but require Enterprise 10.9.1.

Dimension layers are accessible in the map's operational layers collection and support identify, selection, and visibility. A dimension layer, its feature table, and the individual features are all read-only, as are the layer and style properties.

Dimension graphics render with the same values and in the same locations as in ArcGIS Pro, but you may notice some differences in dynamic aspects of the drawing, such as when arrow heads flip from inward to outward to make room for text. This is because of differences in text and drawing metrics on different target platforms.

ArcGIS Runtime labels automatically avoid overlap with dimension graphics. If labels have a deconfliction strategy of dynamic or dynamic never remove, they move to avoid or minimize overlap.

Labels can avoid polygon and line features

At this release, ArcGIS Runtime labels can avoid or be excluded from overlapping polygon or line features if the label definition for the layer containing those features is defined to avoid such an overlap.

See AGSLabelDefinition properties deconflictionStrategy, featureBoundaryOverlapStrategy, and featureInteriorOverlapStrategy. Note that the label definition for the obstacle feature layer does not need to produce labels, just specify an overlap restriction.

Labels automatically avoid annotation layers

With 100.13, ArcGIS Runtime labels automatically avoid overlapping annotation that is added to a map in an annotation layer. If labels have a deconfliction strategy of dynamic or dynamic never remove, they move to avoid or minimize overlap.

Arcade higher order functions

The Arcade script language has been extended with several higher-order functions. These can be used to apply other functions to arrays of values:

1
2
3
4
5
6
7
map([A], f(A) -> B) -> [B]
reduce([A], f(A, A) -> A) -> A
reduce([A], f(B, A) -> B, B first) -> B
filter([A], f(A) -> bool) -> [A]
any([A], f(A) -> bool) -> bool
all([A], f(A) -> bool) -> bool
none([A], f(A) -> bool) -> bool

See the Arcade documentation for more information.

Support Arcade Expects function

With 100.13, ArcGIS Runtime support for Arcade includes the Expects function. This allows you to predeclare attributes for a given feature or feature set that your script requires.

Support point scene layer labels stored in a web scene

In previous releases, only web scene labels defined at the feature server level were displayed. With 100.13, label definitions stored within the web scene rest description are displayed. This means that any label definitions added to a web scene via ArcGIS Online are honored in your ArcGIS Runtime app.

More accurate 3D label deconfliction

The internal calculation to handle conflict detection has been updated to improve accuracy.

Utility Networks

Full support for association deletion semantics

In a utility network, features that belong to a specific asset type can serve as containers or structures. Each of these containers or structures has association deletion semantics, which are rules that define what happens to associated features when the container or structure is deleted.

• Cascade: deleting a container causes its associated features to also be deleted.
• Restrict: deleting a container is not permitted if it contains associated features.
• None: associated features are not deleted when their container is deleted.

While previous releases provided limited support for association deletion semantics, full support is now enabled in 100.13. For example, content features may automatically be deleted when their container feature is deleted.

Display filters for utility network workflows

You can use display filters to show and hide features inside containers, replicating the functionality available in ArcGIS Pro. You can also use display filters to ensure that critical network features are returned in a trace result even if they are removed from view to simplify the display.

Device location

New Indoor Positioning API

With this release, ArcGIS Runtime introduces a new Indoor Positioning API. Indoor Positioning allows you to locate yourself and others inside a building in real time. Similar to GPS, it puts a blue dot on indoor maps and uses location services to help you navigate to any point of interest or destination.

See the Indoor positioning topic for more information.

GPS accuracy considerations for Geotrigger monitoring

With this release, the Geotrigger API has been enhanced to better handle potential inaccuracies with GPS locations. You can:

• Use an Arcade expression to filter location updates. This allows you to reject locations that don't meet a minimum level of accuracy.
• Choose how to interpret the accuracy information included with a GPS reading. This allows you to control whether a given position is considered to have entered a fence or not.

Coordinate systems and transformations

Enhancements to projection engine

• The plate carrée projection now supports an oblique variation.
• New geographic coordinate systems for high-speed rail lines in the UK have been added.
• New geographic/datum transformations for UK high-speed rail lines, Iceland, Chile, Germany, Serbia, Bangladesh, Canada, Italy, and Australia have been added.
• New projected coordinate systems have been added for high-speed rail lines in the UK, Italy, Canada, Illinois (ICS), GSK-2011 Gauss-Kruger zones for Russia, Bangladesh, and international feet-based California Teale Albers.
• New vertical coordinate systems have been added for Spain.
• Several new vertical coordinate systems and transformations based on geoids, quasi-geoids, or other conversion grids are available. You can use them to transform to or between gravity-related vertical coordinate systems for the following countries and areas: Australia, Austria, Azores (central and eastern islands), Canada, Canary Islands, Europe (EVRF 2007 and EVRF 2019), France, Ireland, Netherlands, Portugal, Slovakia, Spain, Switzerland, and the United Kingdom.

Stand-alone developer documentation

You can download the developer documentation (for any ArcGIS Runtime API) as an archive from the downloads. The archive contains instructions to serve the documentation from a local web server so you can access it without a connection to the internet. The stand-alone documentation includes the developer guide, API reference, tutorials, and samples documentation. This documentation is designed to run on a local stand-alone computer or on an internal network and not on the public internet.

To serve the documentation locally:

• Download the documentation for the ArcGIS Runtime API(s) you want to use. The downloaded files are in a .zip archive format.
• Extract the archive to a local folder. The extracted archive has two subfolders: public and install.
• Open the README.md file in the install folder and follow the instructions for your chosen web server.

Breaking API changes

ArcGIS Runtime API for iOS is now distributed as 2 separate binary frameworks - ArcGIS.xcframework and Runtimecore.xcframework. This decoupling allows us to use the latest and best methods to compile, link, and generate the binaries. If you use Swift Package Manager or Cocoapods to integrate ArcGIS Runtime into your Xcode projects, you don't need to make any changes. Your projects will automatically be configured to include both frameworks when you upgrade to 100.13. However, if you manually download the SDK and configure your projects, you will need to add the new Runtimecore.xcframework file to the Frameworks, Libraries, and Embedded Content section of your target's build settings.

Behavior changes

• 3D labeling now allows overlapping labels. AGSLabelDefinition.deconflictionStrategy is now used for 3D labeling as well as 2D. By default, the property is static, which places labels at their preferred positions but does not allow them to overlap - so less important labels are dropped. If set to none, the labels will place at their preferred position, regardless of overlap.
• Loading a map now loads all the base layers in the basemap. This is required to correctly initialize the scale range of the map based on the combined scale range of all the base layers in the basemap.
• Geotriggers are no longer restricted to a maximum number of features. Prior to 100.13, geotriggers using online feature data were limited by the maximum feature setting for the service (generally 1,000 - 2,000). For fences based on a service with many features, notifications would only be generated for that subset of the data. With the current release, where supported by the feature service, this restriction has been removed by paging through all of the service's features.
• The AGSJob.cancel() API now supports sending cancelation requests to server-side jobs, such as those that export map tiles or generate a geodatabase. Therefore, when a job is canceled in your ArcGIS Runtime applications, the back-end system will not continue to do unnecessary work. This can greatly reduce load on the servers.
• Taking a feature service offline includes contingent value information. If a feature service has contingent values defined, then taking the service offline will include contingent values information by default.

Deprecations

There are no deprecations with this release.

Issues resolved

Issues addressed in this release are listed below.

BUG-000135628 Changing raster TIFF image rendering sometimes crashes the application.

BUG-000140743 Assigning a CompositeSymbol object to the LocationDisplay.CourseSymbol property results in an error.

BUG-000143392 Opening mobile map packages containing a lot of symbols in ArcGIS Runtime 100.12 takes a long time compared to 100.10.

BUG-000144713 Mobile map package containing scale-dependent symbols is not honored.

ENH-000142671 The label engine does not respect barrier weights of an annotation class.

Known issues

Known issues for this release are listed below.

BUG-000124058 When the Imagery basemap is added to a map, it takes a longer time to identify the features.

BUG-000129618 The feature layer's fields return "null" value when the enumeration Enums.QueryFeatureFieldsLoadAll is called asynchronously to query on the feature layer before calling the query enumeration Enums.QueryFeatureFieldsMinimum.

BUG-000142001 The offline workflow does not adhere to definition queries for read-only feature service layers that reference the same feature class source, which results in symbology overlap.

BUG-000143860 Certain labels on a mobile map package are not rendered correctly.

BUG-000143774 Using an ImageOverlay with an 8kx8k image is extremely slow.

BUG-000145159 Textured line styles do not draw correctly for vector tile layers in a scene view.

Changes in samples

Samples that demonstrate the use of ArcGIS Runtime API are described in the Sample Code section of this guide. You can download the source code for the samples viewer and all the samples it contains from the associated GitHub repository.

The following changes have been made to the samples since the previous release.

New samples

• Toggle between feature request modes
• Export vector tiles
• Select ENC features
• Display a map SwiftUI
• Filter by time extent
• Display dimensions
• Browse building floors

Enhancements

• Added new sketching options to Sketch on the map.
• Updated OpenStreetMap layer to demonstrate purpose-built class.
• Removed service feature table cache samples in favor of new Toggle between feature request modes.
• Updated app info page.
• Updated main README with instructions for installing SDK manually.
• Updated READMEs.
• Updated Display KML network links service.
• Removed ArcGIS vector tiled layer (URL).

Bug fixes

• Fixed various bugs in the following samples: Identify raster cell, Map reference scale, and Show legend.

Related topics

• System requirements for 100.13
• Install and set up
• Display a map (Tutorial)