| Table of Contents |
|---|
...
To create a deployable KFS war, you can use the mvn package command. To execute the KFS unit tests, you can use the mvn test command. See the setup instructions and Maven Introduction to the Build Lifecycle documentation for more information.
| Description | Maven Command |
| Remove all build output | clean |
| Run all unit tests and format results | test |
| Create artifacts and install them in ~/.m2/repository | install |
| Builds the KFS war file | package |
...
...
| Code Block |
|---|
mvn frontend:webpack -pl kfs-web |
If you install NodeJS, npm and Webpack outside of Financials, you can run a Webpack in a mode called “watch”. This will look for changes to the script files and create the bundle if the files change. This feature is not available when running maven. You can install node by going to the node web page, https://nodejs.org/, and downloading the appropriate installer for your operating system. On Mac OS X, you can install the Homebrew package manager and install NodeJS via that. On Linux, NodeJS is usually available via your operating system package manager. Once node is installed, you can use the node package manager to install webpack. To do this, follow these steps:
| Code Block |
|---|
npm login --registry https://npm.kuali.co
cd kfs-web/src/main/webapp
npm install |
...
This command reads the package.json file in this directory and installs the modules specified into the node_modules folder.
| Warning |
|---|
The node_modules directory does not get removed during a mvn clean. If there have been significant changes to the npm dependencies or versions then this can lead to unexpected errors. You can either manually delete the node_modules directory or run 'git clean -df'. After clearing the node_modules directory you will need to run npm install again to re-download the npm dependencies. (running npm install after deleting node_modules is more time consuming since it has to re-download all of the dependencies instead of just the changed ones) |
...
After the webpack module is installed, you can run one of the following commands from inside the webapp directory:
npm run watch - This command will build the bundle.js file then monitor the filesystem for changes to the script files. It will rebuild the bundle.js file if any scripts change.
npm run build - This command will build the bundle.js file then exit. It performs the same work that the maven command performs.
...