Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

In terms of the end product, a module is a *.modl* file that is loaded into the gateway. That file, in reality, is simply a zip file containing all of the module's code ( *\*.jar* files) and a required manifest file that describes it.  Historically, Modules being uploaded to the Inductive Automation [Module Marketplace]( were required to have a license file and module documentation.  Each module was cryptographically signed in order to prevent unauthorized tampering, and Ignition would only load valid signed modules into the platform (except when in development mode).  As of Ignition 7.8, self-signing is possible.

In regards to code, a module can be made up of any number of projects that are compiled into one or more JAR files. Somewhere in the code there will be "hook" classes defined that allow Ignition access to the module.  In addition to the module code, the JAR files might also contain resources such as images, and resource bundle files for localization.   As you go through this guide, you'll get an idea of how to structure and build your *.modl*. 
## Contents of a *.modl* File

The module package file will contain the compiled JARs for your module, the descriptor file, and optionally a license file and documentation for the module.  The Ignition platform will load the module, locate the hooks, and start them up. Additional resources, such as images, should be compiled into the JAR files, and not included directly in the module package (with the exception of the "doc/" folder).  This is all started from the descriptor file (also called the *module.xml*) built into the *.modl*, which we'll take a look at next.