arcgis-maps-sdk-swift-toolkit

200.4.0

Mapping components that will simplify your Swift app development with the ArcGIS Maps SDK for Swift.
Esri/arcgis-maps-sdk-swift-toolkit

What's New

v200.4.0 Release

2024-04-12T16:45:46Z

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.

Feature Form View

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

ArcGIS Maps SDK for Swift Toolkit

doc SPM

The ArcGIS Maps SDK for Swift Toolkit contains components that will simplify your Swift app development. It is built off of the new ArcGIS Maps SDK for Swift.

To use Toolkit in your project:

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.
  • 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.
  • 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.
  • 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.

Requirements

  • ArcGIS Maps SDK for Swift
  • Xcode 15.0 (or newer)

The ArcGIS Maps SDK for Swift Toolkit has a Target SDK version of 15.0, meaning that it can run on devices with iOS 15.0 or newer.

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.

Note: The Toolkit Swift Package adds the ArcGIS Maps SDK for Swift Package as a dependency so there's no need to add both separately. If you already have the ArcGIS Maps SDK for Swift Package, delete it and just add the Toolkit Swift Package.

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

Configure API Key

Some of the toolkit components and examples utilize a set of ready-to-use ArcGIS Platform services, including basemaps, and therefore require an API Key to be set in ExamplesApp.swift. Please see the setup guide for more information.

Additional Resources

Issues

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

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2022 - 2024 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE file.

Description

  • Swift Tools 5.9.0
View More Packages from this Author

Dependencies

Last updated: Wed Apr 24 2024 11:52:38 GMT-0900 (Hawaii-Aleutian Daylight Time)