Page Comparison

KFS uses Maven for packaging and unit testing.

Anchor
props props

Properties Anchor

Configuration properties have defaulted values which are included in the KFS war and may be overridden at runtime. There are skeleton config files located in kfs/src/main/config to aid in overriding the most common properties. To override:

...

For ease of future upgrades, you should avoid modifying any of the delivered files under the kfs directory. 

Anchor
maven maven

Maven Command Overview

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.

Anchor
skip_help skip_help

Skip Help

For iterative development, you may add -Dhelp.skip=true to the build command line. This skips the unpacking and deployment of the help files, significantly reducing the build time. 

Anchor
install_node install_node

Installing Node

You will want to install both NodeJS and the yarn package manager before building the front end. 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 and yarn via that. On Linux, NodeJS is usually available via your operating system package manager.

Anchor
install_yarn install_yarn

Installing Yarn

Yarn is the node package manager that is used within KFS. You can get an installer from its website https://yarnpkg.com/ or use Homebrew on OS X.

Anchor
webpack webpack

Webpack

mvn frontend:yarn@yarn-build -pl kfs-web

If you install NodeJS, yarn 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. Once node and yarn is installed, you can use yarn to install webpack.  To do this, follow these steps:

npm login --registry https://npm.kuali.co
cd kfs-web/src/main/webapp
yarn install

This command reads the package.json file in this directory and installs the modules specified into the node_modules folder. 

After the webpack module is installed, you can run one of the following commands from inside the webapp directory:

• yarn 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.

• yarn build - This command will build the bundle.js file then exit.  It performs the same work that the maven command performs.