Try OpenEdge Now

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).	Building a working set automatically
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.	Clearing OpenEdge errors Progress OpenEdge context 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.	Saving resources automatically before a manual build Workspace preferences
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.	Editor Build options Build properties page Setting SpeedScript Editor preferences
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.	Compiling ABL code Editor Build options
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.	Excluded resources Excluding resources from the context menu Progress OpenEdge context menu
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.	Including resources using the context menu Progress OpenEdge context menu
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.	Compiling ABL code Compiling Web objects Progress OpenEdge context 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 properties page Configuring r-code generation
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.	Build properties page
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.	Build properties page Configuration variables Compiling Web objects
Pre-compile callback routine	Specifies a procedure that runs prior to compilation. To access this option, select Properties > Progress OpenEdge > Build.	Build properties page
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.	Build properties page
Compile on publish	Allows you to compile code when you publish to a remote AppServer or WebSpeed server.	Server editor for WebSpeed Creating a WebSpeed server New Server wizard Defining an AppServer server
Compile options	Allows you to add any compile options, such as startup or other parameters.	Server editor for WebSpeed Server Editor

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.	Performing builds manually Project menu List of key bindings
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.	Performing builds manually Project menu Builds
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.	Working sets Project menu Building a working set manually Creating a new working set
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.	Builds Auto-build vs. Manual Build Project menu Performing builds automatically Compiling ABL code Workspace preferences
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.	Build Order Changing the build order Build properties page
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.