Skip to Content
Author's profile photo Sue Berry

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 MDKClient_SDK.zip 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 MDKClient_SDK.zip 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.

Assigned Tags

      24 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Fabian Runge
      Fabian Runge

      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".

      Author's profile photo Sue Berry
      Sue Berry
      Blog Post Author

      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.   https://launchpad.support.sap.com/#/softwarecenter/template/products/%20_APP=00200682500000001943&_EVENT=DISPHIER&HEADER=Y&FUNCTIONBAR=N&EVENT=TREE&NE=NAVIGATE&ENR=73555000100200007345&V=MAINT&TA=ACTUAL&PAGE=SEARCH/MDK%20CLIENT%202.0

      Author's profile photo Christian Bartels
      Christian Bartels

      I also don't find it on SAP Marketplace. Was it released for the public yet? Thanks

      Author's profile photo Sue Berry
      Sue Berry
      Blog Post Author

      It is public already.  I have emailed you directly to try to help you resolve the issue.

      Sue

      Author's profile photo Fabian Runge
      Fabian Runge

      It doesn't work unfortunately. So far I could always download everything else on the Launchpad:

       

      Author's profile photo Sue Berry
      Sue Berry
      Blog Post Author

      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.

      Author's profile photo Sue Berry
      Sue Berry
      Blog Post Author

      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.

       

      Author's profile photo Lawrence Goeseels
      Lawrence Goeseels

      Hi Sue

       

      For me it's also not possible to download "Mobile development kit client 2.0".

      This is what I get:

      Author's profile photo Giel Janssen Lok
      Giel Janssen Lok

      Hi Sue, I have the  same problem. I cant find Mobile development kit , MDK client or use the links that you posted. (no data available error)

      Author's profile photo Dominique Pierre
      Dominique Pierre

      Hi Sue,

      I can't find the MDK on the marketplace but I just downloaded it from here: https://www.sap.com/developer/trials-downloads/additional-downloads/mobile-development-kit-client-2-0-14516.html

      Cheers,

      Pierre

      Author's profile photo Dominique Pierre
      Dominique Pierre

      It's an older version...

      Author's profile photo Jitendra Kansal
      Jitendra Kansal

      Fabian Runge  Christian Bartels Lawrence Goeseels Giel Janssen Lok Dominique Pierre

      Hi, in case if still haven't yet download MDK client for marketplace, you can download it from this newly software content download page https://www.sap.com/developer/trials-downloads/additional-downloads/mobile-development-kit-client-2-1-14516.html

      Hope this helps.

      Regards

      JK

      Author's profile photo Frederico Rocha
      Frederico Rocha

      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,

      Frederico

      Author's profile photo Jitendra Kansal
      Jitendra Kansal

      Frederico Rocha

      Sorry about that,

      i am checking on this with colleagues, will update you once i hear back.

       

       

      Author's profile photo Bill Froelich
      Bill Froelich

      We have duplicated the download problem and are looking into it.

       

      Author's profile photo Frederico Rocha
      Frederico Rocha

      Any news?

      Author's profile photo Bill Froelich
      Bill Froelich

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

      --Bill

      Author's profile photo Tenzin Wangmo
      Tenzin Wangmo

      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!

      Author's profile photo Sue Berry
      Sue Berry
      Blog Post Author

      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.

      Thanks

      Sue

       

      Author's profile photo Ridhima Goel
      Ridhima Goel

      Hi Tenzin

      Could you please suggest the procedure you have followed and which emulator you were working on to connect with MDK?

      Thanks

      Ridhima

      Author's profile photo Tenzin Wangmo
      Tenzin Wangmo

       

      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. 

      Author's profile photo Ridhima Goel
      Ridhima Goel

      Hi Tenzin,

      Did you get this done? I am also facing the same challenge.

      Appreciate for a quick help.

      Author's profile photo Tenzin Wangmo
      Tenzin Wangmo

      I followed the youtube tutorial series and it worked.

      https://www.youtube.com/playlist?list=PLkzo92owKnVzN85sWfSdmwSOqlOAFE9DO

      Author's profile photo Vipul Vora
      Vipul Vora

      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?