When BBM™ Connected applications instantiate BBMPlatformApplication, they must supply a UUID. The UUID is a 128-bit universally unique identifier for the application that must be 36 characters long and comply with the Microsoft® 8-4-4-4-12 format. Those numbers represent the number of characters in each sequence, separated by a dash. Here is an example of a UUID in the correct format: 4995d07c-13ee-42d1-92bb-90ba6ed33e1d. You can manually create a UUID or use an online UUID generator.

Using a UUID that doesn’t comply with the Microsoft 8-4-4-4-12 format can prevent your application from connecting to the BBM test/pre-production environment. If you do use an incorrect UUID format, you could receive an error of “Unable to connect to BBM. [App name] disconnected by RIM” when trying to connect. This only affects developers using the test/pre-production environment. Consumers who have purchased the application from the BlackBerry App World™ storefront will remain unaffected because BlackBerry App World will assign unique identifies to applications when they are put up for sale.

The UUID is used to uniquely identify an application in the test/pre-production environment. Once you upload the application to BlackBerry App World, it is no longer used. Changing your UUID allows you to perform tests of your application in isolation of one another.