v200.8.0 Release

This release is designed to work with the v200.8.0 version of the ArcGIS Maps SDK for Swift. It includes the following new requirements, enhancements, and resolved issues.

Enhancements in 200.8

General

• Drop support for iOS 16 - iOS 16 is no longer supported by the ArcGIS Maps SDK for Swift.
• An untracked file is now used to store API keys for use with toolkit examples and tests. For more information, please see Configure API Key & Licensing and Configure App Secrets.

Authenticator

• Adds support for Identity-Aware Proxies (IAP). An Identity-Aware Proxy (IAP) is a security feature that enables organizations to manage access to their on-premises web applications and services based on user identity. Typically, it functions as a reverse proxy, acting as a gatekeeper to ensure that only authenticated and authorized users can access specific resources. The authentication process for IAP occurs within a web session using protocols such as OAuth, SAML, or OpenID Connect. During this session, security tokens and cookies are generated, which remain valid throughout the session until they are invalidated. This release adds support for Microsoft Entra Application Proxy.
  • init(promptForUntrustedHosts:oAuthUserConfigurations:) is deprecated and replaced by init(promptForUntrustedHosts:oAuthUserConfigurations:iapConfigurations:) to support authenticating with IAP by optionally passing in configuration settings for the proxy.
• Adds ArcGISAuthenticationChallengeType which allows the authenticator to better decide which type of ArcGISCredential should be created to handle the underlying authentication challenge.
• oAuthUserConfigurations and iapConfigurations are now public read-write properties to allow setting configurations more easily.

FeatureFormView

• The FeatureForm view adds support for viewing utility network associations. Associations model relationships between utility assets in the real world based on connectivity, containment, or structural attachment.
• The view allows users to browse through associated features and return to previously viewed ones. The associations are filtered according to the settings described by the form's UtilityAssociationsFormElement configuration. No associations are displayed if the form doesn't contain the required settings. If the view is used without a form definition, all available associations are displayed without any filters.
  • init(featureForm:) is deprecated and replaced by init(root:isPresented:).
  • FeatureFormView uses a NavigationStack internally to support browsing utility network associations. The new initializer provides an isolated navigation context for the feature form.
• Browse utility network associations in a feature form through the UtilityAssociationsFormElement.
• editingButtons(_:) is added to control the visibility of new built-in Save and Discard buttons.
• navigationDisabled(_:) is added to prevent users from navigating to other associations.
• onFeatureFormChanged(perform:) and onFormEditingEvent(perform:) are added to allow receiving change events from the form.
  • The feature form might change when navigating through the associations in a UtilityAssociationsFormElement.
  • You can run actions based on the form editing events, such as saving and discarding edits.

OfflineMapAreasView

• Fixes a crash when attempting to re-download a deleted preplanned map area while offline.
• Fixes a bug that stops the on-demand workflow from downloading an area. When the view first appears and the extent selector isn't moved, if the download button is tapped, the view behaved incorrectly.
• Fixes a bug when using the view in certain offline situations, the view doesn't show the "No Internet Connection" message.
• Changes the "Delete Map Area" button to "Remove Download" for ahead-of-time and "Delete Download" for on-demand workflows, to better reflect that the actions delete the downloaded data for the map area.

PopupView

• The PopupView adds support for viewing utility network associations. Associations model relationships between utility assets in the real world based on connectivity, containment, or structural attachment.
• The view allows users to browse through associated features and return to those previously viewed. The associations are filtered (e.g., by assembly layer) according to the settings described by the form's UtilityAssociationsPopupElement configuration and presents results in collapsible groups by layer, table, or subtype. The view shows relevant association details - such as connected terminals or fraction along an edge - and supports navigation to the popup of an associated feature, whether spatial or non-spatial, with a back button to return to the previous view. It allows users to exit all associations at once, returning to the original feature, and only display associations that are currently available on the map.
  • init(popup:isPresented:) is deprecated and replaced by init(root:isPresented:) to better support navigating between associated features. PopupView uses a NavigationStack internally to support browsing utility network associations, and the new initializer provides an isolated navigation context for the popup view.
• header(_:) modifier is deprecated. With the new navigation context, the view owns and manages its own navigation stack, so there's no longer support for hiding the header.
• showCloseButton(_:) modifier is deprecated. With the new navigation context, the view decides whether or not to show the close button by the isPresented initializer parameter.
• onPopupChanged(perform:) is added to support custom actions when browsing between popups associated via a UtilityAssociationsPopupElement.

v200.7.1 Release

This release fixes an issue with the offline component's on-demand workflow which prevents an on-demand area being downloaded without moving the selector.

What's Changed

• hotfix: 200.7.1 Release by @yo1995 in #1150

Full Changelog: 200.7.0...200.7.1

v200.7.0 Release

This release is designed to work with the v200.7.0 version of the ArcGIS Maps SDK for Swift. It includes the following new requirements, enhancements, and resolved issues.

You can now deploy applications to Apple's Vision Pro headsets that are running visionOS 2. More information can be found in the System Requirements for this release.

Enhancements in 200.7

• BasemapGallery - Supports 3D Basemaps
• FeatureFormView - Authentication errors will no longer be shown for fields backed by a value expression. The errors are still available in the FieldFormElement's validationErrors property.
• FeatureFormView - The size limit for attachments in a feature form has been increased to 999MB from 50MB.
• OfflineMapAreas - Allows you to take a web map offline by downloading map areas ahead-of-time or on-demand.

Issues resolved

• #401 Mac Catalyst UI issues
• #835 Support Navigation Bar Title For Popup and FeatureForm
• #857 Floor Filter uses non-standard close button #857
• #864 Simplify UtilityNetworkTrace initializer
• #932 Utility Network Trace: Persist starting points after trace
• #936 FloorFilter - Remove automatically setting the viewpoint
• #1022 FeatureFormView - Fixed crash when requesting camera/video access while adding an attachment
• #1071 Resolve FeatureAttachment model crashes in Xcode 16.2
• #1094 FeatureFormView - Consistent validation updates
• #1096 Charts: honor popup color from PopupMediaValue
• #1113 FeatureFormView - Fix multiline text focus handling
• #1138 Field popup element button style incorrect for non-visionOS platforms

v200.6.0 Release

This release is designed to work with the v200.6.0 version of the ArcGIS Maps SDK for Swift. It includes the following new requirements, enhancements, and resolved issues.

There are new System Requirements for this release.

Enhancements in 200.6

Barcode scanning in FeatureFormView

The Feature Form component now supports scanning barcodes to input values for a field. When an authored form contains a field with a BarcodeScannerFormInput, the field will display a "Scan" button. Tapping the button will display the image from the camera, allowing users to scan a barcode and automatically fill the text field with the result of the scan.

TextFormElement in FeatureFormView

The Feature Form component now supports displaying text sections which can be useful for providing instructions on how to fill the form. The TextFormElementView can contain either plain text or Markdown text and supports the following markdown elements:

• Headings
• Bold
• Italic
• Strikethrough
• Quoting code
• Bullet lists
• Numbered lists
• Links

Example:

Support for visionOS

The following components have been enhanced to support visionOS:

• Authenticator
• Basemap Gallery
• Bookmarks
• FloatingPanel
• JobManager
• Overview Map
• Popup View
• Scalebar

Issues resolved

• #956 Marks incompatible AR components unavailable on Mac Catalyst
• #943 UtilityNetworkTrace now selects feature results in the map
• #951 Fixes incorrect Compass rendering when using right-to-left languages
• #958 UtilityNetworkTrace now automatically zooms to the extent of a trace result
• #975 Fixes horizontal scrolling when viewing an attachment carousel on Mac Catalyst while using a mouse with scroll wheel.

v200.5.0 Release

This release is designed to work with the v200.5.0 version of the ArcGIS Maps SDK for Swift. It includes the following new requirements, enhancements, and resolved issues.

There are new System Requirements for this release.

Enhancements in 200.5

Feature Form Attachments

The Feature Form View now supports attachments. You can download and view existing attachments for a feature. You can also collect new attachments such as images or video from the camera or photos library, or other types of files on the device. You can also delete or rename existing attachments.

Preparing for Swift 6

This release makes it easier for your apps to enable Swift Complete Strict Concurrency Checking and ultimately adopt the Swift 6 Language Mode. Updates include:

• Fix warnings when building with strict-concurrency
• Mark thread-safe types as conforming to Sendable.

To learn more, see the Apple documentation on Sendable and Swift 6 migration video from WWDC.

Issues resolved

• #706 - FloorFilter - NavigationStack incompatibility
• #772 - Update API Key instructions. There are new instructions for using API Keys.
• #780 - UtilityNetworkTraceViewModelTests.testCase_2_x, testCase_3_1 failures
• #783 - FloorFilter: SiteAndFacility Manager appearing when panning map
• #802 - Scalebar - unexpected exception

v200.4.0 Release

Note: For users experiencing issues resolving the 200.4.0 package please see the guidance here.

This release is designed to work with the v200.4.0 version of the ArcGIS Maps SDK for Swift. It includes the following enhancements and resolved issues.

Enhancements in 200.4

Augmented Reality

The Augmented Reality (AR) toolkit components allow quick and easy integration of AR into your application for a wide variety of scenarios. Last release we added support for Flyover and Tabletop modes. This release adds support for World-scale mode. In this mode, scene content is placed in the real world by matching the scene’s virtual camera position and orientation to that of the physical device camera. It creates the illusion that your GIS content is physically present in the world around you.

AR_demo.MP4

The toolkit uses ARKit, Apple's augmented reality framework to display the live camera feed and handle real world tracking. Refer to the documentation for more information.

Feature Form

The Feature Form toolkit component provides an easy way for developers to add attribute editing capabilities to their existing applications. The toolkit component supports single- and multi-line text boxes, multiple choice controls like combo boxes and radio buttons, on/off switches, and a date-time picker control. These editing controls can be arranged and organized into groups, and support custom Arcade expressions to control their visibility, editability, whether they are required, or compute the value for a particular attribute.

Refer to the documentation for more information.

Issues resolved

• #540 - Synchronize supported languages with SDK
• #547 - FloatingPanel - Fix locked detent
• #564 - Don't show error text for thumbnail errors
• #607 - Scalebar - Revise auto-hide behavior
• #588 - Centralize API key location for automated unit test runs
• #589 - Add test plans

v200.3.0 Release

This release is designed to work with the v200.3.0 version of the ArcGIS Maps SDK for Swift. It includes the following enhancements and fixes:

Enhancements

• The Augmented Reality (AR) toolkit components allow quick and easy integration of AR into your application using the live camera feed and Apple's ARKit framework. FlyoverSceneView allows you to explore a scene using your device as a window into the virtual world. A typical flyover AR scenario will start with the scene’s virtual camera positioned over an area of interest. You can walk around and reorient the device to focus on specific content in the scene.TableTopSceneView allows you to anchor scene content to a physical surface, as if it were a 3D-printed model.
• The JobManager toolkit component allows long running jobs to execute in the background whenever the operating system permits. This is particularly useful if a user locks the device or switches to another app while a job is in progress. Examples of these types of jobs include taking a map offline or synchronizing edits with a service. The job manager also tracks and persists information about active jobs so that they can be easily recovered and resumed if an app is terminated and then relaunched.
• Authenticator now supports using a personal identity verification (PIV) smart card for authentication when connecting to ArcGIS Enteprise. This requires iOS 16 and iPadOS 16.1, or later, which adds support for physical smart card authentication using an NFC or a CCID class-compliant reader.
• UI text has been localized for 30+ languages.
• Privacy manifest has been added to help generate accurate App Privacy Nutrition labels.
• Required Xcode version is now 15.0.

Fixes

• Ability to use a LoadableImage in an AsyncImageView (#428).
• The names of trace configurations are now listed in alphabetical order in the UtilityNetworkTrace component (#526).

v200.2.0 Release

This release is designed to work with the v200.2.0 version of the ArcGIS Maps SDK for Swift. It includes the following enhancements and fixes:

Enhancements

• Building for Mac Catalyst is now supported
• Required Xcode version is now 14.1
• Documentation and tutorials are available from the Toolkit Reference in DocC format

Fixes

• Various improvements and fixes to the Authenticator
• Support Compass use with SceneView (#326)
• BasemapGallery - Clone basemap prior to setting to avoid "object already owned" error (#328)
• Scalebar refactoring/improvements (#331)
• Added keyboard avoidance support to Floating Panel (#380) and various other improvements
• Add UI Testing App with UI test target and enhance testing of BasemapGallery, Bookmarks, and FloorFilter (#367)
• Improve keyboard focus handling in the SearchView (#7), (#335)
• Many other minor updates to accommodate Swift SDK changes, ease-of-use, bug fixes, and improved behavior

v200.1.0 Release

This is a beta release designed to work with the v200.1.0 version of the ArcGIS Maps SDK for Swift. It includes:

• An architecture based on SwiftUI and the ArcGIS Maps SDK for Swift.
• Eleven components, including a compass, scale bar, custom search view, general-purpose floating panel, Utility Network trace tool, floor filter, and popup view.
• Support for iOS v15.0 and newer and Xcode 14.0 and newer.

There have been a number of improvements since the Beta release, including:

• MapView and Sceneview viewpoint changes are now animated in most components.
• The FloorFilter component now allows clients to get and set the selected site, facility, and level programmatically.
• Authenticator component has been improved based on changes to the Swift SDK.
• Many other minor updates to accommodate Swift SDK changes, ease-of-use improvements, bug fixes, and improved behavior.

v200.0.0-beta Release

This is a beta release designed to work with the v200.0.0-beta version of the ArcGIS Maps SDK for Swift. It includes:

• An architecture based on SwiftUI and the ArcGIS Maps SDK for Swift.
• Eleven components, including a compass, scale bar, custom search view, general-purpose floating panel, Utility Network trace tool, floor filter, and popup view.
• Support for iOS v15.0 and newer and Xcode 14.0 and newer.