Hybrid App and Hybrid Web Container

Hybrid App Designer Enhancements

The Designer simplifies building richer Hybrid Apps by extending the list of controls and using the latest updated framework in Designer-enabled scenarios. New Designer features and related topics:

Enhanced jQuery support – includes the upgraded jQueryMobile version used to generate JavaScript; jQueryMobile-style properties for listview control; and default jQueryMobile look and feel for BlackBerry 5.
Documented in:
- Sybase Unwired WorkSpace - Hybrid App Package Development, see Listview Properties
- Developer Guide: Hybrid Apps, see Look and Feel Files
New controls – new controls provide access to Mobile Analytics Kit within the Designer; control is available over generated JavaScript files and load order; online request activation can be invoked in Hybrid Apps that mark a notification as being successfully activated; and improvements have been made to the user interface.
Documented in:
- Sybase Unwired WorkSpace - Hybrid App Package Development, see:
  - Chart Control
  - Hybrid App Controls
  - Controlling Loading of JavaScript and CSS Files
  - Menu Item and Custom Action Properties
  - Button Properties
Generate Hybrid Apps – Hybrid App Designer now generates Hybrid Apps that use the new JavaScript APIs from Hybrid Web Container.
Documented in: Developer Guide: Hybrid Apps, see:
- Generating Hybrid App Files and Deploying a Package
- Generated Hybrid App Files
- Generated HTML Files

Hybrid Web Container Enhancements

Enhancements include client variable support through native or JavaScript API, support for hiding the list screen in iPad landscape mode, support for NetWeaver Gateway and proxy, prepackaged Hybrid Apps, and capability to automatically provision Hybrid Apps.

Client variable support – define a client variable on the server side and retrieve it on the client side using either native API or JavaScript API.
Documented in: Developer Guide: Hybrid Apps, see Manifest.xml and Client Variables

iPad list screen – hide the Hybrid App list screen in landscape mode on the iPad.
Documented in: Developer Guide: Hybrid Apps, see Hiding the Listview on iPad
Support for NetWeaver Gateway and proxy – developers can write HTML5 applications packaged to run in Hybrid Web Container, but can communicate directly to NetWeaver Gateway through the proxy server using the new REST API. Versioning and life-cycle management of Hybrid App packages is still supported. Implications for related functionality include:
- Native notifications (sometimes called push) are supported through NetWeaver Gateway subscriptions. Existing data change notification (DCN)-based push still requires MBOs.
- Encrypted Sybase Unwired Platform Storage and Certification repository is still accessible.
- Apache Cordova and Device API is still accessible.
Documented in:
- Developer Guide: Hybrid Apps, see:
  - Develop OData-based Hybrid Apps
  - Supported JavaScript PhoneGap APIs
- Developer Guide: REST API Applications
Prepackaged Hybrid App in Hybrid Web Containers – developers can now create a Hybrid Web Container compiled with the initial version of a Hybrid App. When the Hybrid Web Container launches, the initial version of the Hybrid App is available for use. Previously, the Hybrid Web Container shipped as an empty container, and the Hybrid App had to be downloaded from Unwired Server after the client application initially connected to Unwired Server.
Documented in:
- Developer Guide: Hybrid Apps, see: Prepackaged Hybrid Apps
- Sybase Control Center for Sybase Unwired Platform, see:
  - Assigning and Unassigning Hybrid Apps to Application Connections
  - Assigning and Unassigning Hybrid Apps
Automatic Hybrid App provisioning – Hybrid Apps can now be deployed to a user upon successful on-boarding, without any administrative action. The administrator can assign one or more Hybrid Apps to an application connection template used for automatic on-boarding. Those assigned Hybrid Apps are provisioned into the user's Hybrid Web Container once the user's credentials have been successfully authenticated and authorized during on-boarding.
Documented in: Sybase Control Center for Sybase Unwired Platform, see:
- Application Connection Templates
- Assigning and Unassigning Hybrid Apps to Application Connection Templates

Develop Hybrid Apps using Third-Party Tools

You can develop Hybrid Apps using a third-party development tool, such as Sencha, Appcelerator, or PhoneGap, without Sybase Unwired WorkSpace. Develop Hybrid Apps in the native development platform of choice (Android, BlackBerry, iOS, or Windows Mobile), and then use the new Hybrid App packaging tool to create the package apart from the Designer. This enables developers to develop applications in the tool with which they are experienced.

Documented in Developer Guide: Hybrid Apps:

Develop Hybrid Apps Using Third-Party Web Frameworks
Packaging Hybrid Apps Using the Packaging Tool

Cordova APIs Available for All Platforms

Sybase Unwired Platform comes with Cordova 2.0 (previously, PhoneGap 1.4.1 was embedded with Sybase Unwired Platform Android/iOS Hybrid Web Containers) libraries linked in and ready to use. These libraries handle common tasks supported by most devices. Integrating PhoneGap plug-ins with Hybrid Web Containers allows you to extend the set of APIs available within a Hybrid App. Supported platforms now include BlackBerry and Windows Mobile, as well as Android and iOS.

Documented in: Developer Guide: Hybrid Apps, see Adding Native Device Functionality to the Hybrid Web Container

Develop Hybrid Apps with OData Calls

You can develop a Hybrid App using a third-party development tool, such as jQuery Mobile, and add OData calls to Proxy and NetWeaver via the REST API. Use the Hybrid App packaging tool and the prepackaged Hybrid App feature to package and provision the Hybrid App to the client side.

Documented in: Developer Guide: Hybrid Apps, see Develop an OData-Based Hybrid App, and generated developer documentation

SAP Passport Handling

The Hybrid Web Container includes integration of SDMSupportability libraries for SAP Passport handling. This allows the developer to configure and use the end-to-end tracing functionality.

Documented in:

Developer Guide: Hybrid Apps, see SAP Passport Handling
System Administration, see Using End-to-End Tracing to Troubleshoot and Diagnose Problems

New JavaScript Generation for MBO API

Generate JavaScript API for mobile business objects, without the user interface component. Developers can use the API in their custom code, without generating UI code.

Documented in:

Developer Guide: Hybrid Apps, see Generating JavaScript MBO Access API
Sybase Unwired WorkSpace - Hybrid App Package Development, see Generating Files for an Externally Developed Hybrid App

Hybrid App Packaging Tool

The Hybrid App packaging tool enables you to package a Hybrid App developed in a third-party development environment. This tool is available in the SUP_HOME installation directory, and is used to package existing files.

Documented in Developer Guide: Hybrid Apps:

Packaging Hybrid Apps Using the Packaging Tool

Hybrid Web Container Template for BlackBerry and Windows Mobile

The Hybrid Web Container project is accompanied by libraries and the source code necessary for you to build the Hybrid Web Container. Source code is now available for BlackBerry and Windows Mobile platforms.

Documented in: Developer Guide: Hybrid Apps, see:

BlackBerry Hybrid Web Container Customization
Windows Mobile Hybrid Web Container Customization

New JavaScript APIs

New JavaScript APIs enable you to index custom icons, and make online request calls in asynchronous or cache policy modes:

Custom icons for Hybrid Apps – hwc.CustomIcon indexes custom icons. Defined in hwc-api.js.
Online request cache enhancements – doOnlineRequest allows you to make online request calls in asynchronous mode (asynchronous method) instead of waiting for loading to complete. When cache is enabled (cachePolicy method ), you can define whether to get the cache content or to get real-time data if server connectivity is available. When cache is enabled, you can define the cache content expiration, or specify no expiration.
Hybrid Web Container settings – JavaScript APIs that allow a developer to mimic the native Settings screen in the Hybrid Web Container.

Documented in: Developer Guide: Hybrid Apps, see:

Develop Hybrid Apps Using Third-party Web Frameworks
Hybrid Web Container and Hybrid App JavaScript APIs (includes a link to the generated API documents)