Beta testing and releasing your BBM connected app

The BBM pre-production environment

The BlackBerry Messenger pre-production environment is a dedicated cluster of BBM services that provides all of the functionality of the BBM Social Platform. The pre-production 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 smartphones with a small beta community before you release it through the BlackBerry World storefront.

If your app, or app version, does not already exist in BlackBerry World, it is automatically placed in the pre-production 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. Since the pre-production 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. Once expired, your app no longer has access to the BBM platform services in the pre-production environment.
  • An app in pre-production can communicate (for example, share content or send join invitations) only with other users who are running the same app or app version. This means that users who are testing the app cannot communicate with users who are running any version of that app if it 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 BlackBerry Messenger 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.

UUID Guidelines

A Universally Unique Identifier (UUID), also known as a Globally Unique Identifier (GUID), is a unique, 128-bit, 36-character identifier that you generate for your app using a UUID/GUID generator. Your app must provide a UUID when it registers with the BBM social platform to access the social platform APIs. The UUID string must conform to the Microsoft 8-4-4-4-12 format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Valid characters consist of hexadecimal values in the ranges 0 to 9 and a to f.

The UUID is also used to identify your app (along with the vendor name and the app name) in the pre-production test environment, before the app is made available in BlackBerry World. If the app is installed from BlackBerry World, the UUID is not used to identify it. You should use the same UUID when testing future releases of the same app. If the UUID changes across versions, different versions of the same app will not be able to communicate with each other in the pre-production environment.

Releasing BBM connected apps through BlackBerry World

If you have separate, optimized versions of your app for BlackBerry smartphones running BlackBerry 7 (or earlier) and BlackBerry 10, 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 smartphone communicate with the same app running on a BlackBerry 10 smartphone, 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: 2013-12-21

comments powered by Disqus