abld command syntax overview

The abld batch file is used to control all aspects of building a project. The batch file is created using bldmake from a component description file.

Invocation syntax

abld [ test ] command [ options ] [ platform [ build [ program ] ] ]

A summary of command, options, platform, build, program, and test are given below.

Note that, for certain abld commands, not all the parameters— platform, build and program—apply. For example, abld export does not take these parameters, as exports do not depend on any of build, platform or program.

command

Possible commands are as follows:

build Combines commands export, makefile, library, resource, target, and final. clean Removes everything built with abld target cleanexport Removes files created by abld export export Copies the exported files to their destinations final Allows extension makefiles to execute final commands freeze Freezes exported functions in a .def file help Displays commands, options or help about a particular command library Creates import libraries from the frozen .def files listing Creates an assembler listing file for a particular source file makefile Creates makefiles or IDE workspaces reallyclean As clean, but also removes exported files and makefiles resource Creates resources files, bitmaps and aifs target Creates the main executable and also the resources tidy Removes executables which need not be released

options

Possible options are as follows:

-check or -c Check that the releasables are present -keepgoing or -k build unrelated targets on error -savespace or -s Delete intermediate files on success -verbose or -v Display tools calls as they happen -what or -w List the releasables

Note also that not all the options apply for all the commands. Where they do apply, they can be specified in either their long or abbreviated forms. For example,

-keepgoing (long form)

or

-k (abbreviated form)

platform

This specifies the target platform. Possible platforms are:

all All platforms arm4 ARM4 armi ARMI cw_ide Metrowerks CodeWarrior project (importable .xml file). thumb ARM Thumb wins WINS winscw WINSCW vc6 Microsoft VC++ 6 (for creating IDE workspaces)

If platform is not specified, or is specified as all, then abld will carry out the specified command for all the platforms specified in the component description file.

Basenames of .mmp files or extension makefiles must not be platform names.

build

This specifies the build type. Possible types are:

udeb Debug build urel Release build all Debug and release builds

If build is unspecified, or specified as all, then abld will carry out the specified command for both builds: udeb and then urel.

Basenames of .mmp files or extension makefiles must not be build type names.

program

This specifies the basename of a particular .mmp file or extension makefile, in order to limit the command to a single project within a component.

If program is unspecified, the specified command will be carried out for all projects within the component.

test

Where test is specified before command, the command will operate on all the projects defined by .mmp files listed in the prj_testmmpfiles section of the component description file, rather than those projects defined by .mmp files listed in the prj_mmpfiles section.

Note that the test parameter is irrelevant for some commands and, in those cases, cannot be specified.