FBCMD is a text mode version of FinalBuilder which can run projects from the command line. It is installed in the FinalBuilder directory.
FBCMD can be faster at executing than the IDE, as the IDE has more visual overhead.
Command Line Syntax
The command line syntax for FBCMD is as follows:
FBCMD.exe [options] [/P]<projectfile>
Options
Switch | Behaviour | Example |
|---|---|---|
/P | FinalBuilder Project File to execute
The /P is optional, you can just specify the project file name by itself instead (although in that case it must be after any other options.) | /P"C:\Build\MyProject.fbz7" or "C:\Build\MyProject.fbz7" |
/I | Ignore all system message (eg. Ctrl-C, Shutdown.) | /I |
/A | Allow interactive actions (message dialogs, prompt for variables, etc.) | /A |
/V | Set FinalBuilder variables, in the form VarName=VarValue. The variables must be already defined Project or User variables.
Separate multiple name/value pairs with semicolons. If the variable value contains spaces, enclose it in quotes. | /VMAJORVER=3;MINORVER=1 |
/C | Validate project before execution. | /C |
/S | Disable logging. No log file will be generated, and an existing log file will not be updated. The Export Log action will not function.
This option may give a significant performance speedup if the build runs many actions very quickly. Console output is still enabled (see below.)
With this option (or /TL) enabled, the same project can be opened multiple times concurrently. | /S |
/H | Disable hierarchical logging. | /H |
/TL | Logging is still performed, but to a temporary log file. This means actions such as the Export Log action still function.
With this option (or /S) enabled, the same project can be opened multiple times concurrently. | /TL |
@ | Read arguments from a parameter text file.
Each line of the file should specify a different command line parameter. | @"MyParameters.txt" |
/O | Close any other instances of the %ProductName% IDE which are idle with unmodified copies of the same project file. | |
/OF | Forcibly close any other instances of the %ProductName% IDE which are open with a copy of the same project file. The IDE will first attempt to close cleanly, otherwise will terminate a running project or force terminate a stuck project. Unsaved changes to projects will be lost. Mutually exclusive with /o.† |
† = Warning: Forcibly closing other projects may cause loss of data and should be used sparingly.
Options for console output (this affects the data written to the console, not to the project's log file:
Switch | Behaviour | Example |
|---|---|---|
/L | Output console messages to a specified text file instead of the console. | /L"C:\Temp\MyProjectOutput.txt" |
/LA | Like /L, but append to the text file instead of overwriting. | /L"C:\Temp\ExistingOutput.txt" |
/LN | Like /L, but fail if the file already exists (instead of overwriting.) | /L"C:\Temp\MoreOutput.txt" |
/B | Suppress FinalBuilder banner. | /B |
/XL | Don't output Action List start and end messages to the console.*° | /XL |
/XA | Don't output action start messages to the console.*° | /XA |
/XM | Don't send action output to the console.*° | /XAM |
* = Or the specified text file, if using /L, /LA or /LN.
° = Can be combined in a single switch, ie /XLAM.
See Also
Scheduling builds | IDE Command Line Interface