PUBLIC Document Version: 1.0 – 2018-11-14 Using SAP Cloud Platform Mobile Service, mobile development kit company. All rights reserved. All rights company. affiliate THE BEST RUN 2018 SAP SE or an SAP SE or an SAP SAP 2018 © Content 1 Developing Apps Using the Mobile Development Kit..................................4 2 Language Support........................................................... 7 3 Administrator Guide..........................................................8 3.1 Getting Started.............................................................. 8 3.2 Creating MDK Apps on SAP Cloud Platform Mobile Service for Development and Operations........9 3.3 Setting Up App Security....................................................... 10 3.4 Setting Up SAP Web IDE Full-Stack to Work with Mobile Development Kit.....................10 Creating Destination for Mobile Services in Neo Environment...........................11 Creating Destination for Mobile Services in Cloud Foundry Environment...................12 3.5 Managing Your App Life Cycle with App Update .......................................13 3.6 Building your MDK Client SDK................................................... 14 3.7 Branding Your Customized App.................................................. 16 4 Business Process Expert Guide................................................ 24 4.1 Setting Up the Editor in SAP Web IDE Full-Stack.......................................24 4.2 Importing App Metadata into the Editor............................................ 25 4.3 Cloning App Metadata from Git Repository..........................................25 4.4 Reusing App Components......................................................26 4.5 Deploying App Metadata from Editor to Mobile Services.................................27 4.6 Creating a New Project Using an Editor Template......................................28 Metadata Definitions.......................................................29 Metadata Validation.......................................................166 Migrating App Metadata....................................................167 5 Developer Guide...........................................................169 5.1 Customizing Advanced Rules...................................................169 5.2 Creating Extension Controls with Nativescript....................................... 173 5.3 Creating Custom Extension Controls in Swift........................................174 6 MDK Extension for Visual Studio Code..........................................176 6.1 Installing MDK Extension for Visual Studio Code......................................177 6.2 Editing Metadata with MDK Language for VS Code....................................177 6.3 Bundling MDK App with VS Code Build Task.........................................180 6.4 Debugging MDK App with VS Code Debugger....................................... 182 6.5 Creating MDK metadata object with VS Code editor...................................183 Creating a new MDK metadata object using the Command Palette......................183 Using SAP Cloud Platform Mobile Service, mobile development kit 2 PUBLIC Content Creating a new MDK metadata object using the context menu.........................184 Creating a CIM file using the context menu.......................................184 6.6 Restrictions and Troubleshooting................................................184 7 Mobile Backend Generator...................................................186 7.1 Generating an OData Service...................................................186 Customizing the Generated Service............................................188 Server OData API.........................................................191 7.2 Deploying the Generated Service................................................ 192 Deploying to SAP Cloud Platform – Neo.........................................193 Deploying to SAP Cloud Platform – Cloud Foundry................................. 194 7.3 Monitoring the Generated Service................................................195 Monitoring the Generated Service – Neo........................................ 196 Monitoring the Generated Service – Cloud Foundry.................................196 7.4 Securing the Generated Service.................................................197 SAP Cloud Platform Security.................................................201 7.5 Appendix.................................................................205 8 User Guide...............................................................210 8.1 Onboarding to the MDK Client App...............................................210 8.2 Installing the App on a User's Device..............................................211 8.3 Updating an App on a User's Device.............................................. 212 Using SAP Cloud Platform Mobile Service, mobile development kit Content PUBLIC 3 1 Developing Apps Using the Mobile Development Kit The Mobile Development Kit for SAP Cloud Platform Mobile Services is a metadata-based application development platform. The Mobile Development Kit (MDK) lets you customize, deploy, and manage your customized apps in the cloud. The Mobile Development Kit editor lets you edit various aspects of your application using the MDK editor. It also provides native client support and consumes mobile services such as onboarding, offline OData, life cycle management, and supportability through the SAP Cloud Platform using the Mobile Development Kit client. MDK allows business process experts to customize the app in a cloud-based editor using the SAP Web IDE for Full-Stack Development, and developers to edit code directly in the metadata files. The end-to-end use case for MDK includes tasks involving the following roles: ● Administrator ● Business process expert ● Developer ● User Depending on your company and setup, you may have variations of this role breakdown. The workflow below is intended to help you set up your system and get started with using MDK. The typical task order is top-down, based on the roles noted above. You might not need to perform some of these tasks based on what you are trying to accomplish. The following workflow is a suggested use case only. Using SAP Cloud Platform Mobile Service, mobile development kit 4 PUBLIC Developing Apps Using the Mobile Development Kit Using SAP Cloud Platform Mobile Service, mobile development kit Developing Apps Using the Mobile Development Kit PUBLIC 5 ● Getting Started [page 8] ● Creating MDK Apps on SAP Cloud Platform Mobile Service for Development and Operations [page 9] ● ● Setting Up the Editor in SAP Web IDE Full-Stack [page 24] ● Importing App Metadata into the Editor [page 25] ● Creating a New Project Using an Editor Template [page 28] ● Customizing Advanced Rules [page 169] ● Creating Extension Controls with Nativescript [page 173] ● ● Managing Your App Life Cycle with App Update [page 13] ● ● Building your MDK Client SDK [page 14] ● Installing the App on a User's Device [page 211] ● ● Updating an App on a User's Device [page 212] Using SAP Cloud Platform Mobile Service, mobile development kit 6 PUBLIC Developing Apps Using the Mobile Development Kit 2 Language Support The Mobile Development Kit SDK includes localized versions of end-user facing texts that are part of the UI controls. End-user facing texts have been translated into these languages: ● English (en) ● German (de) ● French (fr) ● Portugese (pt) ● Spanish (es) To know about locale based formatting in the MDK editor, see the following topics: ● Internationalization and Localization of App Metadata [page 32] ● Usage of Internationalized and Localized Data [page 35] Using SAP Cloud Platform Mobile Service, mobile development kit Language Support PUBLIC 7 3 Administrator Guide The following tasks are typically completed by an administrator. Getting Started [page 8] Set up your landscape to begin using Mobile Development Kit. Creating MDK Apps on SAP Cloud Platform Mobile Service for Development and Operations [page 9] As an administrator, you can create MDK applications using the Mobile service for development and operations cockpit, in both Neo and Cloud Foundry environment. Setting Up App Security [page 10] 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. Setting Up SAP Web IDE Full-Stack to Work with Mobile Development Kit [page 10] 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. Managing Your App Life Cycle with App Update [page 13] While creating a new app using the Mobile service for development and operations cockpit, if you specify Mobile Development Kit as the app type, then the App Update feature is assigned to the app by default. Building your MDK Client SDK [page 14] Build and run the MDK client to connect to your SAP Cloud Platform mobile application. You can also package your app so that it can be posted to the iOS Enterprise App Store. Branding Your Customized App [page 16] Brand your app to customize it based on your company's requirements before you post it to the Enterprise App Store. 3.1 Getting Started Set up your landscape to begin using Mobile Development Kit. Begin by setting up the following: Set up Description Link SAP Cloud Platform Cockpit Set up SAP Cloud Platform cockpit to Getting a Global Account build, deploy,