Would you like to tell us how we are doing?

You bet No thanks

Eclipse Plug-in for Android Development Tools

Before you begin:

Before you try to install the BlackBerry Plug-in, make sure that you have Eclipse version 4.2.2 for Windows (or Cocoa 32 for Mac OS X), the Android SDK, and the latest version of the Android Development Tools installed on your computer.

These prerequisites are available in separate downloads, or in the Android SDK ADT bundle download. For more information, see Items required for the Eclipse BlackBerry Plug-in.

To install the BlackBerry Plug-in for Android Development Tools:

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

After you finish:

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

To verify that the installation has successfully located the plugin:

  1. Start Eclipse.
  2. On the Window menu, click Preferences, and then click Android.
  3. Verify that the path shown in the SDK location field matches the location of your Android SDK installation folder.
  4. 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, verify that the status of all the APIs that your app requires are displayed as 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 displays all of your connected BlackBerry devices and simulators.

Screen showing the BlackBerry ADB Proxy Manager dialog box.

You can use the BlackBerry ADB Proxy Manager to:

  • Display a connected device or BlackBerry 10 Device Simulator.
  • Test and debug your Android app on a device or BlackBerry 10 Device Simulator.
  • Check command support in the Android Device Bridge (ADB). Supported commands are forwarded to the ADB. The BlackBerry ADB Proxy Manager handles unsupported commands.
  • Generate and deploy debug tokens to devices.

Using the BlackBerry ADB Proxy Manager in Eclipse

  1. Connect your device to your computer with a USB cable or start the BlackBerry 10 Device Simulator.
  2. Start the Eclipse IDE.
  3. To start the BlackBerry ADB Proxy Manager, click the BlackBerry icon icon on the Tools menu.
    Screen showing the icon to start the BlackBerry ADB Proxy Manager.
  4. In the BlackBerry ADB Proxy Manager, click the start button to use your device or BlackBerry 10 Device Simulator with the BlackBerry ADB Proxy Manager.
    Screen showing 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.
    Screen showing the stop button for the BlackBerry ADB Proxy Manager.

Create and deploy a debug token

A debug token allows you to test and debug your Android app on a BlackBerry 10 device. YOu don't need a 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.

Before you can test and debug your Android app on a BlackBerry 10 device, you must create a BlackBerry ID token, and a developer certificate. When you have these items, you can use the BlackBerry ADB Proxy Manager to automatically create a debug token and deploy (upload) it to your device.

When you connect a device that doesn't contain a debug token, the BlackBerry ADB Proxy Manager automatically lets you create a debug token.

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

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

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

    Screen showing the BlackBerry ADB Proxy Manager debug token missing message.
  5. Click Yes in the Confirmation dialog box.

    Screen asking to create and upload a debug token.
  6. In the BlackBerry Debug Token Request dialog box, click Deploy Debug Token.Screen showing the BlackBerry Debug Token Request dialog box.
  7. In the Password Prompt dialog box, enter your CSK password and click OK.

    Screen showing the CSK password dialog box.

    For more information, see Create a BlackBerry ID token.

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

    Screen showing the messages generated as the debug token is created and deployed.

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

Screen showing 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