Skip to content

An Eclipse plugin to deploy ThingWorx extensions directly to ThingWorx server from Eclipse IDE

Notifications You must be signed in to change notification settings

WGLabz/ThingWorxExtensionUploader

Repository files navigation

ThingWorx Extension Uploader, an Eclipse Plugin

An open-source tool to auto-upgrade, build, and upload ThingWorx extensions from the Eclipse IDE



ThingWorx Extension Uploader



Features

If you are using this plugin, make sure your project is set to build with Ant, not Gradle. Gradle is not supported yet. Additionally, the default build file name build-extension.xml should not be changed.

  • The plugin automatically increments the patch version of the extension with each run. For example, if the current version is 1.0.8, it will increment to 1.0.9. This is essential because ThingWorx only allows the import of incremental versions of any extension. If you want to update the major or minor version, need to do it manually.
  • The plugin executes the build file and generates a .zip distribution of the extension.
  • It then uploads the extension to a configured ThingWorx server using HTTP REST APIs. An Admin-level APP Key is required for this process.

How to Use


Download the .jar file from the release page and place it into the dropins folder of your Eclipse IDE.

ThingWorx Extension Uploader

Restart Eclipse IDE. Once restarted, you'll see a new icon in the toolbar of your IDE.

ThingWorx Extension Uploader

You can now use the plugin. When you click the icon, the following dialog will appear:

ThingWorx Extension Uploader

In the dialog, select the extension project, set the server address, and add an appKey with Admin-level access. Be sure to click "Update TWX details" to save the details for future use.

Note: Ensure that you have compiled your extension outside of this plugin at least once and refreshed the project content. This is a known bug that I am working on. Otherwise, you will receive the following error:

ThingWorx Extension Uploader Error

If everything goes well when you click "OK", you will receive a success message, and the extension will be deployed to the server.

ThingWorx Extension Uploader Success

How to Build

To be continued...

License

Distributed under the AGPLv3 License. See LICENSE.md for more information.


About

An Eclipse plugin to deploy ThingWorx extensions directly to ThingWorx server from Eclipse IDE

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages