OnBoarding Your Mobile Development Kit App Store A...

former_member204320 · ‎2018 Aug 02

I am happy to announce that there is a new Mobile Development Kit (MDK) client application on the Apple App Store. The app is called SAP Mobile Services Client and it is a generic client app that displays the mobile application you have built using the Mobile Development Kit editor and deployed to SAP Cloud Platform Mobile Services. The mobile development Kit (MDK) is a feature of SAP Cloud Platform Mobile Services. See the tutorial here: https://developers.sap.com/mission.mobile-dev-kit-get-started.html

Not familiar with Mobile Development Kit? Download the app and click “Try the Demo”. The Mobile Development Kit demo is a simple application, running offline, that shows you the type of application you can build using this tool. Then, review the Learning Journey which provides overview topics, blogs, videos, and tutorials to help you get started.

To view more than just the offline demo, you will need to make a connection to a specific SAP Cloud Platform Mobile Services MDK application. The SAP Mobile Services Client includes an onboarding feature that allows you to easily set up the generic app to connect to your mobile services MDK application.

This blog provides the details to onboard your Mobile Services App Store app.

Pre-requisites

You need to setup your own mobile services account to begin building and testing your own MDK applications.

This blog assumes you have already setup your SAP Cloud Platform mobile services account following the mobile development kit setup video on YouTube.com.

Install from Apple App Store

Go to the Apple App Store and search for SAP Mobile Development Kit or SAP Mobile Services Client. The SAP Mobile Services Client appears as this is official name for the mobile development kit client.

Download it to your device.

Create onboarding string to connect the client to your custom MDK app

The MDK App Store app needs to connect to a specific Mobile Services application. To do this, you will create a URL using your Mobile Services application details. The URL includes App ID, SAP Cloud Platform base URL, and OAuth Security URLs. You will then generate a QR code and scan it to onboard your app.

To create the URL string, go to your Mobile Development Kit application in SAP Cloud Platform Mobile Services.

Login to mobile services and click on Native/Hybrid under Mobile Applications in the left menu.

You should see the list of mobile services applications you have already created. Click on the mobile development kit application you want to link to the SAP Mobile Services Client on your device. This takes you in the Application Details page.

Now you will create a URL to generate a QR code and click on from the mobile device. I suggest you open a text file, copy the base URL there and add the IDs and URLs for your application.

sapmobilesvcs://?AppId={}&ClientId={}&SapCloudPlatformEndpoint={}&AuthorizationEndpointUrl={}&RedirectUrl={}&TokenUrl={}&ServiceTimeZoneAbbreviation=PST

From the mobile services application, copy the App ID and replace the {} with the ID you copied.

Now, click on the API tab. This is located above the Application Details section. Here you will copy the server URL (without the trailing “/”) and replace the {} for SAPCloudPlatformEndpoint

Note: Even though you see a QR code on this screen Mobile Development Kit applications cannot take advantage of it today.

Now go back to the Info tab to get the remaining URLs. Under the Info tab, click on Security under Assigned Features.

In the Security page, click on the entry under OAuth Clients

A popup screen appears with the OAuth Client details. Select the Client ID and copy it to your clipboard. If you are unable to select the Client ID in your browser to copy the Client ID, you will need to type it manually and triple check the ID. Paste (or type in) the Client ID in your url string replacing the {} after ClientId.

From the same screen, copy the Authorization Endpoint URL and replace the {} for AuthorizationEndpointUrl.

From the same screen, copy the Redirect URL and replace the {} for RedirectUrl.

From the same screen, copy the Token Endpoint Url and replace the {} for TokenURl.

Click Cancel on this screen. You are done copying URLs. You final URL should look similar to this. There should be no spaces in in the Url and it should be all on one line.

sapmobilesvcs://?AppId=com.sap.mdk.demo&ClientId=s66a5e27-e086-457d-a7a7-22e85078bb8&SapCloudPlatformEndpoint=https://hcpms-p123456trial.hanatrial.ondemand.com&AuthorizationEndpointUrl=https://oauthasservices-p123456trial.hanatrial.ondemand.com/oauth2/api/v1/authorize&RedirectUrl=https://oauthasservices-p123456trial.hanatrial.ondemand.com&TokenUrl=https://oauthasservices-p123456trial.hanatrial.ondemand.com/oauth2/api/v1/token&ServiceTimeZoneAbbreviation=PST

Now, you can use the URL to generate a QR code and use your device camera to scan the QR code. You can use any QR Code Generator. I searched for free QR code generator and used one of the top choices. Copy the URL and paste into the QR code generator.

Open your device camera and point it at the QR code. If you are using iOS 11.x, you should see a popup notification asking you to open the SAP Mobile Services Client (Mobile Svcs). Click on the Notification and go to the next numbered step. Skip the email instructions as those are only if the QR code doesn’t work for you.

Note: If for some reason creating a QR code does not work for you, simply paste the Url into an email and send it to an account that is accessible from your device.

Go to your device and open up your email. Click on the link. It will ask you for permission to open the SAP Mobile Services client. Click Open.

Note: The default mail client on iOS will have a clickable link it finds an app on the device named sapmobilesvcs. The app must already be install on your device and make sure there are no spaces in your URL and the url starts with sapmobilesvcs://

When clicking on the notification from the QR code or email, your device should automatically open the SAP Mobile Services Client. Click on Start .

Note: If you have already clicked on “Try the Demo”, you will need to click on User from the Landing Page and then Reset all. This will take you back to the app welcome screen with the start button.

When you click on Start, you should see the login screen. Login with your SAP Cloud Platform account information.

You should now see a new screen with Authorize. Click Authorize.Accept the End User License Agreement and Enable Touch ID or enter a passcode for the application if Touch ID is not setup on your device.

Now the app should login to mobile services and download the app content. If you don’t have any app content yet, you may just see a blank screen with the title SAP Mobile Development Kit.

You are now ready to build applications in the mobile development kit editor, a plugin for SAP Web IDE. Once again, here is a link to the Mobile Development Kit Learning Journey to help you get started.

suhas_gavas · ‎2018 Nov 29

Hello,

I do this as suggested, but the URL is not recognized by the app and it opens this suggestion sights in google.

Also, the app is "Mobile Cards" is that correct ?

I am on Andriod.

Thanks,

Suhas

former_member204320 · ‎2018 Nov 29

The app is SAP Mobile Services client.

This is an app store app only right now. For Android, you need to be a part of the MDK 3.0 Early Adopter Care program. To apply to be a part of this program, review this blog.

https://blogs.sap.com/2018/10/30/expanding-mobile-development-kit-to-android/

Let me know if you have further questions.

Sue

former_member198837 · ‎2019 Jan 26

Nice Blog. Worked perfectly.

Can you let me know the use of Mobile Cards App

former_member204320 · ‎2019 Jan 29

Hi Karthik,

Thanks!

Mobile Card Kit provides microapp consumption. This product allows customers to Share data from virtually any back-end to mobile devices in a mobile-friendly format, regardless of whether the user is online or offline.

When online, dynamic updates provide the most up-to-date business data available. While offline, end users can still view content. The cards are very similar to what you may see in your Apple Wallet for personal apps such as movie tickets, airplane boarding passes, Broadway shows, etc. All the content you need such as what, where, when and the ability to gain access to the event is available on a little card in your Apple Wallet, this product takes that premise to the enterprise.

Take a piece of content and push a card to your personal Mobile Cards app

Predefined content makes it easy to publish content to the app

The card gives you a glimpse and then you can use deep navigation links to access the dedicated application when online

The card is automatically offline accessible once it is in your deck

matt.carrier can give you more details if needed. I hope this helps.

Sue

former_member594773 · ‎2019 Jan 30

What if I am using SAML incase of oauth for the security on the mobile service. do we still have to pass the client id & where can we get it. Thank YOu!

former_member204320 · ‎2019 Jan 30

Hi Tenzin,

thanks for reading the blog.

MDK only communicates via OAuth. So you will need to configure OAuth in Mobile Services for your MDK app.

I am not a security expert but I’ve been told that you would configure SAML with SAP Cloud Plaform and that it will then communicate with MDK via OAuth.

I believe one of our Mobile Services security colleagues is writing a security config whitepaper. I’ll check to see if we have details there yet.

Sue

former_member594773 · ‎2019 Jan 30

That will be great. Thanks for the reply. Also if I want to push multiple app, how do we do it. Right now I see that at a time, I can only view one app on the mobile service client app. Thank You!

former_member260148 · ‎2019 Feb 06

Hello Karthik,

Here is a great intro to SAP Mobile Cards that we recorded last week. This will walk you through all the elements of SAP Mobile Card creation in 1 hours time.

https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&partnerref=AEF&referrer=...

Then there are some additional tutorials to further your knowledge:

https://www.sap.com/developer/tutorial-navigator/mobile-interactive-tutorials/content2go.html

Ravindra_T · ‎2019 Feb 13

Did you got any information on integration of multiple apps. I was looking forward to some sort of launchpad where I can integrate multiple apps.

former_member188396 · ‎2019 Mar 11

Hi,

I am looking for the same answer as well! So, far I have not found anything pointing to how we can deploy/launch/access multiple apps?

Anyone know?

-Bhavik

former_member594773 · ‎2019 Mar 19

Sry haven't got any further information. Though found this blog now https://blogs.sap.com/2018/09/05/choosing-the-right-mobile-development-kit-client/ , see if its helpful. I am yet to try the other two options.

former_member188396 · ‎2019 Mar 26

Hi,

I have got the answer (Kinda.. but not tried practically yet)..

In Mobile Services in SCP, you can go to your MDK app and there you can build your own client using Cloud Build Service. This will create the client APK (for Android) or iOS client file. That can be installed on your device.

If you want to use the one available in App Store, you can tie it with ONLY one MDK app.

Thanks,

Bhavik

sahil_dudeja1 · ‎2019 Jul 23

Thanks for nicely Written Blog!

I am able to login in both Android & iOS clients using the steps given in blog.

Jitendra_Kansal · ‎2019 Oct 28

Hello All,

Here is the getting started tutorial series covering similar content with up-to-date information:

https://developers.sap.com/mission.mobile-dev-kit-get-started.html

former_member553541 · ‎2020 May 12

Thanks Bhavik, I had finally revisted this after a year and it worked!