Try OpenEdge Now
skip to main content
Online Help
Introducing OpenEdge Projects : Reference : Build and Compile options
 

Build and Compile options

The following tables summarize the Build and Compile options available with Progress Developer Studio for OpenEdge. Some of these options are provided by the Eclipse framework, while others are a part of the Progress Developer Studio for OpenEdge's functionality. The tables also lists the help topics associated with each option that you can refer to, for detailed information.

Options provided by Progress Developer Studio for OpenEdge:

Option
Description
Associated help topics
Build Working Set Automatically
Allows you to automatically build a working set.
To access this option, select Project > Build Working Set Automatically.
Note: The Build Working Set Automatically option is enabled only when the automatic build preference (at the project level) is disabled (ensure that Project menu > Build Automatically is not selected).
Clear OpenEdge Compile Errors
Clears any error messages for a particular file from the Problems view or the marker bar.
To use this option, select Project > Clear OpenEdge Compile > Errors or select Progress OpenEdge > Clear OpenEdge Compile > Errors from the ABL Editor context (right-click) menu.
Save automatically before build
Saves all the modified resources in the Workbench before a manual build.
To access this option, select Windows > Preferences > General > Workspace.
Compilable file extensions
Specifies the file extensions defined in the workspace for file types that the OpenEdge Editor and SpeedScript can compile.
To access this option select Windows > Preferences > Progress OpenEdge > Editor > Build.
Compile on save if required
Compiles ABL source files each time you save them.
To access this option select Windows > Preferences > Progress OpenEdge > Editor > Build.
Exclude from Build
Excludes compilable resources when you build your project. You can exclude files, folders, or both from the build.
To access this option select the Progress OpenEdge menu that is available from the ABL Editor context (right-click) menu.
You can also exclude resources using Exclusion Pattern Selection and Add Resource Exclusions. See Excluding resources using Exclusion Pattern Selection and Excluding resources using Add Resource Exclusions for more information.
Include in Build
Includes the excluded resources to the build. This option is only available for the resources that were excluded from the build.
To access this option select the Progress OpenEdge menu that is available from the ABL Editor context (right-click) menu.
You can also include resources using the Source tab of the Build properties page. See Including resources using the Source tab for more information.
Compile
Allows you to explicitly compile your current file.
To access this option, select Compile from either the Source menu or the ABL Editor context (right-click) menu.
Save r-code
Saves .r files when you build the code. When this option is enabled, OpenEdge saves compiled .r files in the directory you specify in the Build destination field; or, if that field is blank, in the same directory as the source file.
To access this option, select Properties > Progress OpenEdge > Build.
Build only when source files are newer than r-code
Compiles only those source files that do not have the latest r-code. This option can save time when compiled code already exists.
To access this option, select Properties > Progress OpenEdge > Build.
Project build destination
Specifies the directory that will contain the r-code. If this field is blank, the r-code is saved in the same directory as the source files.
To access this option, select Properties > Progress OpenEdge > Build.
Pre-compile callback routine
Specifies a procedure that runs prior to compilation.
To access this option, select Properties > Progress OpenEdge > Build.
Source tab
Allows you to specify the directories in the project where source code resides, the environment (TTY or GUI) of the source code, and the build destination for r-code.
To access this option, select Properties > Progress OpenEdge > Build.
Compile on publish
Allows you to compile code when you publish to a remote AppServer or WebSpeed server.
Compile options
Allows you to add any compile options, such as startup or other parameters.

Options provided by the Eclipse framework:

Option
Description
Associated help topics
Build All
Performs an incremental build on all the projects in the Workbench. It builds (compiles) all the resources in the Workbench that are affected by any resource changes since the last incremental build.
To use this option, select Project > Build All.
To build all resources, even those that have not changed since the last build, select Project > Clean before building the project.
Note: The Build All option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
Build Project
Builds the selected projects in the workspace. To use this option, you can:
*Select the project that you want to build and then select Project > Build Project
*Select Build Project from the project context (right-click) menu
Note: The Build Project option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
Build Working Set
Builds (compiles) all the resources in the working set that are affected by any resource changes since the last build. It also allows you to create a new working set by using Select Working Set.
To access this option select Project > Build Working Set.
Note: The Build Working Set option is only available if the Build Automatically menu option is not selected. You can access this option from the Project menu or from the General > Workspace preference page.
Build Automatically
Allows you to toggle the auto build preference. When checked, builds are invoked automatically as resources are saved. Automatic builds are always incremental and always operate over the entire workspace.
To access this option, select Project > Build Automatically. You can also configure your preferences (Window > Preferences > General > Workspace) to perform builds automatically on resource modification.
Build Order
Allows you to explicitly define the order in which projects are built. Alternatively, you can let the platform compute the build order by interpreting project references as prerequisite relationships. The build order is applied for building the entire workspace or for a group of projects.
To access the build order options, select Windows > Preferences > General > Workspace > Build Order.
The following build order options are provided:
*Up and Down: Manually changes the build order.
*Add Project and Remove Project: Add and removes projects from the build order.
*Use default build order: Allows the platform to compute the order in which the projects are built. Turning off this option enables access to the projects list, the order of which can be manipulated.
*Max iterations when building with cycles: Allows you to specify the maximum number of times the workbench will attempt to iterate over the build order before giving up.
You can also use the Source tab of the Build properties page to change the build order, add, and remove projects from the build order.
Wait for ongoing build to complete before launching
Controls whether to wait for the ongoing build to complete before launching other resources.
To access this option select Windows > Preferences > Run/Debug > Launching.
Build (if required) before launching
Allows you to manually build the project before launching, when the Build Automatically option is not selected.
To access this option select Windows > Preferences > Run/Debug > Launching.