Skip to content

Setting Up Mobile Services for Mobile Development Kit

Setting Up Landscape

Set up your landscape to begin using Mobile Development Kit.

Begin by setting up the following:

Set up Description Link
SAP Business Technology Platform Cockpit Set up SAP Business Technology Platform cockpit to build, deploy, and manage your applications. Getting a Global Account
SAP Mobile Services Set up SAP BTP cockpit to administer your applications. Getting Started with SAP Mobile Services
Mobile Development Kit Set up Mobile Development Kit SDK for metadata-based rendering of your applications. Building your MDK Client

Creating Apps on SAP Mobile Services

As an administrator, you can create Mobile Development Kit applications using the SAP BTP cockpit, in both Neo and Cloud Foundry environment.

This interface enables you to manage your apps.

You can view information about the APIs, user registrations, and usage analytics of your Mobile Development Kit app type. You can also perform operations such as delete, export, and publish on your app though this interface.

  1. On the Home screen of the SAP BTP cockpit, select Create new app.

  2. Depending on the environment perform the following step:

    • Cloud Foundry: In the New Application window, Fill in the details, such as ID, name, description, and vendor. For more information about these fields, see Defining Applications. Choose Next. From the Assign Features for drop-down, select Mobile Development Kit Application. Choose Finish.
    • Neo: In the New Application window, select Mobile Development Kit from the Config Templates drop-down. Fill in the details, such as ID, name, description, and vendor. For more information about these fields, see Defining Applications.Choose Save.

    Once you have created your application, you see a list of features that are automatically assigned to the app.

  3. To view a list of all your apps, select Projects > Mobile Applications > Native/Hybrid.

  4. Click on the desired app to see the Application Details screen, which shows the ID, name, description, vendor, and a list of features assigned to the app.

  5. To add features to your app, select the + button on the right side of your Assigned Features list, choose or search for a desired feature and click OK. Alternatively, you can select your desired feature from the Features screen and select Add to Application.

Setting Up App Security

After creating your application, you can define the initial app security configuration to allow for the Mobile Development Kit editor to set up the service connection.

Cloud Foundry Environment

  1. Select the required application.
  2. In the application details page navigate to Security tab.
  3. In the Application Settings section, choose OAuth as the value for Security Configuration.

Neo Environment

  1. Select the required application.
  2. In the Assigned Features section choose Security.
  3. In the Application Settings section, choose OAuth as the value for Security Configuration.

Setting Up SAP Web IDE Full-Stack to Work with Mobile Development Kit

Set up SAP Web IDE for Full-Stack Development to work with Mobile Development Kit by subscribing to it in the cloud, creating destinations, configuring Git, and connecting remote systems.

Set up Description Procedure
SAP Web IDE for Full-Stack Development Enable SAP Web IDE for Full-Stack Development in the cloud. Opening SAP Web IDE
Destination for mobile services Create destinations for mobile services on the SAP Business Technology Platform cockpit, to connect to the back-end system and to upload your app metadata.
You can create your destinations in either Neo or Cloud Foundry platform, based on the environment you use to access the SAP Business Technology Platform cockpit.		 Creating Destination for mobile services in Neo Environment

Creating Destination for mobile services in Cloud Foundry Environment
Git Configure the corporate Git connectivity service to manage the metadata sources. Connecting to your Corporate Git System

Creating Destination for Mobile Services in Cloud Foundry Environment

If you are accessing the SAP Business Technology Platform cockpit in the Cloud Foundry environment, you can create a destination for mobile services and connect to the back-end system from the Mobile Development Kit editor.

  1. Go to the SAP Business Technology Platform cockpit from SAP Web IDE Full-Stack by selecting Tools > SAP Business Technology Platform Cockpit.
  2. In the SAP Business Technology Platform cockpit, select Connectivity > Destinations > New Destination to create a new destination for mobile services.

  3. In the Destination Configuration wizard, enter the following:

    Field Value
    Destination Name Provide a name for the destination.
    Type HTTP
    Description Provide a description for your destination. This is optional.
    URL Provide your mobile service URL that the app uses to access data on the back-end system.
    In the URL, include the organization and space information that you provided while logging in to your Cloud Foundry environment.
    The format for the URL is https://<URL>/org/<organization name>/space/<space name>/.
    You can obtain this URL by selecting Important Links in the bootom left corner. In the important links page, SAP Business Technology Platform SDK Tools section, the Copy Admin API URL is the required URL.
    Proxy Type Internet
    Authentication BasicAuthentication
    In the Cloud Foundry environment, only basic authentication is supported in runtime.

    If you select the AppToAppSSO authentication type, it will be downgraded to BasicAuthentication in runtime, and prompt you to provide your username and password.
    HandleRedirects false
    SkipSSOTokenGenerationWhenNoUser true
    WebIDEUsage mobile
    WebIDEEnabled true

    Note

    Not all the values appear in the drop-down menu. For any values not appearing, type in the name of the property.

  4. Check the Use default JDK truststore option.

  5. Click Save.

Creating Destination for Mobile Services in Neo Environment

If you are accessing the SAP Business Technology Platform cockpit in the Neo environment, you can create a destination for mobile services and connect to the back-end system from the Mobile Development Kit editor.

  1. Go to the SAP Business Technology Platform cockpit from SAP Web IDE Full-Stack by selecting Tools > SAP Business Technology Platform Cockpit.
  2. In the SAP Business Technology Platform cockpit, select Connectivity > Destinations > New Destination to create a new destination for mobile services.

  3. In the Destination Configuration wizard, enter the following:

    Field Value
    Destination Name Provide a name for the destination.
    Type HTTP
    Description Provide a description for your destination. This is optional.
    URL Provide the URL that the app uses to access data on the back-end system or service.
    The format for the URL is https://<URL>/org/<organization name>/space/<space name>/.
    You can obtain this URL by selecting Important Links in the bootom left corner. In the important links page, SAP Business Technology Platform SDK Tools section, the Copy Admin API URL is the required URL.
    Proxy Type Internet
    Authentication AppToAppSSO
    HandleRedirects false
    SkipSSOTokenGenerationWhenNoUser true
    WebIDEUsage mobile
    WebIDEEnabled true

    Note

    Not all the values appear in the drop-down menu. For any values not appearing, type in the name of the property.

  4. Check the Use default JDK truststore option.

  5. Click Save.

Managing Your App Life Cycle with App Update

While creating a new app using the SAP BTP cockpit, if you specify Mobile Development Kit as the app type, then the App Update feature is assigned to the app by default.

Use App Update to keep your apps and app configurations up-to-date, maintain multiple versions, and manage the apps' life cycles.

  1. Select the App Update > Configuration tab to display the configuration page, where you can view the version details of your app:
    • New - a version that has been uploaded to the cockpit, but not yet deployed to users.
    • Current - the version that is currently being used by users. The new versions of the app appear on the configuration page if it was deployed directly from SAP Web IDE Full-Stack. For details, see Deploying App Metadata from Editor to mobile services.

  2. If deploying the app metadata directly from SAP Web IDE Full-Stack fails, select the Upload icon in the top-right corner. Import the .zip file containing the app metadata for the new version of your app from your local system, and then click Upload. The status of a newly uploaded app or a newer version of an app appears as New Version.

  3. To deploy the new app version to the Current state, select Actions > Deploy.

  4. (Optional) To delete a new version of the app, select the Delete icon. You cannot delete an app in the Current state, you must instead deploy a new version to the Current state.

Configuring Offline Settings (Optional)

This is an optional configuration. Configure the offline settings only if your Mobile Development Kit app is intended to be used offline. The configuration settings are made in application configuration .ini file. For more information, see Defining Offline Settings For Applications

Tutorial

Set Up Initial Configuration for a Mobile Development Kit App

Last update: December 16, 2020