Set Up Your Development Environment to Use the Android Client Software Libraries

Before you can develop applications that let your devices communicate with Oracle Internet of Things Cloud Service, you first download, install, and configure the Android client software libraries.

  1. Register your device, record the password, and download the provisioning file.
  2. Upload the humidity and temperature sensor device models to Oracle Internet of Things Cloud Service. See Upload the Sample Device Models.
  3. Download and install Gradle. Versions 4.0.1 to 4.10.3 are supported.
  4. Download and install Java SE Development Kit (JDK) 8.0 or later.
  5. Download and install Android Studio.
  6. Open a web browser and browse to the Oracle Internet of Things Cloud Service client software libraries download site.
  7. Scroll to Android Client Software Library and download the Binaries, Source Code and Samples zip files from the Android Client Software Library table.
  8. Extract the contents of the zip files. The files are saved to these directories:
    Filename Directory
    iotcs-csl-android-bin-<version>.zip iotcs/csl/android/bin
    iotcs-csl-android-src-<version>.zip iotcs/csl/android/src
    iotcs-csl-android-samples-<version>.zip iotcs/csl/android/samples
  9. Create a new application named AndroidELAppln. See Creating a New Application.
  10. Associate the humidity and temperature sensor device models with the AndroidELAppln application.
  11. Add an integration named EnterpriseClientSample to the application. See Integrating Enterprise Applications with Oracle IoT Cloud Service.
  12. Download the provisioning file for the EnterpriseClientSample integration:
    1. Log in to your Oracle Internet of Things Cloud Service instance.
    2. Click the Menu (Menu icon) icon next to the Oracle Internet of Things Cloud Service title on the Management Console.
    3. Click Applications and then Browse Applications.
    4. Click AndroidELAppln and then Integration.
    5. Select the EnterpriseClientSample integration and click the Edit (Edit icon) icon.
    6. Click the Overview tab.
      If you are using Oracle Internet of Things Cloud Service version 16 4.1 or earlier, record the ID and Shared Secret values. These values are required when you run the provisioning tool to create the trusted assets store.
    7. Enter a password in the File Protection Password field to encrypt the provisioning file that contains the credentials required to activate your integration.
    8. Enter the password again in the Confirm Password field.
    9. Click Download Provisioning File.
    10. Click Save File.
    11. Browse to a directory and then click Save.
  13. Prepare your device to run the Android client software libraries. See Prepare Your Device to Use the Android Client Software Libraries.
  14. Run the sample applications.