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.
The command line syntax for FBCMD is as follows:
FBCMD.EXE <ProjectFile> [options]
| Switch | Behaviour | Example |
|---|---|---|
| <ProjectFile> | The FinalBuilder project file | "C:\Build\MyProject.fbz7" |
| -redirectoutput:<redirectoutput> -r:<redirectoutput> |
Output messages to text file instead of console. | -r:"C:\Temp\RedirectLog.log" |
| -redirectmode:<redirectmode> -rm:<redirectmode> |
Redirect Mode, O : overwrite, N : do not overwrite, A : Append | -rm:O |
| -params -@ |
Parameter file. Specify a file which contains all command line options to use. | -@:"C:\Temp\Params.txt" |
| -logexceptions -le |
Write all exceptions to the log. | -le |
| -allowinteractive -ai |
Allow interactive actions. | -ai |
| -quiet -q |
Quiet mode. Only log build start, end and errors. | -q |
| -silent -s |
Silent mode. Nothing is written out to the log. | -s |
| -nobanner -nb |
Suppress product banner in output. | -nb |
| -exportlog:<exportlog> -ex:<exportlog> |
Export Log to a file at the end of the build (file extension determines format: html, xml or txt) | -ex:"C:\Temp\Build.html" |
| -heirachlog -h |
Disable hierarchical logging. | -h |
| -validate -vp |
Validate project before execution. | -vp |
| -noctrl -ic |
Ignore all system message (eg. Ctrl-C, Shutdown) | -ic |
| -closeother -co |
Close project if open in the IDE (see FBCMD help topic. | -co |
| -closeforce -cf |
Forcibly close project if open in the IDE (use with caution). | -cf |
| -templog -tl |
Log to a temporary log file. | -tl |
| -targets:<targets> -t:<targets> |
List of targets to run from the project. More than one target can be included by seperating with a semi-colon. | -t:Build |
| -packages:<packages> -pk:<packages> |
Packages to load for running the FinalBuidler project. Each entry should be seperated by a semi-colon. Overrides the packages set to load in the FinalBuilder options. | -pk:RequiredPackage.fbap |
| -variables:<variables> -v:<variables> |
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. | -v:MyVar="Some Text" |
| -logexclusions:<logexclusions> -x:<logexclusions> |
Don't output selected message types to the console. T : Target start/stop messages, A : Action start messages, M : Action output messages. | -x:T |