Skip to Content
Author's profile photo Abhinav Gupta

Integrate GIS libraries in SAP Work Mgr. – iOS – part 1

Hi everyone,

This is my first SCN blog post :-). I just wanted to write a detailed step-by-step integration with screenshots on how to include ESRI/GIS libraries with SAP Work Mgr. on the iOS client. The entrie process will be detailed out in 2 blogs.

I am not an iOS/client side developer and had to learn this process with a lot of trial and error and with support from SCN members. I hope this document helps anyone who is trying to accomplish this. This document is written from a “non-iOS” developer point of view, so there might be too much detail for iOS developers.

P.S – this post is open to suggestions/modifications, there might be other(and even better) ways to do this. I have followed this process at least 6-7 times on different Mac books and it has worked for me.

P.P.S – Please review the “SAP EAM and service mobile app SDK 1.0 Installation Guide” in the “Installation & Upgrade guides” section of the SAP Support Portal to get an overview of all the components that are needed to enable GIS in SAP Work Mgr. This document is a step-by-step guide to include all libraries, once you understand what pieces that are needed.

SMP SDK set up

1)  Install SMP SDK for Mac(I used SMP SDK SP06) AND Windows(yes, you need the SDK for Windows also as the file you need SMPAgentryClientFramework-iOS-70.6.0.tgz is not available in the Mac version of the SMP SDK – strange!). Technically, installing SMP SDK on your Mac is optional if you are able to transfer the SMPAgentryClientFramework-iOS-70.6.0.tgz file from the Windows version of the SMP SDK to your Mac under the $Home\SAP\MobileSDK3 folder– see below screenshot(SMP SDK installation creates this directory for you, if you have chosen not to install the SDK you can create this folder manually)

windows file.jpg

2) Extract the contents of this file on your Mac

extract on Mac.jpg

XCode set up

1) There is a sample X Code project already included in the SDK. This is part of the SMPAgentryClientFramework-iOS-70.6.0.tgz that was extracted in step above.Path = SMPAgentryClientFramework – >iOS->Samples->SMPAgentryFrameworkSetup->SMPAgentrySetup.xcodeproj. Double click on this file, it should open in X Code.

2) Build and run this project in simulator just to make sure that there are no errors.

initial build success.jpg

3) Download ESRI SDK to your local machine. Navigate to to install the latest version of the libraries (version number used in this document is 10.2.4). Assumption is that your organization/client have the required licenses from ESRI, covering that is beyond the scope of this document

4) Set up your X Code project to include the ESRI libraries (all instructions can be found at

Below screenshots are from my X Code project corresponding to steps 1-4 in the ESRI instructions (in above screenshot). Again, the instructions on the ESRI website are quite detailed, please follow them carefully.

– Add ArcGIS to the framework search paths

framework search path.jpg

Add build flags (I only copied part of the text from the Arc GIS website -> -framework ArcGIS -| c++

other linker flag.jpg

Add dependencies(screenshot is only for adding the Assets library framework, likewise add all framework as mentioned on the ESRI website)

add dependencies.jpg

add dependencies2.jpg.png

Add Arc GIS bundle to project. Navigate to the path where Arc GIS SDK is installed. Typically this is ${HOME}/Library/SDKs/ArcGIS/iOS/ArcGIS.framework/Versions/Current/Resources

add dependencies.jpg

add dependencies2.jpg.png

5) Build your project to check if there are any errors, you should see the app logon screen. I did not have to import the ArcGIS.h file to get the build to succeed

build with arc gis.jpg

I will complete the rest of the process in the next blog. The next step is to download the EAM SDK from SAP.



Assigned Tags

      1 Comment
      You must be Logged on to comment or reply to a post.
      Author's profile photo Abhinav Gupta
      Abhinav Gupta
      Blog Post Author

      Integrate GIS libraries in SAP Work Mgr. - iOS - Part 2

      Link to the second part of this blog.