Object API Changes in SDK Version 2.2 SP02

There are several changes in the Object API for SDK 2.2 SP02.

Write to the Database During Synchronization

Connection API changes enable you to write to the database during synchronization.

New Connection Method
Method Description
allowConcurrentWrite Sets the property to true to allow multiple concurrent writer threads.

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

Synchronization Parameter Enhancements

Subscription API changes let you more easily read or update synchronization parameter names or values for all active synchronization parameter sets; and add synchronization parameters before performing an initial synchronization.

New Subscription Methods
Method Description
GenericList([mbo]Subscription > GetSubscriptions() Returns all subscription information. For list type synchronization parameters, the MBO class should use this method to get all default subscriptions.
AddSubscription([mbo]Subscription subscription) Adds a subscription.
RemoveSubscription([mbo]Subscription subscription) Removes a subscription.

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

Native Push Notification

Use the new addPushNotificationListener API to register the push notification listener object, and implement a new PushNotificationListener protocol definition to receive push notifications. When a native push notification is received, the listener's onPushNotification method is invoked.

New Push Notification Method
Method Description
addPushNotificationListener Enables push notification.
Documented in: Developer Guide: <Device Platform> Object API Applications, see:
  • Native Notification APIs
  • Callback and Listener APIs

KPI Tracking

A new Object API client interface enables iOS, Android, and BlackBerry to access performance libraries for tracing or collecting key performance indicators (KPIs).

New PerformanceAgentService Methods
Method Description
startInteraction() The service starts collecting metrics.
stopInteraction() Metrics collection stops and a summary is sent to a reporting target.

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

End to End Trace

New API enables you to provide code in client applications so end users can enable trace from the device to the enterprise information system (EIS).
New End to End Trace Classes
Class Platform
  • com.sybase.mobile.util.e2etrace.E2ETraceService
  • com.sybase.mobile.util.e2etrace.E2ETraceLevel
  • com.sybase.mobile.util.e2etrace.impl.E2ETraceServiceImpl
  • com.sybase.mobile.util.e2etrace.impl.E2ETraceMessage
Android
  • SUPE2ETraceService
  • SUPE2ETraceLevel
  • SUPE2ETraceServiceImpl
  • SUPE2ETraceMessage
iOS

Documented in: Developer Guide: <Device Platform> Object API Applications (Android and iOS), see End to End Trace

Customization Resource Bundles

A new Application API method is available for customization resource bundles.
New Application API Method
Method Platform
beginDownloadCustomizationBundle() Android, BlackBerry, iOS, Windows, Windows Mobile

Documented in: Developer Guide: <Device Platform> Object API Applications, see beginDownloadCustomizationBundle()

New BlackBerry Application Signing API

A new BlackBerry application signing API is available for com.sybase.mobile.Application.getInstance().setApplicationIdentifier(String value), which is based on the BlackBerry Password Based Code Signing Authority.
New BlackBerry Application Signing API
Method Description
setApplicationIdentifier(String value, signerId) Identifies the signed key file used by the application. The key file is used with the BlackBerry Password Based Code Signing Authority.
Deprecated BlackBerry API
Method Description
setApplicationIdentifier(String value) This method set will be removed in a future release.

Documented in: Developer Guide: BlackBerry Object API Applications, see Signing