Building MSK

The MSK project contains an ANT build.xml file for automating repetitive build tasks.

Building in context of the MMIR framework mainly means, to keep the directories.json file up to date – it needs to be updated every time a controller, view, model, or language resource file (e.g. dictionary, grammar) is added or removed. This can be done, using the build.xml file of the project.

Build Configuration and Additional Requirements

The configuration file for build.xml is build.settings: if you do not see the file build.settings, either copy build.settingsDefault and rename it or try to run build.xml once (and refresh the view in Eclipse) which will create build.settings if it does not exist yet [Θ] .

This file only needs to be configured, if

1. you want to create or modify speech grammars (in www/config/languages/[lang]/grammar.json)
2. you want to compile dialogDescriptionSCXML.xml or inputDescriptionSCXML.xml NOTE: explicitly compiling the SCXML files into JavaScript files is not necessary any more, since the used SCION library interprets the XML files directly – however, compilation can be useful e.g. for finding syntax errors in the SCXML files.

If you do not want to do 1. or 2., no additional configuration is needed.

For compiling speech grammars (1.), we highly recommend the use (and configuration) for NodeJS [◊] since this is considerably faster than, e.g. using Mozilla Rhino. If you want to use NodeJS, you need to edit build.settings to set the correct path and executable name to NodeJS (after you have downloaded/installed NodeJS).

NOTE: If you remove a speech grammar, you also should run the clean task in build.xml (or delete the compiled grammar file manually).

For compiling dialogDescriptionSCXML.xml or inputDescriptionSCXML.xml (2.) you need the Open Source project Apache SCXML Commons JS and Maven; edit build.settings and set your paths etc. for Maven and the SCXML Commons JS project.