Skip to Content

Mobile Development Kit SDK Client Install and Setup (2.0SP1 PL01)

The latest release of SAP Cloud Platform Mobile Services, mobile development kit is available.  The Editor will update automatically for you in SAP Web IDE Full Stack.  However, you will need to download the new mobile development kit SDK client, and configure the client to connect to your mobile services MDK application.

The mobile development kit (MDK) client has simplified the install and setup process.  For more information on that and other new features, check out my What’s New in MDK 2.0SP1 blog.


I’ve created this quick blog so that people like me don’t need to read the README file in the MDK SDK download. We are also working on an updated SAP HANA Academy MDK Client Setup video which will be available soon. I’ll update this blog and provide a link once available.


You can download the updated client SDK from the SAP Marketplace or from SAP Software Content Downloads and extract the file. Once extracted, you will see the following folder structure. In the screenshot below, I have extracted into the same folder.



MDK Dependencies Installer


The MDK Dependencies Installer is exactly what it sounds like.  It checks the status of the MDK dependencies and will install or upgrade the dependencies for you.


Open the MDK Dependencies Installer application.


Note: You may get the following error.


If you get the above error, go to System Preferences -> Security & Privacy and click Open Anyway.


Now the MDK Dependencies Installer should open. Select the components you want the application to install and select Install Selected Components.





Install MDK Client


Once the dependencies are installed, you can install the MDK Client. Unzip if it is not already extracted.  From a terminal window (setting your proxy if needed before running), navigate to the [path] -> MDKClient_SDK folder and execute ./install.command



Create your .mdkproject folder

While the install.command command is running, you can make a copy of the template.mdkproject folder and rename it [whateveryouwant].mdkproject.



You can put your new folder anywhere you want.  I have named my .mdkproject folder demoapp.mdkproject and put it outside of the MDK Client folder structure. I will refer this name for the rest of the blog.



Go into the demoapp.mdkproject folder.  You will need to update the BrandedSettings.json and MDKProject.json files as needed for your client.


  • Go into the demoapp.mdkproject folder



Open the MDKProject.json file and update it as needed. I have updated the file as seen below in the screenshot.


Now open the BrandedSettings.json file and update it with information from your MDK Mobile Services application.


To find the correct URLs for your client, you should go to Mobile Services and find your MDK application that you want to link to this client.  Click on Security from the MDK app main page, then click on the OAuth link.


  • AppID -> ID from App info page
  • Client ID -> Client ID from OAUTH Client page
  • SapCloudPlatformEndpoint -> Server URL from App API page
  • AuthorizationEndpointUrl -> Authorization Endpoint from OAuth Client page
  • RedirectUrl -> Redirect URL from OAuth Client page
  • TokenUrl -> Token Endpoint from OAuth Client page



Create Client

Now that the install.command process has completed,  you should now have a create-client.command in the MDKClient_SDK folder.

  • Run create-client.command


  • Now you will need to provide the path to demoapp.mdkproject (or whatever you named it).

  • Now specify whether you are building a client for a device or simulator.


Once the create-client.command process completes, you will find your app created under the MDKClient_SDK folder.  This name of this folder is based on the <App Name> provided in the MDKProject.json file. In the screenshot with the MDKProject.json, I named the app Mobile Dev Kit.


In a terminal window, navigate into the Mobile Dev Kit folder and run tns run ios — emulator.

At the end of this command, the Mac should open a simulator with a welcome screen for the MDK application.

  • Click on Start.
  • Login to SAP Cloud Platform with your mobile services login details.
  • Follow the remaining prompts.
  • Deploy an application from the MDK editor in SAP Web IDE to view it in your MDK Client.
You must be Logged on to comment or reply to a post.
  • Hi Sue!

    I can't find the download you're mentioning. On the SAP Store the newest version I see is "Mobile development kit client 2.0 PL01" and on the market place I can't find anything with the name "MDK" or "mobile development".

    • SAP Store is undergoing a few updates and we have not yet been able to post it there.  You can find it on SAP Marketplace.  Latest patch version is 2.1.2.   Let me know if this link does not work for you.

  • /
    • Okay, I'll find out why you cannot see the links on service marketplace and when the download will show up on the SAP Store.

      • Okay, try to search for mobile development kit client 2.1.2 under downloads in service marketplace.

        When I did that, I saw the SEAMCLIENT201P_2-70003286.ZIP.

        If that doesn't work, please send me an email with your customerID and I will figure out what is going on.


  • Hi Sue,

    I can't find the MDK on the marketplace but I just downloaded it from here:



  • Hi Jitendra,


    In the marketplace I don't find the MDK client to download, so I tried your link. I  downloaded through your link, however, when I try to open the zip file I got an error message saying that isn't possible to open the zip file and the same when I try to unzip it.


    Kind regards,


  • ​The download link is now fixed! The downloaded file name should be  I am hopeful that future updates will go smoother.  Thank you for you patience.


  • I followed all the procedure but not able to run on the emulator.. When I open the app, it just shows a blank screen in the emulator.. where can I see the error logs to resolve it. Thank You!

    • Hi Tenzin

      The app in the simulator should open on its own with a start button.  Will you post a copy of the terminal window for the create-client.command and the tns run ios  - - emaulator command? Also a screen shot of the simulator.





    Here I am attaching the files and also I tried running the example project too. I am able to open the app but it is just blank, nothing is visible blank white page. Thank You!

    Although I am able to run the app with the same configuration on the mobile service. 

  • Hi Sue,

    Is there any way to run the app directly on the simulator or the device through Web IDE?

    If yes, could you please provide me the details?