Skip to Content
Author's profile photo Manjunath GUDISI

Part4 – HCPSDKforiOSAssistant

Welcome to Part4 – HCPSDKforiOSAssistant.

HCPSDKforiOSAssistant is an application Mac machine, which will be used to create the Xcode project along with proxy classes.

What is proxy class: Proxy class is a swift class and its blueprint of a Collection. For ex: if oDATA URL has 5 collections, then HCPSDKforiOSAssistant will create 5 swift classes for each collection. This proxy class has all the variables, attributes and methods. Developer do not need to spend time on defining the classes. This class will saves the developer time, so s/he can focus business logic.

Now, lets look at how to create the Xcode project using HCPSDKforiOSAssistant.

Open HCP SDK for iOS Assistant on mac machine, which must be inside the Applications folder.


Click on Open if you get this popup.


The HCP SDK for iOS Assistant is opened now.

We will test the settings once again.

Click on Settings icon.

HCP Ms Instances:

Select the your C/I/D instance from the list.

HCP SDK for iOS library path:

Make sure the path is pointing to the correct folder.

It should be:


(Until framework).

Click on Save button.

HCP Ms instances settings:

HCP iOS Library path:

Final it should like this:

We will now create the Xcode project.

Click on + button on right side.

Tab1: Project Properties

Enter the following parameters.

Product Name: SampleDemo



Org Name:


Org Identifier:


Destination folder where the project will be created.

Click on Next


Tab2: HCPms Configuration

Click on Use Existing.

Click on Select from HCPms.

You would see the list of app configurations that you would have configured in your HCPms account on HCPms admin portal.

Select app ID.

Click on OK button.

And then, click on Next button to go to Tab3.


Tab3: oData Services

It should list out app configuration automatically under Connections.

Select from the list.

Click on Next button.

Tab4: Optional Features

Lets have default selections as it is. Do not change anything.

Click on Finish.

The Assistant will create the Xcode project on Desktop with foldername as SampleDemo.

We have created the Xcode project successfully. We will run the app on simulator in the next blog.

Thank you.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Sandip Agarwalla
      Sandip Agarwalla

      Hello Manjunath @manjunath.gudisi

      Thanks for sharing this blog on the sdk, its useful to get started.

      I was trying to use the assistant to create a project, the application & connections are created fine. However the project generation fails with an error, here is a screenshot


      It says few pre-reqs are missing. I have installed JDK 8, gem activesupport 4.1.8 & gem xcodeproj 1.2.0 are installed. Am I missing some other pre-reqs?





      Author's profile photo Steffen Froehlich
      Steffen Froehlich

      Hi Manjunath @manjunath.gudisi

      when I want to open the created Xcode project I get the following error:

      It seems that the given metadata is invalid.FileError: Cannot open file for reading: /Users/.../sapcp-sdk-for-ios-apps/SampleDemo/SampleDemo.xcodeproj


      When I copy the project to another folder, I can open it successfully.

      After pressing 'Cancel' in HCP-SDK-Assistant, the whole folder 'SampleDemo' is deleted...



      Author's profile photo Manjunath GUDISI
      Manjunath GUDISI
      Blog Post Author

      Hi Steffen

      Please make sure you have the below mentioned softwares with correct versions.



      Command to run on Terminal to know version

      Command to run on Terminal to install the software

      Swift language

      3.0.2 and above

      $ xcrun swift -version

      It comes with Xcode


      4.2.6 and above

      $ gem list

      $ sudo gem install activesupport


      0.1.0 and above

      $ gem list

      $ sudo gem install ruby


      1.4.2 and above

      $ gem list

      $ sudo gem install xcodeproj


      Thanks, MG

      Author's profile photo Emanuel Affatati
      Emanuel Affatati

      Hi MG,

      In order to install activesupport, the command that has to be run is:

      sudo gem install activesupport -v 4.2.6

      Otherwise, the terminal keeps sending the error

      ERROR:  Error installing activesupport:

      activesupport requires Ruby version >= 2.2.2.

      Best Regards,