Build Project Forms
The Maestro Offline Build (MOB) tool provides the ability to build all forms in a project from one command. The MOB tool must be pointed to the project folder containing all of the cloned assets (to learn more about cloned assets, see Clone Project). This can be done by either specifying the folder directly in an option, or by running the command from the project folder itself.
Synopsis
maestro build-project-forms [ options ]
Options
All options are optional unless otherwise indicated.
info
Both short and long options are shown in the table below. When specifying a command, use either a short option or long option but not both.
| Option | Description |
|---|---|
-l--library-search | Library Search Path A comma-separated list of paths on the local file system to search for release and organization libraries. For more information, see About the Library Search Path below. |
-p--project-dir | Project Path The path to the Project Folder on the local file system. If not provided, this defaults to the current working folder. |
-o--output-dir | Output Path The path on the local file system to place the built files. If not provided, files are exported to the current working folder. |
-t--target-format | Target Format The output format of the built forms. Supported formats:
|
-f--force-overwrite | (Flag) Force Overwrite Indicate that any existing contents in the output folder may be overwritten. Only the build assets will be overwritten/removed. If exporting to the project folder, all of the assets created during the clone are preserved. If not provided and the folder is not empty, an error is displayed. |
About the Library Search Path
As outlined in Clone Project, the MOB tool can optionally download the relevant release and organization libraries during the clone phase, placing them in the release-libraries and org-libraries sub-folders respectively.
When building forms, the MOB tool looks for release and organization libraries in these folders. However, if you want to manage these libraries separately to the projects, you can instruct the MOB tool to look elsewhere on the file system for them. A single --library-search parameter controls the search for both release and organization libraries. Multiple comma-separated paths may be specified; for example: C:\releases\20.11.0,C:\libraries\org1.
Examples
Build all forms in the current project folder, using the release and organization libraries that reside within the project folder (default), and creating a zip file for each form (default).
maestro build-project-formsBuild all forms in a specified project folder, outputting to a different specified folder.
maestro build-project-forms -p C:\org\my-project -o C:\builds\my-projectBuild all forms in the current project folder, searching for release and organization libraries in another set of folders.
maestro build-project-forms -l C:\releases\20.11.0,C:\libraries\org1Build all forms in the current project folder, creating a FAR file for each form.
maestro build-project-forms -t f