Object API Changes in SDK Version 2.1 ESD #2

These are the changes in the Object API in SDK 2.1 ESD #2. If your application is built with an earlier version of the SDK, update your application to include the required or recommended API changes.

Application APIs

Sybase Unwired Platform supports and requires clients to use the Application APIs to manage mobile application registrations, application connections, and context. These APIs are provided in the Application (or SUPApplication) class.

Documented in
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: iOS Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • Initializing an Application
    • Application APIs
:

ApplicationCallback APIs

Sybase Unwired Platform supports a new ApplicationCallback interface that is invoked by events of interest to a mobile application.

Documented in:
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: iOS Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • ApplicationCallback API

Large Attribute APIs

Sybase Unwired Platform supports new large attribute APIs to allow clients to import large messages containing binary objects (BLOBs) from the server or send a replay message without using excessive memory or throwing exceptions.

These new classes support large attributes:

Documented in:
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: iOS Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • Large Attribute APIs

Change Log APIs

(Not available in SDK version 2.1 ESD #2 for iOS; introduced for iOS in SDK version 2.1 ESD #3). New change log APIs allow a client to retrieve entity changes from the back end. If a client application already has a list view constructed, it simply needs to add, modify, or delete entries in the list according to the change logs.

Documented in
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • Change Log API

Asynchronous Operation Replay APIs

(Not available in SDK version 2.1 ESD #2 for iOS; introduced for iOS in SDK version 2.1 ESD #3). The Asynchronous Operation Replay API allows users to submit changed data outside a synchronization session without waiting for EIS execution. When an application calls submitPending on an MBO on which a create, update, or delete operation is performed, an operation replay record is created on the device local database.

Documented in:
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • Asynchronous Operation Replay

Encryption Key Management APIs

New methods in the connection profile support managing the encryption key for the local client database.

Documented in:
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • ConnectionProfile
    • Encrypt the Database
  • Developer Guide: iOS Object API Applications search for:
    • SUPConnectionProfile
    • Encrypting the Client Database

Change Notification APIs for Push Synchronization

(Not available in SDK version 2.1 ESD #2 for iOS; introduced for iOS in SDK version 2.1 ESD #3). Sybase Unwired Platform supports using a messaging channel to send change notifications from the server to the client device. Clients receive device notifications when a data change is detected for any of the MBOs in the synchronization group to which they are subscribed. By default, change notification is disabled. You can enable change notification by setting properties in the synchronization group.

Documented in
  • Developer Guide: Android Object API Applications
  • Developer Guide: BlackBerry Object API Applications
  • Developer Guide: Windows and Windows Mobile Object API Applicationssearch for:
    • Push Synchronization Applications

Removed APIs

The Messaging Client APIs (SUPMessageClient interface) have been removed. If your application uses the SUPMessageClient interface, you must rewrite it to use functionality from SUPApplication.