This article applies to the following:
BlackBerry® World™ storefront
- BlackBerry® Browser
- BlackBerry® Device Software 4.2 and later
- BlackBerry smartphones with trackballs or SurePress™ touch screens
- Web content development
BlackBerry® World™ can be launched from the BlackBerry Browser by creating a link on your web page to a file that has a file name extension of .bbaw and contains the
App World ID of the application to be launched.
When a BlackBerry smartphone user clicks on the .bbaw file from the BlackBerry Browser, BlackBerry World is invoked and the details page for the corresponding application is loaded.
This feature is only available when accessing a web page from the BlackBerry smartphone. Therefore, your web site should only present a link to the .bbaw file when accessed from a BlackBerry smartphone. Currently, BlackBerry World is only available to select countries and wireless service providers.
- Configure your web server to accept a .bbaw file by defining a new BlackBerry World mime type as follows:
- Use a text editor to open the web.xml file that is located in the
conffolder of the
- Add the following mapping definition to the
Default MIME Type Mappingssection:
- Save the web.xmlfile.
Microsoft® Internet Information Services
- On the Start menu, open IIS.
- Right-click Default Web Site, and then select Properties.
- Select the HTTP Headers tab.
- In the MIME Map section, click the File Types … button.
- Click the New Type … button.
- In the Associated extension field, type bbaw.
- In the Content type (MIME) field, type application/x-bb-appworld.
- Click OK.
- Create a plain text file with a file extension of .bbaw that contains your application ID. The application ID should be the only value in the file and it should be on the first line with no other information. There should be no whitespace before or after the application ID.
You can identify the value of your application's ID from the vendor portal. In Manage Applications, open your application and look for a 3 or 4-digit number after the
contentID=value in the web address.
This file should be deployed on your web server.
The following is an example of an application ID in an app.bbaw file:
- Create a link on your web page to your .bbaw file as shown in the following example:
<body><a href="app.bbaw">View My Application </a></body>