Would you like to tell us how we are doing?

You bet No thanks

BlackBerry Plug-in for Android Studio

Before you begin:

Make sure that you have the latest version of Android Studio and the BlackBerry Plug-in for Android Studio.

Installing Android Studio

For information about Android Studio, along with installation instructions, see Installing Android Studio.

Install the BlackBerry Plug-in for Android Studio

Before following the instructions in this section, make sure that you have the Android Studio correctly installed and configured on your computer.

There is a known installation issue with the Mac OS or Linux. You must extract the BlackBerry Plug-in for Android Studio zip file directly to <your_android_studio_installation_folder>\plugins folder.

  1. Download the BlackBerry Plug-in for Android Studio.
  2. Open your project in Android Studio.
  3. On the File menu, click Settings.
    Screen showing the Settings menu choice from the File menu.
  4. In the Android Studio Settings dialog box, select Plugins from the navigation list on the left.
  5. Click Install plugin from disk.
    Screen showing the Install plugin from disk button in the Settings dialog box.
  6. Select the location of the zip file containing the BlackBerry Plug-in for Android Studio.
  7. Click Apply.

You must restart Android Studio for your changes to take effect. After Android Studio restarts, the BlackBerry ADB Proxy Manager icon appears in the main toolbar. The BlackBerry ADB Proxy Manager manages connections to the Android Debug Bridge (ADB).

Screen showing the BlackBerry 10 ADB Proxy Manager icon in the main toolbar.
After you finish:

After you install the plugin, you should verify that Android Studio has successfully installed the Android SDK required for your app.

To verify that the required Android SDK (API level) for your app has been installed:

  1. Start Android Studio.
  2. On the Tools menu, click Android and then click SDK Manager.
  3. In the SDK Manager dialog box, verify that the required Android SDK (API level) for your app has a Status of 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 Android Studio

  1. Connect your device to your computer with a USB cable, or start the BlackBerry 10 Device Simulator.
  2. Open your project in Android Studio.
  3. Click the BlackBerry icon to start the BlackBerry ADB Proxy Manager.
    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 your device or simulator has connected 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