Step 4.1: Install the software

You must have the following software components in order to start developing Android applications for ConnectCore 6:

1. Java SE Development Kit 7 (JDK 7)

2. Android Studio

3. Digi Extensions for Android Studio

4. SDK Add-on for ConnectCore 6

5. Google USB driver

If you already have Android Studio 2.0 or later in your computer, you can skip the first two installation steps.

1. Java SE Development Kit 7 (JDK 7)

Before you set up Android Studio, be sure you have installed JDK 7 or later. The Java Runtime Environment (JRE) alone is not sufficient.

For Linux users:

We recommend the Java OpenJDK-7 package. Depending on your distribution, you can install this package in two ways:

For Windows users:

  1. Check if you already have JDK 7 or later installed on your computer. If you do, you can skip this step.
  2. If the JDK is not installed or the version is not 7 or later:
    1. Download the Java SE Development Kit 7 at www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
    2. Once the download is complete, run the executable file and follow the on-screen instructions to finish the installation process.

2. Android Studio

Android Studio provides everything you need to start developing apps for Android. Digi Embedded for Android has been validated with Android Studio 2.2.3, although newer versions should also work.

To download and install Android Studio on your computer:

  1. Download Android Studio at http://developer.android.com/sdk/index.html.
  2. Follow the steps for installing Android Studio at https://developer.android.com/sdk/installing/index.html?pkg=studio.

3. Digi Extensions for Android Studio

To download and install the Digi Extensions on your Android Studio:

  1. Open Android Studio.
  2. Open the Android Studio Settings dialog by doing one of the following: 
    • Select Configure > Settings on the Welcome screen.

    • Select File > Settings from the menu.

  3. Select Plugins from the tree on the left of the Settings dialog.

Note You can also access the Plugins dialog from the Welcome screen. Click Configure on the Quick Start panel and then click Plugins.

  1. Click Browse repositories at the bottom of the page.
  2. In the Browse Repositories dialog, select Digi Extensions for Android Studio from the list on the left. You can use the search box to look for the plugin.

  3. Click Install plugin on the right panel.
  4. A dialog is displayed asking whether you would like to download and install the plugin Digi Extensions for Android Studio. Click Yes.

    A dialog displays the progress of the download process.

  5. Once the download process finishes, click Close in the Browse Repositories dialog.
  6. Click OK to close the Plugins dialog.
  7. When a message appears asking you to restart, click Restart to activate the plugin.

4. SDK Add-on for ConnectCore 6

You are now ready to start developing Android applications. The Get started section provides an initial tutorial, while the Application development section gives you everything you need to start using the Digi APIX for Android extensions to create more advanced apps.

  1. On the Android Studio Welcome screen, click Configure on the Quick Start panel and then click SDK Manager.
  2. Click the Launch Standalone SDK Manager link at the bottom of the list. The SDK Manager dialog opens.

  3. Click Deselect All to uncheck any previously selected package from the list.

  4. Select Tools > Manage Add-on Sites from the main menu of the application.

    A new configuration window opens.

  5. Select the User Defined Sites tab and click the New button to add a new add-on site.

  6. Enter the following URL for the new add-on site: http://ftp1.digi.com/support/android/sdk_addon/addon.xml
  7. Click OK and then close the Add-on Sites configuration dialog. A new package named SDK Add-On for ConnectCore 6 appears under Android 5.1.1 (API 22).

  8. Select the new package and click Install 1 package.
  9. Accept the License Agreement and click Install.
  10. Once installation is complete, close the SDK Manager.
  11. Restart Android Studio.

You are now ready to develop Android applications using the Digi APIX for Android.

5. Google USB driver

You need the Google USB Driver for Windows if you want to perform adb (Android Debug Bridge) debugging with your ConnectCore device.

  1. Download the Google USB driver at http://developer.android.com/sdk/win-usb.html.
  2. Once you have downloaded the USB driver, perform the following instructions to install it, based on your Windows version: