Build Steps

Build steps are configured per source file.
An assembly build is done in three steps, pre build, custom build and post build.



Pre build and post build do nothing per default, but can be overridden to do custom processing (crunching, etc.). If the custom build step is empty the built in assembler compiles the file. Any content in here will be run instead of the built in assembler.
Build chains allow the building of other projects/files with different configurations. They are useful if you have a multi loader and want to assemble a final disk image; which requires building all single loads upfront. Look below for details.


Any scripts in a build step are performed sequentially. Several macros are filled with current file and project information.

Available macros are:

Macro Content
$(Filename) Full path with file name of current file
$(FilenameWithoutExtension) Full path with file name of current file without extensions
$(FilePath) Full path of current file
$(BuildTargetPath) Full path of output file without the actual file name
$(BuildTargetFilename) Full path of output file
$(BuildTargetFilenameWithoutExtension) Full path of output file without extension
$(DebugStartAddress) Configured debug start address decimal
$(DebugStartAddressHex) Configured debug start address hexadecimal
$(ConfigName) Returns the chosen configuration for the build
$(ProjectPath) Returns the base path of the project
$(MediaManager) Returns the full path to the MediaManager executable

Build Chains

Build chains define a list of projects/files to be built with certain configurations either before the actual file (pre build chain) or after the actual file (post build chain).



Choose a project, then a file from that project and a configuration. Defines in the field below may be set which are added additionally to the config pre defines.