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)
2) Extract the contents of this file on your Mac
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.
3) Download ESRI SDK to your local machine. Navigate to https://developers.arcgis.com/ios/objective-c/guide/install.htm 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 https://developers.arcgis.com/ios/objective-c/guide/install.htm
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
- Add build flags (I only copied part of the text from the Arc GIS website -> -framework ArcGIS -| c++
- Add dependencies(screenshot is only for adding the Assets library framework, likewise add all framework as mentioned on the ESRI website)
- 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
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
I will complete the rest of the process in the next blog. The next step is to download the EAM SDK from SAP.
Cheers,
Abhinav
- SAP Managed Tags:
1 Comment
