Testing and deploying

The BBM preproduction environment is a dedicated cluster of BBM services that provides all of the functionality of the BBM Social Platform. The preproduction environment is ideal for building internal, alpha, and beta versions of your BBM connected app. It provides you with an opportunity to test your app's features and functionality on activated BlackBerry devices with a small beta community before you release it through the BlackBerry World storefront.

If your app, or app version, doesn't exist in BlackBerry World, it is automatically placed in the preproduction environment. The UUID that you provide acts as a unique identifier for your app that facilitates monitoring for any adverse or unintended events (such as burstiness) in the traffic that is associated with your app. For more information about the UUID, see Prerequisites. Since the preproduction environment is intended for testing, while restricting traffic from your app in the production environment, the following limitations apply:

  • Each app is limited to 100 active instances.
  • An app expires after 180 days. When it has expired, your app no longer has access to the BBM platform services in the preproduction environment.
  • An app in preproduction can communicate (for example, share content or send join invitations) only with other users who are running the same app or app version. Users who are testing the app can't communicate with users who are running any version of that app that has been submitted to or is available in BlackBerry World.

Communication limitations

To prevent an application from using too much of the available bandwidth, the BBM platform limits the total volume of data that is transferred by a BBM connected application as follows:

  • All messages and application data transferred over channel and session connections for all BBM connected applications that are running on a BlackBerry device are collectively limited to a maximum data transfer rate that is configured by the BBM server. If the total volume of data attributed to an application threatens to exceed the maximum transfer rate, the BBM platform throttles data traffic for that application to reduce the transfer rate to an acceptable level. File transfers sent from a BBM connected application are not considered to be application data, and are therefore exempt from this limitation on the data transfer rate.
  • Data sent from a BBM connected application over a channel/session connection is limited to a maximum of 60 KB per transfer.
  • File transfers from a BBM connected application are limited to a maximum of 6 MB per file.
  • The maximum number of users in a connection is limited to 24.

Testing your app

Before you can test your BBM connected app in the device simulator, you need to install some software.

If you don't have a BlackBerry 10 device, you can download and install the BlackBerry 10 Device Simulator to test your apps.

The BBM server simulator is bundled with the BlackBerry 10 Device Simulator. To configure your environment, see Configuring the BBM server simulator. To test your app, see Testing BBM connected apps.

Deploying apps in BlackBerry World

If you have separate versions of your app for BlackBerry 7 (or earlier) and BlackBerry 10 OS, there are some things you need to consider when adding BBM connected apps to the vendor portal.

Typically, you assign a separate SKU to each app that you add to the vendor portal. However, if you want your app to be able to communicate across platforms, you must assign the same SKU to each variant of your app. To have a BBM connected app that is running on a BlackBerry 7 device communicate with the same app running on a BlackBerry 10 device, they must both have the same SKU in BlackBerry World. You can still submit different screen shots, icons, feature image, descriptions, and keywords for each variant of your app when using the same SKU. You can learn more about Adding and managing apps on the BlackBerry World vendor portal website.

Last modified: 2015-03-31

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus