This repository contains Swift sample code demonstrating the capabilities of ArcGIS Runtime SDK for iOS and how to use them in your own app. The project can be opened in Xcode and run on a simulator or a device. Or you can download the app from the App Store on your iOS device.
Try ArcGIS Maps SDK for Swift version 200
ArcGIS Runtime SDK for iOS version 100.15 is a long-term support release focused exclusively on bug fixes and minor updates.
ArcGIS Maps SDK for Swift version 200 builds on the proven architecture of 100.15, and provides a new API designed exclusively for developing iOS apps using Swift - Apple's modern, powerful, and intuitive programming language.
The main branch of this repository contains samples configured for the latest available version of ArcGIS Runtime SDK for iOS. For samples configured for older versions of the SDK, look under the Releases tab for a specific version.
- Maps - Open, create, interact with and save maps
- Layers - Display vector and raster data in maps and scenes
- Features - Work with feature layers and geodatabases
- Display Information - Show graphics, popups, callouts, and sketches
- Search - Find addresses, places, and points of interest
- Edit Data - Add, delete, and edit features and attachments
- Geometry - Create geometries and perform geometric operations
- Route & Directions - Calculate routes between locations and around barriers
- Analysis - Perform spatial analysis via geoprocessing tasks and services
- Cloud & Portal - Search for webmaps and list portal group users
- Scenes - Visualize 3D environments and symbols
- Utility Network - Work with utility networks, performing traces and exploring network elements
- Augmented Reality - View data overlaid on the real world through your device's camera
- ArcGIS Runtime SDK for iOS 100.15.0 (or newer)
- ArcGIS Runtime Toolkit for iOS 100.15.0 (or newer)
- Xcode 13.0 (or newer)
The ArcGIS Runtime SDK Samples app has a Target SDK version of 14.0, meaning that it can run on devices with iOS 14.0 or newer.
- Fork and then clone the repository
- Open the
arcgis-ios-sdk-samples.xcodeprojproject fileThe project has been configured to use the
arcgis-runtime-toolkit-iospackage, which provides theArcGISToolkitframework as well as theArcGISframework. - Run the
arcgis-ios-sdk-samplesapp target
To add the Swift packages to your own projects, consult the documentation for the ArcGIS Runtime iOS Toolkit and ArcGIS Runtime iOS SDK.
- Fork and then clone the repository
- Install the ArcGIS Runtime SDK for iOS by running the
pod installcommand in the folder where you cloned this repository - Open the
arcgis-ios-sdk-samples.xcworkspaceworkspace file - Select the
arcgis-ios-sdk-samplesproject node, go to thePackage Dependenciestab, and delete thearcgis-runtime-toolkit-iospackageThis Swift package conflicts with CocoaPods and is only required when using the Swift Package Manager as described in the previous section.
- Run the
arcgis-ios-sdk-samplesapp target
- Fork and then clone the repository
- Install the ArcGIS Runtime SDK for iOS to a central location on your mac as described here
- Open the
arcgis-ios-sdk-samples.xcodeprojproject file. Select thearcgis-ios-sdk-samplesproject node, go to thePackage Dependenciestab, and delete thearcgis-runtime-toolkit-iospackageThis Swift package conflicts with manual installation and is only required when using the Swift Package Manager as described in the previous section.
- Download the
arcgis-runtime-toolkit-iosfrom here, and follow the instructions to add it as a local Swift packageThe manual installation method allows you to use a local installation ArcGIS Runtime SDK for iOS by making minor edits to the toolkit's Swift package manifest. Follow the instructions in
Package.swiftto uncomment the lines forlocalArcGISPackageand use it as the package dependency instead of the hosted version. - Run the
arcgis-ios-sdk-samplesapp target
Some sample data is too large to store in the repository, so it is automatically downloaded at build time. The first time the app is built, a build script downloads the necessary data to Portal Data. The script only downloads data files that do not already exist, so subsequent builds will take significantly less time.
To build this app locally, follow the steps to add an API key to a secrets file stored in the project's root directory, $(SRCROOT)/.secrets.
- Create a hidden secrets file in the project's root directory.
touch .secrets- Add your API Key to the secrets file aforementioned. Adding an API key allows you to access a set of ready-to-use services, including basemaps. Acquire the keys from your dashboard. Visit the developer's website to learn more about API keys.
echo ARCGIS_API_KEY=your-api-key >> .secretsReplace 'your-api-key' with your keys.
Please see Configure App Secrets for adding license key and other details.
- Want to start a new project? Setup your dev environment
- New to the API? Explore the documentation : Guide | API Reference
- Got a question? Ask the community on our forum
Find a bug or want to request a new feature? Please let us know by submitting an issue.
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
Copyright 2022 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.