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.
The UUID is used to uniquely identify an application in the test/pre-production environment. Once you upload the application to BlackBerry® App World™ storefront it is no longer used. Changing your UUID allows you to perform tests of your application in isolation of one another.
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 BlackBerry App World will remain unaffected because BlackBerry App World will assign unique identifies to applications when they are put up for sale.
You can manually create a UUID using the correct Microsoft 8-4-4-4-12 format or use an online UUID generator.