Prepare Your Device to Use the Android Client Software Libraries

A device must be configured correctly and meet the minimum hardware requirements to successfully install the Android client software libraries.

  1. Make sure the hardware prerequisites are met before you install the Android client libraries on your device. For a list of supported platforms, see Oracle IoT Cloud Service Client Software Certified System Configurations.
  2. Verify device registration:
    1. Open the Oracle Fusion Cloud IoT Intelligent Applications management console.
    2. Click the Menu (Menu icon) icon.
    3. Click Devices and then Management.
    4. Select a device in the device list, or use the Property and Value fields to search for a device.
    5. Confirm Registered is displayed in the State column.
  3. Confirm the location of your Android software development kit (SDK). Typically, it is located at this path: C:\users\user-name\AppData\Local\Android\sdk.
  4. Set the path for the Android SDK:
    1. Browse to C:\Users\user-name\Documents\iotcs\csl\<version>\android\samples.
    2. Open the local.properties file in a source code editor.
    3. Enter the Android SDK path as the sdk.dir property value.
    4. Enter the user name used to access the Android device as the user-name property value.
    5. Save and close the local.properties file.
  5. Browse to C:\Users\user-name\Documents\iotcs\csl\<version>\android\lib and make sure the device-library.aar and enterprise-library.aar files are in the folder.
  6. Set the device-library.aar path in the build.gradle file:
    1. Browse to C:\Users\user-name\Documents\iotcs\csl\android\samples\dcd\app.
    2. Open the build.gradle file in a source code editor.
    3. Confirm the path for the flatDir property value is correct.
    4. Save and close the build.gradle file.
  7. Set the Android SDK version in the build files:
    1. Browse to C:\Users\user-name\AppData\Local\Android\sdk\build-tools.
    2. Record the Android SDK version.
    3. Browse to C:\Users\user-name\Documents\iotcs\csl\<version>\android\samples.
    4. Open the local.properties file in a source code editor.
    5. Enter the installed Android SDK version as the androidBuildToolsVersion property value.
    6. Save and close the local.properties file.
    7. Browse to C:\Users\user-name\Documents\iotcs\csl\<version>\android\samples\dcd\app.
    8. Open the build.gradle file in a source code editor.
    9. Enter the installed Android SDK version as the buildToolsVersion property value.
    10. Save and close the build.gradle file.