OpenUI for iOS Manual Xcode Project Setup

Prerequisites
The following items must be addressed prior to performing this procedure:
  • The SAP Mobile Platform SDK 3.0 contains the necessary resources for this procedure and must be installed. Note the installer is only available for Windows systems and the iOS framework must be manually copied to the Mac system after installation. This framework file can be found in the directory AgentryToolkit/OpenUISDK/iOS/SMPAgentryClientFramework-iOS-7.0.x.x.tgz
  • Xcode version 4.6 must be installed to the Mac system where the project is to be created.
Task

This procedure provides the steps necessary to create a project in Xcode that makes use of the Agentry Client framework for iOS. Creating this project is necessary to make use of the OpenUI SDK as well as to rebrand the Agentry Client for iOS. This project is created on a Mac system with the Xcode IDE version 4.6 installed.

Note: This procedure provides the manual steps to create this project. In most use cases this is not necessary and the project provided with the SMPAgentryClientFramework-iOS-7.0.x.x.tgz file can be used. This file is located in the directory ./Samples/SMPAgentryClientFrameworkSetup after the TGZ file has been expanded.
  1. Expand the framework archive SMPAgentryClientFramework-iOS-7.0.x.x.tgz into a directory on the system. In these instructions this base directory is represented by the value <Framework_BaseDir>.
  2. Within Xcode, create a new project, selecting iOS Application | Empty Application.
  3. In the Build Settings for the main target of the project, set the Framework Search Path to: <Framework_BaseDir>/SMPAgentryClientFramework/iOS/**
  4. In the Build Settings for the main target of the project, set the Header Search Path to: <Framework_BaseDir>/SMPAgentryClientFramework/iOS/SMPAgentryClient.framework/Headers/**
  5. In the Build Settings for the main target of the project, set the Other Linker Flags to: -ObjC -framework -SMPAgentryClient
  6. In the Build Phases section for the main target of the project, add the following resources to the Link With Dynamic Libraries section:
    • libc++.dylib
    • libiconv.dylib
    • libicucore.dylib
    • libsqlite3.dylib
    • libxml2.dylib
    • AudioToolbox.framework
    • AVFoundation.framework
    • CFNetwork.framework
    • CoreLocation.framework
    • CoreMedia.framework
    • CoreText.framework
    • CoreVideo.framework
    • QuartzCore.framework
    • Security.framework
    • CoreGraphics.framework
    • Foundation.framework
    • UIKit.framework
  7. In the Build Settings for the Xcode project set the Strip Linked Product option to No.
  8. Add the resource bundle to the project by selecting the menu item File | Add Files to Project and add the location: <Framework_BaseDir>/SMPAgentryClientFramework/iOS/SMPAgentryClient.framework/Resources/SMPAgentryClientResource.bundle
  9. Modify the main.m file within the project by replacing the app delegate class name and return statement:
    • New app delegate class name: @”SMPAgentryClientAppDelegate
    • New return statement: return UIApplicationMain(argc, argv, nil, @"SMPAgentryClientAppDelegate");
  10. After building and launching the project, the standard Agentry Client should run in either the simulator or on the client device.

With the completion of this procedure a project has been created in Xcode using the resources provided in the Agentry Client framework for iOS.

Next

You can begin developing custom controls using the OpenUI SDK and/or rebranding the Agentry Client for iOS devices by modifying the resource bundle.

Parent topic: Agentry OpenUI SDK for iOS Setup Overview