Building and deploying
Maven is the main tool for building and deploying a complete application. It takes care of: * building the java libraries and webapp(s) * calling NPM as needed to take care of the frontend builds * launching both backend and frontend test suites * creating the final war for deploy into a J2EE container (e.g. Tomcat)
To create the final war, you have several options: * full build, including submodules and frontend (e.g. GeoStore)
./build.sh [version_identifier]
Where version_identifier is an optional identifier of the generated war that will be shown in the settings panel of the application.
- fast build (will use the last compiled version of submodules and compiled frontend)
mvn clean install
-Dmapstore2.version=[version_identifier]
Building the documentation
MapStore uses JSDoc to annotate the components, so the documentation can be automatically generated using docma.
Please see http://usejsdoc.org/ for further information about code documentation.
Refer to the existing files to follow the documentation style:
To install docma:
npm install -g docma
While developing you can generate the documentation to be accessible in the local machine by:
npm run doctest
The resulting doc will be accessible from http://localhost:8081/mapstore/docs/
For the production deploy a different npm task must be used:
npm run doc
The documentation will be accessible from the /mapstore/docs/ path
The generated folders can be removed with:
npm run cleandoc