BBM SDK for BlackBerry WebWorks

These release notes are for the BlackBerry Messenger SDK 1.1 for BlackBerry WebWorks.

New in this release

Component changes

Component

Updated

Description

BlackBerry MDS Simulator

N

MDS 3.5.3.36

BlackBerry Smartphone Simulator

Y

Model 9800 6.0.0.313 with BBM 6.1.0.37

Smartphone simulators for BlackBerry 7 are not supported in this release.

Sample Apps

Y

BBMWebWorksDemo 6.1.0.49

Deprecated APIs

Deprecated API

Use

blackberry.bbm.platform.requestUserPermission

blackberry.bbm.platform.showBBMAppOptions

New APIs

API

Description

blackberry.bbm.platform.users.BBMPlatformUser.appVersion and bbmsdkVersion

Allow your application to query the version of your application and the version of the BlackBerry Messenger SDK that are installed on a user's BlackBerry device or on the device of a user's contacts. You can use this information to determine whether your application is compatible between users.

blackberry.bbm.platform.users.shareContent and onsharecontent

Allow your application to share content with a user's BBM SDK contacts, even if the contact is not running the same version of BBM.

blackberry.bbm.platform.settings.alwaysAllowPublicConns

Allows your app to query whether a prompt is shown when making a connection public or requesting to join a public connection.

blackberry.bbm.platform.settings.profileboxEnabled

Allows your application to query whether a user's profile box is enabled.

Upgraded APIs

  • A new user parameter has been added to blackberry.bbm.platform.onappinvoked. This parameter allows your app to capture the user who invoked your app.

Fixed issues

WebWorks development

Issue

When you tried to clear a personal message by passing null to blackberry.bbm.platform.self.setPersonalMessage(), an "Unexpected error: Argument is not nullable" error was thrown. (2062308)

Known issues

WebWorks development

Issue

Workaround

If you pass an invalid PPID to io.joinHost(), a null exception is thrown.

This occurs on BlackBerry devices but not on the BlackBerry Smartphone Simulator.

None.

BBM SDK

Issue

Workaround

If you have enabled content protection and a chat participant locks and then unlocks their smartphone, the chat session ends. (1143849)

None.

You must accept the end user licence agreement, and enter a display name before you can register your application with the BBM SDK.

None.

If your application is designed to run on startup, and registers with the BBM SDK using the event thread, it may cause a queue overflow.

Register your application using another thread.

BlackBerry Smartphone Simulator

Issue

Workaround

The Invite to Download functionality cannot be tested on the BlackBerry Smartphone Simulator because BlackBerry App World is not supported on the BlackBerry Smartphone Simulator.

None.

The BlackBerry Smartphone Simulator cannot communicate with the other BlackBerry Smartphone Simulator instance and shows 'edge' in the top right corner of the Home screen.

  1. Launch one of the BlackBerry Smartphone Simulator instances.
  2. On the Home screen, click Manage Connections.
  3. Clear the Mobile Network check box.
  4. On the Simulate menu, click Network Properties.
  5. In the Network Properties dialog box, select Default 3G Network (GSM) and click Delete..
  6. Click the Add button to add a new network.
  7. In the Choose network type dialog box, select GSM and click OK.
  8. In the Add GSM Network dialog box, in the Name field, type in a network name.
  9. In the MNC field, type 1638.
  10. In the MCC field, type 302.
  11. In the LAC field, type 0.
  12. Leave the MCC initials field blank.
  13. In the Network Type section, select 3G.
  14. Click OK.
  15. In the Network Properties dialog box, click Close.
  16. On the Home screen, click Manage Connections.
  17. Select the Mobile network check box.
  18. Check that 3G appears in the top right corner of the Home screen.
  19. Close the BlackBerry Smartphone Simulator.
  20. In your simulator directory, delete all the files with filenames: sim*.dmp and sim*.bug.
  21. Restart the BlackBerry Smartphone Simulator.
  22. Attempt to send an email in the simulator. If you cannot send, perform the following actions:
  23. On the Home screen, click Options.
  24. Click Device.
  25. Click Advanced System Settings.
  26. Click Host Routing.
  27. On the menu of the Host Routing Table screen, click Register now.