Using the command file method for command line building

Overview

To execute multiple commands, it is possible to pass a file path as a Java property to the command line build. For example:

designer -RPARAMS -vmargs -Dcom.ibm.designer.cmd.file=<path to command file>

This file can contain one command per line. A sample command file would look like the following:

config,true,true
importandbuild,C:\test\XPagesExt\.project,testXPages
wait,testXPages,20
importandbuild,C:\test\XPagesSBT\.project,testSBT
wait,testSBT,20
clean
exit

Additional information on using the command line build methods

Although this feature is a command line build system, Domino Designer is launched but the window is immediately minimized.

No user interaction is needed with the Domino Designer user interface, however. You must be careful, however, because with the presence of the minimized user interface there is the potential for issues where an unexpected state could display a dialog, etc.

Using Update Manager commands with this feature

Some additional Update Manger commands have also been added to allow some ability to update the Extension Library plug-ins using the command-line syntax. For example:

com.ibm.designer.domino.tools.userlessbuild.jobs.UpdateManagerJob <command>

where <command> is a standard Eclipse Update Manager command.

Setting up to use Update Manager commands

If the Update Manager command interfaces are being used, it is necessary to disable the Notes provisioning security, in order to allow the dropping of plug-ins into Designer.

Testing for this has been limited to adding new plug-ins to a site and removing the old ones. This requires creating (unzipping) the site to the specified folder prior to the operation. The commands are the following:

-command addSite -from local_site_dir
-command removeSite -to local_site_dir

This is an example of using a build command file that also uses a few Update Manager commands:

config,true,true
com.ibm.designer.domino.tools.userlessbuild.jobs.UpdateManagerJob,-command addSite -from C:\test\site
exit,18000,true,true
importandbuild,C:\test\XPagesExt\.project,UMtest
wait,UMtest,20
com.ibm.designer.domino.tools.userlessbuild.jobs.UpdateManagerJob,-command removeSite -to C:\test\site
clean
exit,12000