This topic describes the parameters in the build.config file.

The default value and description for each build.config file parameter are specific to Progress Developer Studio.

Note: Progress recommends that you do not modify the build.config file manually within Progress Developer Studio. All the parameters can be updated from the Progress Developer Studio user interface (Project Properties) with the exception of the following:
  • streamIO.enabled
  • languages.list
  • textSegGrow
  • minSize.enabled

You can update the build.config file manually to build the project outside of Progress Developer Studio.

The database and compilableFileExtensions parameters are not used with Progress Developer Studio.

For file portability, Progress recommends that you use variables instead of an absolute path for the following attributes:
  • 'buildDir'
  • 'oeide.xrefXmlDir'
  • 'oeide.preCompileCallbackRoutine'
  • 'avm.wrkDir'
  • 'avm.avmOptions.tmpDir'
  • 'avm.avmOptions.assembliesDir'
The following default variables are supported:
  • ROOT—Project's root location
  • WRKDIR—Working directory; set during installation
Note: The System properties, System environment variables, and Eclipse variables are also supported.

The variable to be used as "${<variable-name>}", for example, buildDir="${ROOT}/myBuildDir"

Global parameters

Parameters Default value Description
buildDir='' — Specifies the project build directory.

This directory contains the saved r-code files. If this field is blank then the r-code files are saved in the same directory as the source files.

oeide parameters

The following table contains the IDE-specific configurations that are only used by Progress Developer Studio for OpenEdge.

Parameter Default value Description
useSharedAVM='' false Specifies whether to use a shared AVM when building projects in Progress Developer Studio.

This parameter uses a Boolean value to specify whether the project uses a shared or a dedicated AVM.
oeideEvents='' true This parameter uses a Boolean value to enable or disable oeide events. This parameter enables you to write procedures that use the ABL SUBSCRIBE statement to capture and respond to those events.
useGlobalToolboxVD='' false This parameter uses a Boolean value to enable or disable the global Visual Designer toolbox.
addDefaultParams='' true Specifies whether to use the default startup parameters when starting the AVM.

This parameter uses a Boolean value to enable or disable the passing of default AVM parameters.
hideTTYConsole='' true Uses a Boolean value to enable or disable the project-specific run-time console.
useProjectCompilerSettings='' false Uses a Boolean value to enable or disable the use of project-specific 'strictOptions' under 'compile'.
saveRCode='' true Uses a boolean value to enable or disable persistant r-code on compiling sources.
xrefXmlDir='' — Specifies the output value of the XREF-XML option when xrefXml.enabled='true'.

This parameter uses a string value to specify the path where cross-reference information is saved in an XML file.
preCompileCallbackRoutine='' — Specifies the path to an ABL file that is run before compilation.

This uses a string value to specify the path to a procedure that runs prior to compilation.

For example, this option can used to set SECURITY-POLICY:XCODE-SESSION-KEY.

dotNetCore true Specifies the project type as a .NET project.

This parameter is added by default when you create a .NET project.

Note: This parameter is read-only and must not be changed. It is created only for .NET project type.

AVM parameters

Parameter Default value Description
wrkDir='' The project's root directory Specifies the working directory in which the AVM starts.

This parameter uses a string value to specify the path to the working directory, from where the AVM run time starts.

AVM option parameters

The following table lists the AVM option parameters (defined in the build.config file as avmOptions).

Parameter Default value Description
tmpDir='' The DLC working directory Specifies the temporary directory for the AVM run time (equivalent to the -T startup parameter option).

This parameter uses a string value to specify the path.
tty.enabled='' false Flag to use _progres or prowin executables. For _progres, the value is true; otherwise, it is false.

This parameter uses a Boolean value.
startupParameters='' — Specifies the startup parameters as a string.

This parameter uses a string value to pass startup parameters.
assembliesDir='' — Specifies the location of the Assemblies directory (equivalent to the -assemblies startup parameter option).

This parameter uses a string value.

Compile parameters

Parameter Default value Description
compilableFileExtensions='' p, w, cls, pgen, html, htm This parameter allows you to set the compilable file extensions.

Compile option parameters

The following table lists the Compile option parameters (defined in the build.config file as compileOptions).

Parameter Default value Description
multiCompile.enabled='' false This parameter uses a Boolean value to set the COMPILER:MULTI-COMPILE attribute.
xcodeKey='' — XCODE option in the COMPILE statement. Specify the expression as a string.
xrefXml.enabled='' false XREF-XML option in the COMPILE statement. To enable this option, set the value to true. Specify the expression as a Boolean value.
streamIO.enabled='' false STREAM-IO option in the COMPILE statement. To enable this option, set the value to true. Specify the expression as a Boolean value.
minSize.enabled='' false MIN-SIZE option in the COMPILE statement. To enable this option, set the value to true. Specify the expression as a Boolean value.
attrSpace.enabled='' false This parameter uses a Boolean value to set the ATTR-SPACE option in the COMPILE statement.

Strict option parameters

The following table lists the Strict option parameters (defined in the build.config file as strictOptions).

Parameter Default value Description
requireFullNames='' ignore Specifies the OPTIONS require-full-names in the COMPILE statement. Value can be ignore/warning/error.
requireFieldQualifiers='' ignore Specifies the OPTIONS require-field-qualifiers in the COMPILE statement. Value can be ignore/warning/error.
requireFullKeywords='' ignore Specifies the OPTIONS require-full-keywords in the COMPILE statement. Value can be ignore/warning/error.
requireReturnValues='' ignore Specifies the OPTIONS require-return-values in the COMPILE statement. Value can be ignore/warning/error.

Languages parameters

Parameter Default value Description
list='' — Comma-separated list of language segments to include in the compiled r-code.
textSegGrow='' — TEXT-SEG-GROW option. growth-factor as an integer. Supported only when a language list is provided.