Versions Compared


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


We don't force any specific tooling on module developers.  It's possible to build a module completely from a text editor if you want!  That said, we do highly recommend utilizing some sort of version control at a minimum.  In addition, most Java developers find their work can be eased quite a bit with the use of a modern Integrated Development Environment.  The three most popular IDE's  (IntelliJ,Eclipse and Netbeans) all have support for Maven and can make it easier to resolve dependency and import issues 'on the fly'.  They also all provide some way to create a new empty Maven projects, or create projects from archetypes which provide a useful starting structure.  If you prefer to stick with simpler editors but want a quick start,  you can clone our example repo and use any of the projects there to begin.  

## Quick Starts with Archetypes

The fastest way to get started with a new Ignition module is to use a Maven Archetype.  An archetype is a pre-made structural framework for a Maven project.  By creating your new module from an archetype, you let us handle a lot of the laborious setup process for you.  Your new module will have directories in place, be configured to use the `ignition-maven-plugin` described below, and will be ready for you to start adding your own source.  To get started with an archetype, you just need to make sure you have Maven installed.  With Maven installed, creating a new module project is as easy as entering this at your command-line:
mvn archetype:generate -DarchetypeGroupId=com.inductiveautomation.ignitionsdk -DarchetypeArtifactId=client-designer-gateway-archetype -DarchetypeVersion=1.0.03

This archetype will create a new project structure for you with seperate directories for each of the Gateway, Designer and Client scopes, as well as a Common and Build directory!  For a full list of the Ignition archetypes, you can browse for [com.inductiveautomation]( at [Maven Central](