Arbed - Command (Tool) Operations

Arbed can be asked via the cmdline to perform several operations, which is convenient for batch processing and other automation tasks.

To invoke Arbed on Windows and Linux, it should be straight-forward like with any other command line tool.

On OS X, not the .app bundle but the included executable needs be addressed from the command line, like this:

Project Comparison

Open two projects and show them in the Comparison window.

Syntax:

options:

• -noExternals -- looks only at these two files, without including external classes and modules (option available since v1.4.1). This is effectively the the inverse of the Checkbox titled "Include Externals" in the UI. If this option is not provided, all external code items will be included in the comparison.
• -showAlerts -- shows any errors via MsgBox (option available since v1.4.1).

Vault export/import

Performs a Vault ex-/import

Syntax:

options:

• -collectExternals -- stores externals into main vault. Otherwise, they're stored next to their originals (option available since v1.4.1). This is effectively the the inverse of the Checkbox titled "Separate Externals" in the UI: Using this option is equal to unchecking "Separate Externals" in the UI, not providing the option is like checking the box in the UI.
• -adoptFolders -- adopts folder hierarchy in vault (option available since v1.4.1).
• -showAlerts -- shows any errors via MsgBox (option available since v1.4.1).

Convert (Project Export) operations

The Main window's Convert operations can be executed via the cmdline.

When invoked this way, Arbed will process this one command and then quit again. If there are errors or warnings, they will be written to stdout. If there were no errors (warnings do not matter), it'll quit with exit code 0, otherwise with a non-zero value (e.g. 1).

Syntax:

Note that output folder and file name are separate arguments, i.e. separated by a space.

command is either:

• --export-project-xml
• --export-project-rbp
• --export-project-rbvx

options:

• -noExternals -- exports only the main project, excluding any external code items. Without this option externals are included.
• -showAlerts -- shows any errors via MsgBox (option available since v1.4.1).

Script execution (since 1.6b15)

Runs a script on a project file that gets loaded from disk, and automatically saves the project file if the script modified it. The script may also output text using the "Print" command.

This allows for batch processing of Real Studio project files.

Syntax:

options:

• -keepBackup -- Keeps the previous file version as a backup by renaming it with an appended "~".
• -stringConst name value -- Inserts a line to the beginning script: const name = "value". Put the value into quotes if it contains spaces!
• -numConst name value -- Inserts a line to the beginning script: const name = value

Example commands:

• c:\ArbedWin\Arbed.exe --run-script -stringConst find "a b c" -stringConst replace def c:\Projects\Test.arbs c:\Projects\Test.rbp
• /Applications/Arbed.app/Contents/MacOS/Arbed --run-script -stringConst find "a b c" -stringConst replace def /Projects/Test.arbs /Projects/Test.rbp

These would invoke a script that could find the given string "a b d" in the project and replace it with "def".