This tutorial demonstrates how to develop and launch your first Android application in the device. The application allows you to blink a device LED on and off.

Before creating your project, make sure your device is correctly connected, powered, and running. Once your device is ready for development, follow these steps:

  1. Install the software

  2. Create the Android application

  3. Launch the Android application

  4. Test the Android application

1. Install the software

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

  1. Android Studio

  2. Digi Extensions for Android Studio

  3. SDK Add-on

  4. Google USB driver

If you already have Android Studio 2020.3.1 or later in your computer, you can skip the first two installation steps and go directly to Digi Extensions for Android Studio.

1.1. Android Studio

Android Studio provides everything you need to start developing apps for Android.

To download and install Android Studio on your computer:

  1. Download the latest Android Studio at http://developer.android.com/sdk/index.html.

  2. Follow the steps for installing Android Studio at https://developer.android.com/studio/install.

Digi Embedded for Android has been validated with Android Studio 2020.3.1, although newer versions should also work. You can download this version from https://developer.android.com/studio/archive.

1.2. Digi Extensions for Android Studio

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

  1. Open Android Studio.

  2. Open the Plugins dialog by doing one of the following:

    • Select Plugins on the Welcome screen.

      Dialog Settings Welcome

    • Or open the Settings dialog:

      1. Select File > Settings from the menu.

        Dialog Setting Menu

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

  3. Click Marketplace tab at the top of the page.

  4. In the Search box field, type Digi and press Enter. The Digi Extensions for Android Studio plugin should be listed:

    Dialog Marketplace

  5. Click Install button below the plugin description.

  6. Once the install process finishes, click Restart IDE button to activate the plugin. Or close the IDE.

  7. When a message appears asking you to restart, click Restart .

1.3. SDK Add-on

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 to create more advanced apps.

  1. On the Android Studio Welcome screen, click Customize on the Quick Start panel and then All settings.

  2. Then click SDK Manager located inside Appearance & Behavior > System Settings. The SDK Manager dialog opens.

    SDK manager

  3. Select the SDK Update Sites tab and click the + button at the right to add a new add-on site.

    User Defined Sites

  4. Enter a name for the new add-on site and use the following URL: http://ftp1.digi.com/support/android/sdk_addon/11.0/addon.xml

    Add update site

  5. Click OK.

  6. Go back to the SDK Platforms tab and click Apply.

  7. Check Show Package Details to expand and list all the available Android packages for each version. A new package named Digi SDK Add-on for Embedded appears under Android 11.0 (R).

    Digi SDK Add-on for Embedded

  8. Check the new package and click Apply.

    Make sure you have also checked Android SDK Platform 30 under Android 11.0 (R) as it is required to build applications for the Android target platform.

  9. A confirmation dialog appears listing the packages that will be installed. Click OK.

  10. Accept the License Agreement and click Install.

  11. Once installation is complete, click Finish and close the SDK Manager.

  12. Restart Android Studio.

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

To uninstall the add-on in the future, please read the Uninstall the Digi SDK Add-on for Embedded topic.

1.4. Google USB driver

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

  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:

If you are developing with a Linux workstation this is not required.

Windows 7 or later

To install the Google USB driver on Windows 7 or later for the first time:

  1. Unzip the downloaded file.

  2. Connect your Android-powered device to your computer’s USB port.

  3. Right-click on Computer from your desktop or Windows Explorer, and select Manage.

  4. Select Device Manager in the left pane of the Computer Management window.

  5. Locate and expand Other device in the right pane.

  6. Right-click the device name and select Update Driver Software to launch the Update Driver Software wizard.

  7. Select Browse my computer for driver software and click Next.

  8. Click Browse and locate the USB driver folder, called usb_driver, which appears after you decompress the downloaded file.

  9. Click Next to install the driver.

Windows Vista

To install the Google USB driver on Windows Vista for the first time:

  1. Unzip the downloaded file.

  2. Connect your Android-powered device to your computer’s USB port. Windows detects the device and launches the Found New Hardware wizard.

  3. Select Locate and install driver software.

  4. Select Don’t search online.

  5. Select I don’t have the disk. Show me other options.

  6. Select Browse my computer for driver software.

  7. Click Browse and locate the USB driver folder, called usb_driver, which appears after you decompress the downloaded file.

  8. Click Next. Vista may prompt you to confirm the privilege elevation required for driver installation. Confirm it.

  9. When Vista asks if you’d like to install the Google ADB Interface device, click Install to install the driver.

2. Create the Android application

  1. Open Android Studio.

  2. Open the Import Digi Sample wizard by doing one of the following:

    • Select More Actions > Import a Digi Android code sample on the Welcome screen.

      Import a Digi Code Sample

    • Select File > New > Import Digi Sample from the menu.

      Import sample menu

  3. On the Browse Samples page of the wizard, select the Getting Started Sample Application under Digi samples.

    Then click Next.

    Import Sample Wizard Step 1

  4. In the Project location field of the Sample Setup page of the wizard, specify the path where you want to download the sources of the application.

    Import Sample Wizard Step 2

  5. Click Finish to create the sample application. A new Android Studio window opens with the Getting Started Sample Application project.

    Sample applications are configured to use a specific version of the Gradle plugin that has been validated. New versions of Android Studio may ask you to update sample applications to the latest Gradle plugin. Doing so will cause sample applications to stop building properly. Digi recommends you do not update sample applications to the latest Gradle plugin.

    Update gradle plugin

Android Studio does not automatically update examples to the latest version. Examples may need to be modified to work with newer versions of Android Studio than the one tested with this release.

By default, all sample applications are configured to run with the latest released version of the Digi SDK Add-on for Embedded. If you are using an Android version different than the latest released one, you might need to properly configure the sample application before running it in your platform. To do so, follow these steps:

  1. Edit the app/build.gradle file and set Digi International:Digi SDK Add-on for Embedded:30 as compileSdkVersion value: image

  2. Save the changes and let Android Studio sync the project again.

3. Launch the Android application

Once you have created the project, you can launch it in your Android device:

  1. Disconnect the micro USB cable from the USB recovery of the board if connected.

  2. Connect the micro USB cable to the USB Host connector (next to the microSD socket) of the board.

  3. Ensure the device has developer and debugging options enabled. See Enable developer options and debugging for more information.

  4. Select Run > Run 'app'.

  5. If the Device Chooser dialog opens, select your device and click OK.

    If your device appears as Unauthorized in the Device Chooser dialog, go to your Android device. A dialog shows up on your device, presenting an RSA key for your computer and asking for confirmation to accept the connection.

    Select Always allow from this computer and click OK.

    After accepting your computer RSA key, the device state changes to Online in the Device Chooser dialog.

    The application automatically transfers and launches in the Android device through the USB connection. The progress of the launch process is displayed in the Run view:

    Run View

  6. You can review the adb and device log messages from the logcat tab:

    logcat tab

4. Test the Android application

You can test the Getting Started Sample application in the Android device by blinking the User LED on and off to configure its period.

image

You have successfully created and executed an Android application in your device. As you can see, the process is the same as with any other standard Android device.

Now you can develop more applications with Android Studio using Digi APIs to access the hardware interfaces available in your device, such as the SPI, I2C, ADC, and CAN.

To meet all your project requirements, Digi also lets you customize Android to create your own firmware images from the source code.