Build-time variables

In general, you can use symbolic variables as part of your build actions. Symbolic variables are expanded immediately prior to the build action in which they are used. See Alphabetical reference for a full description of the available symbolic variables.

General variables

Most symbolic variables can be used normally in build actions, because they do not depend on the system configuration and are not sensitive to timing issues (unless you redefined them in a way that does refer to runtime or build time information).

However, be aware that some variables refer to runtime information that depend on the target system (for example, physical memory size or the full path to the Windows folder). If you use these variables in build actions, they may be undefined or refer to your development system instead of the customer's system, which may or may not be what you intended.

Build time variables

The following variables are set by Tarma ExpertInstall each time you build a project and are considered build time variables:

Variable Description
BuildDate Build date as YYYYMMDD
BuildDayNo Build day number, starting from 1 January 2000
BuildFolder Folder containing the build target
BuildName Build configuration name
BuildTarget Build target file path
BuildTime Build time as HHMMSS
BuildType Build type: MSI or TSU
ProjectFolder Folder containing the Tarma ExpertInstall project file
ProjectName Tarma ExpertInstall project file base name
ProjectPath Fully qualified path to the Tarma ExpertInstall project file

During the build actions, the values of build time variables are available for use in the actions. However, their values may change during the build process as different configurations or targets are processed. Use the table below to determine which variables can be safely used during each custom build action.

n/a - indicates that the variable's value is either not available or cannot be relied upon.

Variable PreAll PreCheck PreBuild PostBuild PostAll
BuildDate Valid
BuildDayNo Valid
BuildFolder n/a Valid n/a
BuildName n/a Valid n/a
BuildTarget n/a Valid n/a
BuildTime Valid
BuildType n/a Valid n/a
ProjectFolder Valid
ProjectName Valid
ProjectPath Valid