New Features: SAP Mobile Platform SDK SAP Mobile Platform 3.0
DOCUMENT ID: DC01991-01-0300-01 LAST REVISED: November 2013 Copyright 2013 by SAP AG or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Please see http://www.sap.com/corporate-en/legal/copyright/ index.epx#trademark for additional trademark information and notices.
Contents New Features Summary...1 Client Hub...1 OData SDK...1 Kapsel SDK...2 Agentry Toolkit...3 SMS Toolkit...3 Portal Templates...4 SAP Companion Developer Tools...4 Changes to Documentation...5 Supported Versions for SAP Mobile Platform SDK...5 New Features: SAP Mobile Platform SDK iii
Contents iv SAP Mobile Platform
New Features Summary New Features Summary This SAP Mobile Platform SDK release enhances the open standards-based application development introduced in SAP Mobile Platform previous versions. SAP Mobile Platform SDK extends the developer experience with a shift to common open standards-based development. The enhanced SDK provides additional functionality through platform services, rapid application development, and a common API and SDK that is supported across multiple deployment platforms and versions. These new features provide developers with a faster, vertically scalable development experience. Client Hub The Client Hub, integrated with Logon Manager, simplifies user onboarding and configuration to enable easier and faster enterprise-wide deployments. The Client Hub saves the end user from managing multiple passwords for mobile applications, thereby improving the user experience. The Client Hub provides these functions: Manages single sign-on (SSO) on the device. Enables cosigned business applications with the same security configuration to securely share credentials on the device. Supports multiple security configurations per device. The Client Hub is supported for Kapsel applications and native OData applications. Documented in: Developer > Client Hub OData SDK New or changed features for OData SDK. The OData SDK included in SAP Mobile Platform SDK supports Android and ios platforms and is based on the native device SDKs of the platforms using REST services with pure HTTP or HTTPs. New features included in the OData SDK include: Logon Manager integration with the Client Hub. This feature provides a simplified onboarding experience, and easier configuration to enable faster enterprise-wide deployments. Specific functionality includes: Single sign-on management New Features: SAP Mobile Platform SDK 1
Kapsel SDK Cosigned business applications with the same security configuration enabled to securely share credentials on the device Multiple security configurations per device support Documented in Developing ios Applications Using OData SDK > Developing with MAF Login in Developer > Native OData App Development. OData offline APIs seamlessly cache data and merge delta updates. This allows device users to access and modify enterprise data when disconnected from their corporate network and then easily retrieve and modify the data when the connection is reestablished. Documented in Caching the Data in Developer < Native OData App Development < Developing ios Applications Using OData SDK and Developing Android Applications Using OData SDK Request API enhancements that support batch processing. Documented in Invoking a Request in Developer < Native OData App Development < Developing Android Applications Using OData SDK and Creating a Request in Developer < Native OData App Development < Developing ios Applications Using OData SDK. OData parser now supports JSON format. Kapsel SDK SAP Mobile Platform SDK includes the Kapsel SDK, a set of SAP plugins for the open-source Apache Cordova framework. Cordova provides a flexible, open framework featuring a single common API that allows you to develop hybrid applications across multiple device platforms. Cordova's open architecture includes a node-based command line interface that lets you manage a single project that works across multiple device platforms. By adding Kapsel plugins to a Cordova application, the application gains several enterprise application features as well as an awareness of SAP Mobile Platform Server. Kapsel extends the Cordova container through a standard plugin interface defined by the Cordova development team. Kapsel consists of the following plug-ins: AppUpdate provides server-based updates to the Web application content running in the Kapsel application. This plug-in replicates some of the life cycle management capabilities provided by the Hybrid Web Container in earlier versions of SAP Mobile Platform. AuthProxy HTTP and HTTPS requests on behalf of the Kapsel application. This plugin automates the process of accepting SSL certificates returned by a call to a Web resource (without user involvement). Logging adds a SAP Mobile Platform logging API to a Cordova application. Log level can be set by the application or controlled remotely by the administrator and the log can be uploaded to SAP Mobile Platform Server for problem analysis. Logon implements the SAP Mobile Platform Mobile Application Framework Logon Manager component in a Cordova application. This plug-in provides a skinnable UI for an 2 SAP Mobile Platform
Agentry Toolkit application's login form, and manages the complete process of logging in to SAP Mobile Platform Server. Push adds SAP Mobile Platform server-based push notifications. This plug-in allows a Kapsel application to register for push notifications, process push notifications, and update the local application UI to indicate that push notifications have been received. EncryptedStorage implements a non-blocking, encrypted storage API which mimics the W3C Web storage API. Settings simplifies the process for a Cordova application to exchange connection-related settings with SAP Mobile Platform Server. This plugin is used by the AppUpdate and Push plugins. Documented in: Developer > Kapsel Development. Agentry Toolkit New or changed features for the Agentry Toolkit. SAP Mobile Platform continues support for Agentry Client Extensions, but also implements an Open UI Framework that allows users to develop custom UI controls. These controls allow you to use the Agentry Editor to customize your own representation of the Agentry Screen. Documented in Developer > Agentry App Development. The Agentry toolkit implements the Exchange Data Model for data synchronization in this release. The Exchange Data Model provides an efficient method for retrieving offline data when users synchronize their clients. Using the Exchange Data Model, you can implement synchronization process that retrieve only the information that has been modified since the last synchronization. This model results in more efficient synchronization for users, and reduces the amount of resources needed by the system as a whole during the synchronization process. Documented in: Developer > Agentry App Development > Developing Agentry Apps > Data Synchronization Overview: The Exchange Data Model and Developer > Agentry App Development > Developing Agentry Apps > Object Development Concepts and Considerations > Object Data Synchronization: Fetches SMS Toolkit SAP Mobile Platform SDK includes SMS Toolkit, which features SMS Builder. You can use SMS Builder to develop short message service (SMS) mobile applications. SMS Builder includes a Web UI you can use to develop applications, and a messaging server that: New Features: SAP Mobile Platform SDK 3
Portal Templates Provides the runtime environment and manages application life cycles Invokes applications based on scheduled events Manages sessions Manages incoming and outgoing communication channels Use the SMS Builder to visually compose a mobile-messaging application, test it using a built-in simulator, and deploy it, ready to be used by mobile consumers. Documented in Developer > SMS Application Development. Portal Templates The portal templates are reference Web applications, which you can customize to meet your mobile-banking needs. The available portal templates include: Administration Portal customer support agents can use the Administration Portal to manage customers and agents. Consumer Portal the Consumer Portal includes functions so that your customers can manage their mobile-banking accounts. Partner Portal for distribution partners and agents who sell to consumers on behalf of a system provider. Documented in Developer > SMS Application Development > Application Services (Mobiliser) Portal Templates. SAP Companion Developer Tools Developers can use SAP companion developer tools to deploy mobile applications to SAP Mobile Platform AppBuilder AppBuilder is an integrated development environment that you can use to create HTML5 mobile applications using predefined application templates. It uses a simple drag-and-drop interface that leverages UI5 controls, and facilitates quick and simple deployment of your mobile application. You can use AppBuilder to create Adobe Cordova projects, in which you can develop mobile applications using predefined application templates included with AppBuilder. A WYSIWYG form designer enables you to design the application form interactively, and the data source wizard lets you connect to the data source for the application and bind it to the controls on the form. When finished, you can deploy the application to Kapsel on SAP Mobile Platform Server or to a local Cordova application package. 4 SAP Mobile Platform
Changes to Documentation Gateway Productivity Accelerator Gateway Productivity Accelerator (GWPA) is an Eclipse-based development tool provided by SAP to enhance the SAP NetWeaver Gateway offering. However, it can also be used to create OData models and for service consumption by HTML5 and native applications that are deployed through SAP Mobile Platform. GWPA features a graphical OData Model Editor that obtains user actions and data in order to generate code for OData models and service metadata, and access to the Service Catalog for an overview of all existing services. GWPA also includes service consumption toolkits that contain environments, patterns, and templates suitable for developing and delivering SAP solutions for specific platforms. Find more information about GWPA on the SAP HANA Cloud Documentation site. Changes to Documentation Documentation organization is modified to reflect the product structure. This release of SAP Mobile Platform separates SAP Mobile Platform Server and SAP Mobile Platform SDK, so that each is provided as a separate product. For consistency, the documentation is organized to reflect that separation, with separate documents for SAP Mobile Platform Server and SAP Mobile Platform SDK. Additionally, the content is organized by the key roles of Developer and Administrator. This provides you with comprehensive details for an end-to-end experience that is specific to your role, allowing you to focus on the content that is most important to you. Troubleshooting and New Features are now separate for SAP Mobile Platform Server and SAP Mobile Platform SDK, with content that is specific to the experiences for each product. Supported Versions for SAP Mobile Platform SDK Supported Versions for SAP Mobile Platform SDK can now be accessed through the SAP Product Availability Matrix (PAM). The Supported Hardware and Software Guide is no longer included in the core documentation. Supported operating systems, development environments, devices, and thirdparty compatibility is now accessible from the SAP Product Availability Matrix (PAM) http:// service.sap.com/pam. Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list. Click the Technical Release Information tab for the list of supported operating systems and databases. In the General Information tab, click Additional Release Information in the Related Links section for additional system requirements, supported development environments, devices, and third-party compatibility. Note: Access to PAM requires an SAP Service Marketplace login. Register for an SAP Service Marketplace login here http://service.sap.com/request-user New Features: SAP Mobile Platform SDK 5
Changes to Documentation Additional hardware and software requirements for this SAP Mobile Platform SDK release are accessible through the Product Availability Matrix, but they are maintained in SAP Notes through the SAP Service Marketplace, which also requires a login.. SAP Note 1890477 lists SAP Mobile Platform SDK minimum hardware requirements Supported JDK versions Virtual machine support. SAP Note 1933857 provides a matrix of supported device operating systems across the SAP Mobile Platform SDK components. Additionally, the devices that have been tested with those operating systems are listed SAP Note 1933862 provides a matrix of all of the 3rd party software versions required for setting up the development environments for each of the SAP Mobile Platform SDK components 6 SAP Mobile Platform