Skip to Content

Create an MDK Online App

test
0 %
Create an MDK Online App
Details

Create an MDK Online App

May 10, 2021
Created by
May 23, 2019
Use the mobile development kit editor to create a mobile app for online use case.

You will learn

  • How to create an MDK Online app using an existing template in SAP Business Application Studio
  • How to deploy an MDK app to Mobile Services and run it in a client
QR code

Prerequisites

You may clone an existing project from GitHub repository and start directly with step 4 in this tutorial.


Step 1: Get familiar with use case

With Mobile Development Kit, you can also create applications that are online or always connected and make calls to the backend servers for each action you take in the application.

Log on to answer question
Step 2: Create a new MDK project in SAP Business Application Studio

This step includes creating the mobile development kit project in the editor.

  1. Launch the Dev space in SAP Business Application Studio.

  2. Click Start from template on Welcome page.

    MDK

    If you do not see Welcome page, you can access it via Help menu.

  3. Select MDK Project and click Start.

    MDK
  4. In Type step, select or provide the below information and click Next:

    Field Value
    MDK template type Select Base from the dropdown
    Your project name MDKOnlineApp
    Your application name <default name is same as project name, you can provide any name of your choice>
    MDK

    The Base template creates the offline or online actions, rules, messages and an empty page (Main.page). After using this template, you can focus on creating your pages, other actions, and rules needed for your application. More details on MDK template is available in help documentation.

    If you see Cloud foundry token expired, continue without mobile services connection? message, then set up the Cloud Foundry environment again by navigating to View menu > Find Command> CF: Login to Cloud foundry to initiate a valid session and click Start Over.

  5. In Service Name step, provide or select the below information and click Next:

    Field Value
    Service File Name <Provide any name of your choice>
    OData Source Select Mobile Services from the dropdown
    Mobile Services Landscape Select standard from the dropdown
    Application Id Select com.sap.mdk.demo from the dropdown
    Destination Select SampleServiceV2 from the dropdown
    Enter a path to the OData service Leave it as it is
    Language URL Leave it with the default value
    Enable Offline Choose No
    MDK

    Regardless of whether you are creating an online or offline application, this step is needed for the app to connect to an OData service. When building an Mobile Development Kit application, it assumes the OData service created and the destination that points to this service is set up in Mobile Services.

  6. After clicking Next, the wizard will generate your MDK Application based on your selections. You should now see the MDKOnlineApp project in the project explorer.

Log on to answer question
Step 3: Get familiar with generated project structure

This is how the project structure looks like within the workspace.

MDK

These are the metadata definitions available in the editor and the format in which these metadata definitions are stored in the editor. Just to brief on some of these:

  • InitializeOnline.action: This action initializes the application data service .

  • InitializeOnline Success & Failure Message action: Here are some messages showing up in the app on a successful or failure of application data service initialization.

  • Main.page: This is the first page of your MDK application that is shown. For this application we will use this as a launching page to get to application functionality. We will add the logout action to this page.

  • OnWillUpdate.js: MDK applications automatically download updates and apply them to the client without the end-user needing to take any action. The OnWillUpdate rule empowers the user to run business logic before the new definitions are applied. This allows the application designer to include logic to prompt the user to accept or defer applying the new definitions based on their current activity. For example, if the end-user is currently adding new customer details or in the middle of a transaction, they will be able to defer the update. The application will prompt again the next time it checks for updates.

  • Web: In this folder, you can provide web specific app resource files and configurations.

  • Application.app: this is the main configuration file for your application from within SAP Business Application Studio. Here you set your start page (here in this tutorial, it is main.page), action settings for different stages of the application session lifecycle, push notifications, and more.

You can find more details about metadata definitions.

Log on to answer question
Step 4: Deploy the application

So far, you have learned how to build an MDK application in the SAP Business Application Studio editor. Now, you will deploy this application definition to Mobile Services.

  1. Right-click Application.app and select MDK: Deploy.

    MDK
  2. Select deploy target as Mobile Services.

    MDK

    You should see Deploy to Mobile Services successfully! message.

    MDK
Log on to answer question
Step 5: Display the QR code for app onboarding

SAP Business Application Studio has a feature to generate QR code for app onboarding.

Click the Application.app to open it in MDK Application Editor and click Application QR Code icon to display the QR code.

MDKMDK

Leave the Onboarding dialog box open for step 6.

Log on to answer question
Step 6: Run the app in MDK client

Make sure you are choosing the right device platform tab above. Once you have scanned and onboarded using the onboarding URL, it will be remembered. When you Log out and onboard again, you will be asked either to continue to use current application or to scan new QR code.

Follow these steps to on-board the MDK client.

Once you accept app update, you will see Main page being displayed and application data service is initialized.

MDK

Follow these steps to on-board the MDK client.

Once you accept app update, you will see Main page being displayed and application data service is initialized.

MDK

Once you have scanned and onboarded using the onboarding URL, it will be remembered. When you Log out and onboard again, you will be asked either to continue to use current application or to scan new QR code.

In which file you enable or disable the offline store?
×

Congratulations, you have successfully created an MDK online app and you can continue with the remaining tutorials in this mission.


Next Steps

Back to top