ThingWorx Edge Android SDK > Installing and Navigating the Directories of the SDK
Installing and Navigating the Directories of the SDK
To install the ThingWorx Edge Android SDK, download the SDK bundle to your computer, and extract the files.
Once you have extracted the files, you should see the following directories under ThingWorx-Android-SDK-v.v.b (where v.v.b are the version and build numbers for the SDK):
docs — Contains this document as well as the ThingWorx Edge Java SDK Developer’s Guide and release notes.
javadoc — Contains the Javadoc for the Android SDK. To view the Javadoc in a browser, extract the content of the file, thingworx-android-sdk-v.v.b–javadoc.jar, and open the file, help-doc.html. You can also view the Javadoc from within the Android Studio IDE.
lib — Contains the libraries for this SDK:
thingworx-android-sdk-v.v.b.aar, where v.v.b represent the version and build number of this SDK.
thingworx-common-v.v.v–b.jar, where v.v.v.b represent the version and build number of this jar file.
thingworx-communications-client-v.v.v–b.jar, where v.v.v.b represent the version and build number of this jar file.
samples — Contains the sample applications:
android-file-browser — An example application that shows how to set up file browsing.
android-shell — An example that serves as a shell in which you can create your own application.
android-steam-thing — The ThingWorx Edge Steam Thing example, implemented as an Android application
The Android Steam Thing example can be imported into Android Studio and then built and run from the IDE. This example can also be built from the command line, using Gradle ( You can also import the other examples into Android Studio. Consult the files in the each of the example directories for instructions on using these projects in Android Studio.
The top-level directory also contains the following files:
version.txt — This file provides the version number of the Android SDK. If you need to call PTC Technical Support, you will need to provide the information in this file. For example:
Thingworx Android SDK version 1.0.b4 Based on ThingWorx platform version 7.0.0.b65
In addition to the jar files in the lib directory, the Android SDK is also dependent on the following jar files:
These dependent jars are managed by Gradle and are not provided by this SDK.
If you prefer to build the Steam Sensor example from the command line, see the section, Building an Example Project from the Command Line.
Android Studio
The samples provided with the ThingWorx Edge Android SDK were developed using Android Studio. It is recommended that you use Android Studio for your projects. To obtain this tool, visit
Once you have installed Android Studio, follow these steps when you open it for the first time:
1. When you start Android Studio for the very first time, it displays a dialog box with an option to Import Project. If you already have a project open, choose File>New..>Import Project.... No matter how you access the Import dialog box, once there, choose the root directory where you have installed the ThingWorx Edge Android SDK.
2. Once the import process completes, you are ready to use the SDK in Android Studio. If prompted at any time whether to use gradlew for builds, accept this choice. Depending on which version of Android Studio you have, you may be asked this question.
3. If asked which version of the Google Android SDK to use, choose API 19 or higher. The percentage of developers using a version of the API is shown with the version number. Select the version based on the needs of your target audience or customer for your application.