Toolkit

ArcGIS Maps SDK for Swift offers an open source toolkit that contains components to help simplify your Swift app development. 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.

Enhancements in 200.2

• Building for Mac Catalyst is now supported
• Required Xcode versions are 14.1 or 15
• Documentation is available from the Toolkit Reference in DocC format

Issues resolved

• 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

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.
• FloatingPanel - 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.
• OverviewMap - Displays the visible extent of a geo view in a small "inset" map.
• Popup - Displays details, media, and attachments of features and graphics.
• Scalebar - Displays current scale reference.
• Search - Displays a search experience for geo views.
• UtilityNetworkTrace - Runs traces on a web map published with a utility network and trace configurations.

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 Packages...
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 ESRI 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 set an API key or authenticate an ArcGIS user. For more information, see Get an access token.

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.