Automatic Using the Maven Archetype
The easiest way to create a module is to Use the Module Maven Archetype.
It will create the project skeleton and a pom.xml file with all the dependencies for OpenMRS APIs and modules.
Video Guide from OpenMRS University
Manual Step by Step Instructions
There is really no reason to do anything other than use the maven archetype (see above), but if you want to create the module structure manually:
- See How create an OpenMRS module
- Build your module using maven. "mvn package" at command line or "right click on project, run as --> maven package"
- Try out your module
- Go to your openmrs installation Administration-->Manage Modules
- Choose Upload and browse to the "omod/target" folder in your checked out code. choose the latest.omod file
- Document your module
- Modules should have a home page that describes their purpose, features, instructions, known issues, etc.
- Feel free to create a wiki page for your module on this wiki. Your page should be called "FooBar Module" if you have created a module called FooBar.
- Create it as a child of the Active Projects page
- Publish the resulting .omod file
- Consider using the OpenMRS Module Repository app. Read more about it here: Module Repository