Autotools plugin¶
The plugin makes use of the following tools:
The Autotools plugin builds using the ./configure, make and make install
sequence seen in most GNU projects.
After a successful build, this plugin will install the generated binaries in
$CRAFT_PART_INSTALL.
Keys¶
This plugin provides the following unique keys.
autotools-bootstrap-parameters¶
Type
list[str]
Description
The bootstrap flags to pass to Autotools, if the part has a bootstrap file.
In some cases, bootstrap files can be found by running ./bootstrap --help.
autotools-configure-parameters¶
Type
list[str]
Description
The parameters to pass to Autotools.
Environment variables¶
The plugin does not set any environment variables.
Dependencies¶
The Autotools plugin needs the autoconf, automake, make, autopoint and
libtool executables to work. These are provided by the plugin as a
build-packages entry.
The plugin also sets up gcc as it is the most commonly used compiler for an
Autotools based project. Other compiler or library dependencies the source requires to
build are to be provided.
How it works¶
During the build step the plugin performs the following actions:
If the source does not provide a
configurefile, one will be generated through the following options:If an
autogen.shfile is found in the sources it will be run withNOCONFIGUREset to generate aconfigurefile.Alternatively, if a
bootstrapfile is found in the sources, it will run thebootstrapwith any setautotools-bootstrap-parameterswithout configuring the project.
Call
configurewith any setautotools-configure-parameters.Call
maketo build.Call
make installwithDESTDIRset to$CRAFT_PART_INSTALL.
Example¶
The following snippet declares a part using the autotools plugin. It sets GNU Hello
as a source, which has a bootstrap file. To setup the configure file to not care
for translations autotools-bootstrap-parameters is using the project’s option
--skip-po. During configure the installation --prefix is set to /usr
with autotools-configure-parameters.
The source also requires the following packages to correctly build: git, gperf,
help2man and texinfo.
parts:
hello:
source: https://git.savannah.gnu.org/git/hello.git
plugin: autotools
autotools-bootstrap-parameters:
- --skip-po
autotools-configure-parameters:
- --prefix=/usr/
build-packages:
- git
- gperf
- help2man
- texinfo