lazbuild: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | lazbuild is a command line utility to compile Lazarus projects and packages, as well as the Lazarus IDE itself. When you built Lazarus yourself you can find the lazbuild executable in the Lazarus source directory together with the lazarus executable. | |
| 2 | 2 | ||
| 3 | 3 | ## Synopsis | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | ```text | |
| 6 | + | lazbuild [options] filename filename ... | |
| 7 | + | ``` | |
| 6 | 8 | ||
| 7 | 9 | ## Description | |
| 8 | 10 | ||
| 9 | 11 | lazbuild builds Lazarus projects (.lpi) and/or packages (.lpk). It automatically compiles required packages. It can also compile the IDE and install any compiled packages. | |
| 10 | 12 | ||
| 11 | 13 | ## Usage | |
| 12 | 14 | ||
| 13 | 15 | lazbuild is a command-line tool. It recursively checks all dependencies and compiles needed packages first. It uses the Free Pascal compiler (fpc) to compile. | |
| 14 | 16 | ||
| 15 | 17 | ## Options | |
| 16 | 18 | ||
| 17 | 19 | -h or --help | |
| 18 | 20 | write the list of options. | |
| 19 | 21 | ||
| 20 | 22 | -B or --build-all | |
| 21 | 23 | build all files of project/package. Normally the compiler only compiles the main source and all sources with a newer date. | |
| 22 | 24 | ||
| 23 | 25 | -r or --recursive | |
| 24 | 26 | apply build flags (-B) to dependencies, too. | |
| 25 | 27 | ||
| 26 | 28 | -d or --skip-dependencies | |
| 27 | 29 | do not compile dependencies | |
| 28 | 30 | ||
| 29 | 31 | --build-ide=\<options\> | |
| 30 | 32 | 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. They can be empty. (With 0.9.30 and below the IDE profile custom options were replaced). Since at least Lazarus 1.0.6 (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). | |
| 31 | 33 | ||
| 32 | 34 | - Example for building with your default profile: --build-ide= | |
| 33 | 35 | - Example for building with a specific profile: --build-ide="Normal IDE" | |
| 34 | 36 | ||
| 35 | 37 | -v or --version | |
| 36 | 38 | show version and exit | |
| 37 | 39 | ||
| 38 | 40 | -q or --quiet | |
| 39 | 41 | be less verbose; can be given multiple times. Since 1.5: Passing quiet two times, will pass -vw-n-h-i-l-d-u-t-p-c-x- to the compiler. | |
| 40 | 42 | ||
| 41 | 43 | --verbose | |
| 42 | 44 | be more verbose; can be given multiple times | |
| 43 | 45 | ||
| 44 | 46 | --verbose-pkgsearch | |
| 45 | 47 | Write what package files are searched and found. Since 1.5. | |
| 46 | 48 | ||
| 47 | 49 | --add-package | |
| 48 | 50 | add package(s) to list of installed packages in the IDE (combine with --build-ide to rebuild IDE). Since 1.1. | |
| 49 | 51 | ||
| 50 | 52 | Example: --build-ide= --add-package projecttemplates lazopenglcontext /path/to/your/pkg/name.lpk | |
| 51 | 53 | ||
| 52 | 54 | --add-package-link=\<.lpk file\> | |
| 53 | 55 | Register the Lazarus package files (.lpk) and exit. Do not build. Since 1.7. | |
| 54 | 56 | ||
| 55 | 57 | --create-makefile | |
| 56 | 58 | Instead of compile package, create a simple Makefile. No support for build modes. Does not compile required packages. | |
| 57 | 59 | ||
| 58 | 60 | --primary-config-path=\<path\> or --pcp=\<path\> | |
| 59 | 61 | primary config directory, where Lazarus stores its config files. Default is \$HOME/.lazarus | |
| 60 | 62 | ||
| 61 | 63 | --secondary-config-path=\<path\> or --scp=\<path\> | |
| 62 | 64 | secondary config directory, where Lazarus searches for config template files. Default is /etc/lazarus | |
| 63 | 65 | ||
| 64 | 66 | --operating-system=\<operating-system\> or --os=\<operating-system\> | |
| 65 | 67 | override the project operating system. e.g. win32 or linux. | |
| 66 | 68 | ||
| 67 | 69 | --widgetset=\<widgetset\> or --ws=\<widgetset\> | |
| 68 | 70 | override the project widgetset. e.g. gtk, gtk2, qt, win32, or carbon. | |
| 69 | 71 | ||
| 70 | 72 | --cpu=\<cpu\> | |
| 71 | 73 | override the project cpu. e.g. i386, x86_64, powerpc, powerpc_64 etc. | |
| 72 | 74 | ||
| 73 | 75 | --subtarget=\<subtarget\> | |
| 74 | 76 | override the project subtarget (since Lazarus 3.99) | |
| 75 | 77 | ||
| 76 | 78 | --build-mode=\<project/ide build mode\> or --bm=\<project/ide build mode\> | |
| 77 | 79 | 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) | |
| 78 | 80 | ||
| 79 | 81 | --compiler=\<ppcXXX\> | |
| 80 | 82 | override the default compiler. e.g. ppc386, ppcx64, ppcppc etc. | |
| 81 | 83 | ||
| 82 | 84 | --language=\<language\> | |
| 83 | 85 | override language. For example --language=de. For possible values see files in the lazarus/languages directory. | |
| 84 | 86 | ||
| 85 | 87 | --lazarusdir=\<Lazarus directory\> | |
| 86 | 88 | directory, to be used as a basedirectory | |
| 87 | 89 | ||
| 88 | 90 | --max-process-count=\<count\> | |
| 89 | 91 | Maximum number of threads for compiling in parallel. Default is 0, which guesses the number of cores in the system. Since 1.5. | |
| 90 | 92 | ||
| 91 | 93 | --no-write-project | |
| 92 | 94 | Do not write updated project info file (.lpi) after build. If not specified, build number will be incremented if configured. Since 1.7. | |
| 93 | 95 | ||
| 94 | 96 | ## .lpi and .lpk files | |
| 95 | 97 | ||
| 96 | 98 | 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. | |
| 97 | 99 | ||
| 98 | 100 | --- | |
| 99 | 101 | *From the Free Pascal wiki, page "lazbuild", as it stood on 2023-07-26 after a change by Mattias2, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 100 | 102 | Category: Lazarus | |
| 101 | 103 | Category: Packages |