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:

/abcd/efgh/Frameworks.

(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

Author:

YourName

Org Name:

SAP

Org Identifier:

com.sap

Destination:

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 com.sap.hcpsdk.sample app ID.

Click on OK button.

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

 

Tab3: oData Services

It should list out com.sap.hcpsdk.sample app configuration automatically under Connections.

Select com.sap.hcpsdk.sample 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.

To report this post you need to login first.

4 Comments

You must be Logged on to comment or reply to a post.

  1. 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?

    Thanks

    Sandip

     

     

    (0) 
  2. 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…

    Steffen

    (0) 
  3. Manjunath Gudisi Post author

    Hi Steffen

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

    Software

    Version

    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

    activesupport

    4.2.6 and above

    $ gem list

    $ sudo gem install activesupport

    ruby

    0.1.0 and above

    $ gem list

    $ sudo gem install ruby

    xcodeproj

    1.4.2 and above

    $ gem list

    $ sudo gem install xcodeproj

     

    Thanks, MG

    (0) 
    1. 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,

      Emanuel

       

      (0) 

Leave a Reply