Developer Quick Start

This guide walks you through the steps to implement the BlackBerry library.

Get the SDK

The SDK requires BlackBerry 10 or later

After unzipping the downloaded SDK, you'll have the following files in an AdobeMobile folder:

  • Device-Coverage/
  • Device-Debug/
  • Device-Profile/
  • Device-Release/
  • public/ADBMediaAnalytics.hpp
  • public/ADBMediaSharedHeader.hpp
  • public/ADBMediaState.hpp
  • public/ADBMobile.hpp
  • Simulator-Coverage/
  • Simulator-Debug/
  • Simulator-Profile/

Add the SDK to your Project

  1. Right-click on your project and select "Configure > Add Library.
  2. Select External library and click Next.
  3. Click Browse next to theDevice library field.
  4. Navigate to the ADBMobile-4.0.0BETA-BlackBerry folder.
  5. In the Device-Debug folder, select and click Open.
  6. Click Browse next to theSimulator library field.
  7. Navigate to the ADBMobile-4.0.0BETA-BlackBerry folder.
  8. In the Device-Debug folder, select and click Open.
  9. Click Add next to theInclude folders field.
  10. Navigate to the ADBMobile-4.0.0BETA-BlackBerry folder.
  11. Add the public folder to your includes.
  12. In the ADBMobile-4.0.0BETA-BlackBerry folder, there is a .json config file named ADBMobileConfig.json. Copy that file into the root of your project.
  13. Right-click on your project and select Refresh. The .json file should now be visible in your Project Explorer.
  14. Open the bar-descriptor.xml file for your project.
  15. At the bottom of the window select the Assets tab.
  16. Confirm that (All Configurations) is selected, then click the Add Files in the Assets section of the window. (Note, there is a bug in the QNX Momentics IDE that sometimes prevents those buttons from being visible. If you can't see the buttons, resize the windows until they appear).
  17. Click the Workspace button.
  18. Find the ADBMobileConfig.json file in your project and click OK.

Your application can import the classes/interfaces from the adobeMobileLibrary.jar library by using #include <ADBMobile.hpp>.

Add App Permissions

In bar-descriptor.xml in the project directory, add the line <permission>access_internet</permission>, or in the QNX Momentics IDE, check the box for Internet in the permissions section of the Application tab.

Update The ADBMobileConfig.json Config File

The ADBMobileConfig.json file contains global SDK settings. You need to update a few values to get started.

The following is an example of an ADBMobileConfig.json file:

    "version" : "1.0",
    "analytics" : {
        "rsids" : "coolApp",
        "server" : "",
        "charset" : "UTF-8",
        "ssl" : false,
        "offlineEnabled" : true,
        "lifecycleTimeout" : 5,
        "privacyDefault" : "optedin",

At a minimum, update the rsids and server parameters.

For more details, see ADBMobileConfig.json Config File Reference.

That's it! You're now ready to implement Analytics in your BlackBerry 10 app.

Where to go from here: