Would you like to tell us how we are doing?

You bet No thanks

BlackBerry Plug-in for Android Development Tools for Eclipse

Before you begin:

Before you install the BlackBerry Plug-in for Android Development Tools for Eclipse, make sure that you have:

  • Eclipse (Luna) version 4.4 for Windows (or Cocoa 32 for Mac OS X)
  • The Android SDK
  • The latest version of the Android Development Tools installed on your computer

These items can be downloaded separately, or together in the Android SDK ADT bundle.

For more information on how to install and configure each of the above items, see Items required for the BlackBerry Plug-in for Android Development Tools for Eclipse.

Install the BlackBerry Plug-in

  1. Start Eclipse.
  2. On the Help menu, click Install New Software
  3. Click Add to add a new software site.
  4. In the Name field, enter BlackBerry Plug-in for Android Development Tools.
  5. In the Location field, enter http://developer.blackberry.com/android/downloads/eclipseplugin/.
  6. Click OK.
  7. In the Install window, select the BlackBerry Eclipse Plugin for Android Development check box, and also select the check boxes for the subitems under it.
  8. Click Next. If you don't have the ADT Plug-in installed on your computer, the newest version of the plug-in is installed.
  9. Complete the instructions in the Review Licenses window.
  10. Click Finish.

After you finish:

After you install the plug-in, you should verify that the installation has successfully located the Android SDK in the plug-in preferences.

Verify the installation of the plug-in

  1. Start Eclipse.
  2. On the Window menu, click Preferences.
  3. Expand Android.
  4. Verify that the path shown in the SDK location field matches the location of your Android SDK installation folder.
  5. Verify that all the APIs that your app requires are installed correctly in Eclipse.
    1. On the Window menu, click Android SDK Manager.
    2. In the Packages section for each of the APIs that your app requires, verify that the status is Installed.

The maximum API level supported is Android 4.3 (API 18).

The BlackBerry ADB Proxy Manager

The BlackBerry Android Device Bridge (ADB) Proxy Manager is added when you install the BlackBerry Plug-in. It displays all of your connected BlackBerry devices and simulators.

The BlackBerry ADB Proxy Manager.

You can use the BlackBerry ADB Proxy Manager to:

  • Establish an ADB connection between your IDE and your BlackBerry 10 device or BlackBerry 10 Device Simulator
  • Generate a device debug token and deploy it to your BlackBerry 10 device

Use the BlackBerry ADB Proxy Manager in Eclipse

  1. Connect your BlackBerry 10 device to your computer with a USB cable or start the BlackBerry 10 Device Simulator.
  2. Start Eclipse.
  3. Start the BlackBerry ADB Proxy Manager by clicking BlackBerry icon on the Tools menu.
    The icon to start the BlackBerry ADB Proxy Manager.
  4. In the BlackBerry ADB Proxy Manager, click the start button to use your BlackBerry 10 device or BlackBerry 10 Device Simulator with the BlackBerry ADB Proxy Manager.
    The start button for the BlackBerry ADB Proxy Manager.
  5. After the device or simulator connects to the BlackBerry ADB Proxy Manager, you can run or debug your Android app.
  6. When you're done working with your Android app, click the stop button to disconnect your device or simulator from the BlackBerry ADB Proxy Manager.
    The stop button for the BlackBerry ADB Proxy Manager.

Create and deploy a device debug token

A device debug token allows you to deploy and debug an unsigned Android app on your BlackBerry 10 device. You don't need a device debug token when you're using the BlackBerry 10 Device Simulator to test and debug your Android apps.

For more information, see the BlackBerry 10 Simulator Documentation.

Before you begin testing, see Getting started.

You must Create a BlackBerry ID Signing token and Developer certificate before you can test and debug your Android app on a BlackBerry 10 device.

When you have a BlackBerry ID Signing token and Developer certificate configured, you can connect a BlackBerry device that doesn't contain a device debug token and use the BlackBerry ADB Proxy Manager to create a new device debug token.

Follow these steps to create and deploy a device debug token:

  1. Enable Development Mode on your BlackBerry 10 device. For more information, see Set up your test environment.
  2. Connect your BlackBerry 10 device to your computer with a USB cable.
  3. Open your project in your IDE.
  4. Click The BlackBerry icon. on the main toolbar to start the BlackBerry ADB Proxy Manager.

    In the BlackBerry ADB Proxy Manager, when you try to start a BlackBerry 10 device that doesn't have a device debug token, the Missing Debug Token message appears in the Status column. A dialog box that begins the process of creating a device debug token is displayed.

    The BlackBerry ADB Proxy Manager debug token missing message.
  5. In the Confirmation dialog box, click Yes.

    Dialog box asking to create and upload a device debug token.
  6. In the BlackBerry Debug Token Request dialog box, click Deploy Debug Token.The BlackBerry Debug Token Request dialog box.
  7. In the Password Prompt dialog box, enter your BlackBerry ID Signing token password and click OK.

    The CSK password dialog box.

    For more information, see Create a BlackBerry ID Signing token.

    The new device debug token is created and deployed (uploaded) to your BlackBerry 10 device.

    The messages generated as the device debug token is created and deployed.

After you've created and deployed the device debug token, start your BlackBerry 10 device in the BlackBerry ADB Proxy Manager.

The start button for the BlackBerry ADB Proxy Manager.


Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus