ArcGIS Runtime SDK for macOS: Introduction
ArcGIS Runtime SDK for macOS  100.2.1
Introduction

ArcGIS Runtime SDK for macOS provides an API for developers that allows you to add mapping and GIS functionality to your Mac applications. You can use the API in both Objective-C & Swift programming languages.

The API provides a MapView to display 2D geographic content, and a SceneView to display 3D content. You can find geopgraphic content from Esri's ArcGIS Online or use content from your own on-premises ArcGIS Enterprise portals. This content is delivered through REST web services. You can also use geopgraphic content that exists locally on the machine when the machine is offline.

The API is provided as a framework called ArcGIS. Classes and functions defined in this framework begin with the prefix AGS. This prefix acts as a namespace and prevents naming conflicts with classes defined in your application or other frameworks you use.

You need to use a minimum of macOS 10.13 SDK to build your applications. Also, the applications you build will require a Mac running a minimum of macOS Sierra (10.12).

Setting up your XCode project using CocoaPods

If you're already using CocoaPods, setting up your project to use ArcGIS is really easy.

  • Add pod 'ArcGIS-Runtime-SDK-macOS', '100.2.1' to your Podfile.
  • Run the command pod install on the Podfile using the Terminal application.
  • Open the project workspace (*.xcworkspace file) and add the #import <ArcGIS/ArcGIS.h> statement to any class files where you wish to use the API.

Setting up your XCode project manually

Download the SDK from https://developers.arcgis.com/macos/ . Run the installer, this will install the ArcGIS framework under ${HOME}/Library/SDKs/ArcGIS/macOS.

Set the project's Frameworks Search Paths setting to include ${HOME}/Library/SDKs/ArcGIS/macOS/Frameworks/Static , and the Other Linker Flags setting to include the following entries: -ObjC -framework ArcGIS -l c++

Finally, you must also add the ArcGIS.bundle file found under ${HOME}/Library/SDKs/ArcGIS/macOS/Frameworks/Static/ArcGIS.framework/Resources to your project. This bundle file contains the resources (images, localized strings, etc) used by the API.

Third party libraries

The ArcGIS library depends upon and already includes the following third party libraries -

The functions/classes in these libraries have been renamed/namespaced to avoid conflicts with other versions of the same libraries you may have in your project.