lazbuild

│ Deutsch (de) │ English (en) │ español (es) │ français (fr) │

lazbuild is a command line utility to compile Lazarus projects and packages.

Synopsis

lazbuild [options] filename filename ...

Description

lazbuild builds Lazarus projects and/or packages. It compiles projects (.lpi) and packages (.lpk). It automatically compiles required packages. It can also compile the IDE.

Usage

lazbuild is a command-line tool that builds Lazarus projects and packages. It checks recursively all dependencies and compiles needed packages first. It uses the Free Pascal compiler (fpc) to compile.

Options

-h or --help

write the list of options.

-B or --build-all

build all files of project/package. Normally the compiler only compiles the main source and all sources with a newer date.

-r or --recursive

apply build flags (-B) to dependencies too.

-d or --skip-dependencies

do not compile dependencies

--build-ide=<options>

Compile the IDE (i.e. the lazarus executable). The list of installation packages is read from the config directory. The <options> are appended to the other IDE custom options. (With 0.9.30 and below the IDE profile custom options were replaced). (In development since revision 38971: you can pass -dKeepInstalledPackages to build the IDE with the list of packages you had previously selected - analogous to make useride; handy when using --add-package) build-ide uses the selected profile in the IDE. You can use another profile with --build-mode (see below).

-v or --version

show version and exit

-q or --quiet

be less verbose, can be given multiple times

--verbose

be more verbose, can be given multiple times

--add-package

add package(s) to list of installed packages (combine with --build-ide to rebuild IDE). Since 1.1.

--create-makefile

Instead of compile package create a simple Makefile. No support for build modes. Does not compile required packages.

--primary-config-path=<path> or --pcp=<path>

primary config directory, where Lazarus stores its config files. Default is $HOME/.lazarus

--secondary-config-path=<path> or --scp=<path>

secondary config directory, where Lazarus searches for config template files. Default is /etc/lazarus

--operating-system=<operating-system> or --os=<operating-system>

override the project operating system. e.g. win32 or linux.

--widgetset=<widgetset> or --ws=<widgetset>

override the project widgetset. e.g. gtk, gtk2, qt, win32, or carbon.

--cpu=<cpu>

override the project cpu. e.g. i386, x86_64, powerpc, powerpc_64 etc.

--build-mode=<project/ide build mode> or --bm=<project/ide build mode>

override the project build mode. With --build-ide= it selects the IDE build profile. (With 0.9.30 and below you can not select the IDE build profile)

--compiler=<ppcXXX>

override the default compiler. e.g. ppc386, ppcx64, ppcppc etc.

--language=<language>

override language. For example --language=de. For possible values see files in the lazarus/languages directory.

--lazarusdir=<Lazarus directory>

directory, to be used as a basedirectory

.lpi and .lpk files

If you want to create .lpi and .lpk files it is recommended to use the Lazarus IDE. The files are simple xml and all settings can be edited via the IDE. There is no reason to edit them manually, except for very rare cases like renaming hundreds of files.