Show Menu
TOPICS×

Developer quick start

This information helps you understand the process to implement the BlackBerry library.

Get the SDK

The SDK requires BlackBerry 10 or later.
After unzipping the downloaded SDK, verify that the following files exist in an AdobeMobile folder:
  • Device-Coverage/libADBMobileShared.so
  • Device-Debug/libADBMobileShared.so
  • Device-Profile/libADBMobileShared.so
  • Device-Release/libADBMobileShared.so
  • public/ADBMediaAnalytics.hpp
  • public/ADBMediaSharedHeader.hpp
  • public/ADBMediaState.hpp
  • public/ADBMobile.hpp
  • Simulator-Coverage/libADBMobileShared.so
  • Simulator-Debug/libADBMobileShared.so
  • Simulator-Profile/libADBMobileShared.so

Add the SDKs 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 the Device library field.
  4. Navigate to the ADBMobile-4.0.0BETA-BlackBerry folder.
  5. In the Device-Debug folder, select libADBMobileShared.so and click Open .
  6. Click Browse next to the Simulator library field.
  7. Navigate to the ADBMobile-4.0.0BETA-BlackBerry folder.
  8. In the Device-Debug folder, select libADBMobileShared.so and click Open .
  9. Click Add next to the Include 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.
    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 Workspace .
  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, select the Internet box on 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" : "my.CoolApp.com",
        "charset" : "UTF-8",
        "ssl" : true,
        "offlineEnabled" : true,
        "lifecycleTimeout" : 5,
        "privacyDefault" : "optedin",
    }
}

You must at least update the rsids and server parameters. For more details, see Adobe Mobile class and method reference .
You can now implement Analytics in your BlackBerry 10 app.