Create A Mashup Widget Extension

Guide Concept

Extensions enable you to quickly and easily add new functionality to an IoT solution. Mashup widget extensions can be utilized to enhance a user's experience, your ability to develop robust applications, and make development easier as you move forward with your IoT development.

The Eclipse Plugin for ThingWorx Extension Development (Eclipse Plugin) is designed to streamline and enhance the creation of extensions for the ThingWorx Platform. The plugin makes it easier to develop and build extensions by automatically generating source files, annotations, and methods as well as updating the metadata file to ensure the extension can be imported.

These features allow you to focus on developing functionality in your extension, rather than spend unnecessary time getting the syntax and format of annotations and the metadata file correct.

Guide Info

Level	Intermediate
Est. Time	60 Minutes
Published	March 21, 2019
Author	Jason Johnson

Build

You'll learn how to

Utilized the Eclipse Plugin and Extension SDK
Create and configure an extension project
Create A mashup widget extension
Build and import an extension

Things used in this guide

Environment:

This guide may be completed in any environment that has access to the ThingWorx Foundation server.

This includes both the hosted evaluation server, as well as the downloadable trial.

Before you start, ensure you have the following software installed.

Download Java Development Kit: jdk1.8.
Download Eclipse Mars (4.5) for Java Developers.

Completed Example:
You are provided a complete example to use as a reference as you progress through this guide and for more insight into how steps are completed.

NOTE: If you use Gradle as the build tool, in your Eclipse application, download the Gradle STS IDE plugin from Help->Eclipse Marketplace, then restart your workspace.

Software components:

ThingWorx Foundation

Previous knowledge:

Java SDK Tutorial

Outline

Step 1: Completed Example
Step 2: Create Mashup Widget Extension Project
Step 3: Widget Lifecycle in the Mashup Builder
Step 4: Widget Coding Examples
Step 5: Mashup Builder API
Step 6: Mashup Builder Callbacks
Step 7: Widget Lifecycle at Runtime
Step 8: Runtime APIs Available to Widgets
Step 9: Runtime Callbacks
Step 10: Building and Importing
Step 11: Tips
Step 12: Next Steps