Object API Applications

New or changed features for native client Object API development include using Afaria certificates for device authentication and standalone Afaria libraries; writing to the database while synchronizing; synchronization parameter enhancements; consuming a native (push) notification; tracking KPIs; performing end-to-end trace from the device client; and supporting HTTPS. Customization resource bundles are now available for Object API applications; message text can be localized and customized; and BlackBerry signing is handled through a new API.

Certificates from Afaria for Authentication

One of the Afaria features is the ability to provide a device with a signed certificate that could be used as an authentication credential for Sybase Unwired Platform. With this release, developers can convert a certificate from Afaria into a form consumable by Sybase Unwired Platform.
Note: This feature does not support BlackBerry, or Windows and Windows Mobile.

Documented in: Developer Guide: <Device Platform> Object API Applications (Android and iOS only), see Using Certificates from Afaria for Authentication

Standalone Afaria Libraries

Standalone Afaria libraries are now used with Sybase Mobile SDK.

Documented in:

Write to the Database While Synchronizing

A new connection profile property lets developers use multiple threads to write to the database while synchronizing.

Documented in: Developer Guide: <Device Platform> Object API Applications, see Setting Up the Connection Profile

Synchronization Parameter Enhancements

  • Easily read or update parameter settings – you can more easily read or update synchronization parameter names or values for all active synchronization parameter sets.

    In earlier versions, synchronization parameter values were cumulative. Calling [MBO]SynchronizationParameter.save() twice produced two synchronization parameters values, with no way to query all current (cumulative) values, and update them (except using delete all ! and add again). You can now use the methods in [MBO]Subscription class to perform create, update, or delete functions for all active synchronization parameter sets.

    Documented in: Developer Guide: <Device Platform> Object API Applications, see Managing Synchronization Parameters

  • No need for an initial sync – you can now add synchronization parameters before performing an initial synchronization. Previously, you needed to sync, add the synchronization parameters, and then sync again.

    Documented in: Developer Guide: <Device Platform> Object API Applications, see Nonblocking Synchronization

Native Push Notification

You can consume a native push notification on the device using the native device operating system.

When a push notification is received, the onPushNotification method is invoked. You can add logic to handle the notification.

Documented in: Developer Guide: <Device Platform> Object API Applications, see: ApplicationCallback API

KPI Tracking

Object API clients for Android, BlackBerry, and iOS can access performance libraries through a new PerformanceAgentService interface, for tracing or collecting key performance indicators (KPIs).

Performance data is written to a log file on the device. The administrator can retrieve the performance log through Sybase Control Center.

Documented in: Developer Guide: <Device Platform> Object API Applications (Android, BlackBerry, and iOS), see Tracking KPI

End-to-End Tracing

Developers can now use the API to enable users to initiate end-to-end tracing from the device client side.

Documented in: Developer Guide: <Device Platform> Object API Applications, see Debugging Runtime Errors and Performance Analysis

HTTPS Support Added for Clients

HTTPS support is now available for messaging and replication clients that use messaging communications between the messaging client and server. Previously, HTTPS communication was available only through Relay Server. Some minimal client code change and server setup is required.

Documented in:
  • Developer Guide: <Device Platform> Object API Applications, see:
    • Setting Up Application Properties
    • NetworkProtocol
    • PortNumber

Customization Resource Bundles

Customization resource bundles are now available for Object API applications (Android, BlackBerry, iOS, Windows, and Windows Mobile). This enables you to provision applications using metadata rather than recompiling code; gives you more configuration and versioning control over applications; and enables you to deliver packaged applications that are configurable and extensible.

Documented in: Developer Guide: <Device Platform> Object API Applications, see:
  • beginDownloadCustomizationBundle
  • ApplicationCallback

Error Handling

The Object API message text used in end-user application-visible error messages can be localized and customized.

Documented in: Developer Guide: <Device Platform> Object API Applications, in the Client Object API Usage, Exceptions section:
  • Base Exceptions
  • Exception Message Service
  • Service Registry

Change to BlackBerry Signing

A new API [setApplicationIdentifier (String value, signerId)] has been introduced for signing BlackBerry applications. The API is based on the BlackBerry Password Based Code Signing Authority tool.

Documented in:
  • Developer Guide: BlackBerry Object API Applications, see Signing
  • Developer Guide: Migrating to Sybase Mobile SDK, see:
    • BlackBerry (in the Migrate Object API Applications section)
    • Object API Changes in SDK Version 2.2 SP02