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 installing Android Studio, see Installing Android Studio.

Install the BlackBerry Plug-in for Android Studio

Before you begin, make sure that you have the Android Studio correctly installed and configured on your computer.

There is an alternate way to install the plug-in on the Mac OS or Linux. You can 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.
    The Settings menu choice from the File menu.
  4. Select Plug-ins from the navigation list on the left.
  5. Click Install plugin from disk.
    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).

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

After you install the plug-in, 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. 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 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

Using the BlackBerry ADB Proxy Manager in Android Studio

  1. Connect your BlackBerry 10 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.
    The icon to start the BlackBerry ADB Proxy Manager.
  4. 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 your device or simulator has connected to the BlackBerry ADB Proxy Manager, run or debug your Android app.

Disconnecting the BlackBerry ADB Proxy Manager

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