Toolkit

ArcGIS Maps SDK for Swift offers an open source toolkit that contains ready-made UI components to simplify the development of mapping and GIS apps in Swift. Check out the examples project to see these components in action or read through the documentation to learn more about them.

To use Toolkit in your project:

• Install with Swift Package Manager - Add https://github.com/Esri/arcgis-maps-sdk-swift-toolkit as the package repository URL.

Toolkit Components

• Authenticator - Displays a user interface when network and ArcGIS authentication challenges occur.
• BasemapGallery - Displays a collection of basemaps.
• Bookmarks - Shows bookmarks, from a map, scene, or a list.
• Compass - Shows a compass direction when the map is rotated. Auto-hides when the map points north.
• FeatureFormView - Enables users to edit field values of a feature using pre-configured forms.
• Floating Panel - Allows display of view-related content in a "bottom sheet".
• FloorFilter - Allows filtering of floor plan data in a geo view by a site, a building in the site, or a floor in the building.
• FlyoverSceneView - Allows you to explore a scene using your device as a window into the virtual world.
• JobManager - Manages saving and loading jobs so that they can continue to run if the app is backgrounded or even terminated by the system.
• OfflineMapAreasView - Allows you to take a web map offline by downloading map areas.
• OverviewMap - Displays the visible extent of a geo view in a small "inset" map.
• PopupView - Displays details, media, and attachments of features and graphics.
• Scalebar - Displays current scale reference.
• SearchView - Displays a search experience for geo views.
• TableTopSceneView - Allows you to anchor scene content to a physical surface, as if it were a 3D-printed model.
• UtilityNetworkTrace - Runs traces on a web map published with a utility network and trace configurations.
• WorldScaleSceneView - Allows you to integrate scene content with the real world.

Enhancements in 200.7

Feature Form

• Authentication errors will no longer be shown for fields backed by a value expression. These errors are still available in the FeatureForm.validationErrors property of the FieldFormElement.
• The size limit for attachments in a feature form has been increased to 999MB from 50MB.

Offline Map Areas

The OfflineMapAreasView allows users to take web maps offline. Users can download map areas created ahead-of-time by the web map author, or they can create map areas on-demand by specifying an area of interest and level of detail. Map areas are downloaded to the app's Documents directory and can be used even when the app is completely offline. Users can get information about a map area such as its size and the geographic region it covers. They can also delete a downloaded map area to free up storage space on the device.

Popup chart enhancements

The charts displayed by PopupView now honor the custom colors configured by the web map author. This allows the popup to highlight information in the chart or make it look cohesive by matching the color theme of the app or layer.

Support for visionOS

Building on the work started in the previous release, the remaining toolkit components have been enhanced to support visionOS:

• Compass
• Floor Filter
• Feature Form
• Search View
• Utility Network Trace

For a complete history of enhancements, visit the toolkit Release

Resources

• ArcGIS Maps SDK for Swift
• System requirements
• Get started

Instructions

Swift Package Manager

1. Open your Xcode project. In the menu bar, select File > Add Package Dependencies...
2. In the search bar, enter https://github.com/Esri/arcgis-maps-sdk-swift-toolkit as the package repository URL.
3. Optionally, select an option for the Dependency Rule if you want to specify an exact version or a range of versions to use.
4. Click Add Package.
5. Add import ArcGIS and import ArcGISToolkit in your source code and start using the toolkit components.

New to Swift Package Manager? Visit swift.org/package-manager/.

Access ArcGIS location services

The toolkit examples app has been updated to make use of the ArcGIS basemaps defined with default basemap styles. These basemaps take advantage of geographically load-balanced ArcGIS location services and allow you to monitor usage with API keys or access tokens from user authentication. To use the toolkit examples app, you must implement API key authentication or user authentication. For more information, see How to use an API key or How to implement user authentication.

SwiftLint

Both the toolkit and examples app support SwiftLint. You can install SwiftLint from here. It is not necessary to have it installed in order to build, but you will get a warning without it. The specific rules the linter uses can be found in the swiftlint.yml files in the Toolkit and Examples directories.

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.