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.
- On the
Home
screen of the SAP BTP cockpit, selectCreate new app
. -
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. ChooseNext
. From theAssign Features for
drop-down, selectMobile Development Kit Application
. ChooseFinish
. - Neo: In the
New Application
window, selectMobile Development Kit
from theConfig Templates
drop-down. Fill in the details, such as ID, name, description, and vendor. For more information about these fields, see Defining Applications.ChooseSave
.
Once you have created your application, you see a list of features that are automatically assigned to the app.
- Cloud Foundry: In the
-
To view a list of all your apps, select
Projects > Mobile Applications > Native/Hybrid
. -
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. -
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 clickOK
. Alternatively, you can select your desired feature from theFeatures
screen and selectAdd 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¶
- Select the required application.
- In the application details page navigate to
Security
tab. - In the
Application Settings
section, chooseOAuth
as the value forSecurity Configuration
.
Neo Environment¶
- Select the required application.
- In the
Assigned Features
section chooseSecurity
. - In the
Application Settings
section, chooseOAuth
as the value forSecurity 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.
- Go to the SAP Business Technology Platform cockpit from SAP Web IDE Full-Stack by selecting
Tools > SAP Business Technology Platform Cockpit
. - In the SAP Business Technology Platform cockpit, select
Connectivity > Destinations > New Destination
to create a new destination for mobile services. -
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 ishttps://<URL>/org/<organization name>/space/<space name>/
.
You can obtain this URL by selectingImportant Links
in the bootom left corner. In the important links page,SAP Business Technology Platform SDK Tools
section, theCopy 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 theAppToAppSSO
authentication type, it will be downgraded toBasicAuthentication
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.
-
Check the
Use default JDK truststore
option. - 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.
- Go to the SAP Business Technology Platform cockpit from SAP Web IDE Full-Stack by selecting
Tools > SAP Business Technology Platform Cockpit
. - In the SAP Business Technology Platform cockpit, select
Connectivity > Destinations > New Destination
to create a new destination for mobile services. -
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 ishttps://<URL>/org/<organization name>/space/<space name>/
.
You can obtain this URL by selectingImportant Links
in the bootom left corner. In the important links page,SAP Business Technology Platform SDK Tools
section, theCopy 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.
-
Check the
Use default JDK truststore
option. - 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.
- 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.
-
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 clickUpload
. The status of a newly uploaded app or a newer version of an app appears asNew Version
. -
To deploy the new app version to the
Current
state, selectActions > Deploy
. - (Optional) To delete a new version of the app, select the
Delete
icon. You cannot delete an app in theCurrent
state, you must instead deploy a new version to theCurrent
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