Using the Android Shell Example
This procedure assumes that you have downloaded Android Studio and built and run one of the other example applications. To use the android-shell example, follow these steps:
1. Assuming that you already have a project open, select > .
2. If prompted, select android-shell, and then select Gradle project to import.
3. If prompted, use gradlew, which is provided in the examples directory.
4. During this process, you may be asked to install or choose an Android SDK version. This project targets Android SDK 5.1, also called API 22. The project should import cleanly and be ready to use.
5. In ThingWorx Composer, import the entity file, examples/android-shell/entity/Things_AndroidSampleThing.xml. In Composer, you should see an AndroidSampleThing that this example updates.
6. In Android Studio, select > to start the application.
7. In the application, choose the Launch Emulator option and click the ellipsis button (...).
8. Select the Create Virtual Device button on the bottom of the next window.
9. Choose a device from the list. If given the option, choose an x86 device over an ARM device to get better performance, If you do not have any x86 choices, consider clicking the Show downloadable images button to find one. The shell application should start in the simulator.
10. If the application is starting for the first time, the settings page appears. You must provide the following information:
◦ A URI of the form ws://hostname:8080/Thingworx/WS for HTTP access.
◦ A URI of the form wss://hostname:443/Thingworx/WS for HTTPS access.
◦ An Application Key (appKey) that has been generated on your ThingWorx platform in the Application Keys section of ThingWorx Composer.
 |
You can also build the application from the command line, as explained in Building an Example Project from the Command Line.
|
Using the Shell Application as a Starting Point for Your Application
The Shell example is intended to act as the simplest possible starting point for your own application. Every effort has been made to move all of the ThingWorx platform Edge functionality into the ThingworxActivity class so that it can be re-used as a base class for your own activity. If you re-use this class as a base class, your application will have basic ThingWorx functionality. This class has a minimum set of custom resources and can be easily copied for you to use as your starting point for your new project.