The Meson Build System
http://mesonbuild.com/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 lines
1.7 KiB
60 lines
1.7 KiB
3 years ago
|
name: declare_dependency
|
||
|
returns: dep
|
||
|
description: |
|
||
|
This function returns a [[@dep]] object that
|
||
|
behaves like the return value of [[dependency]] but is
|
||
|
internal to the current build. The main use case for this is in
|
||
|
subprojects. This allows a subproject to easily specify how it should
|
||
|
be used. This makes it interchangeable with the same dependency that
|
||
|
is provided externally by the system.
|
||
|
|
||
|
kwargs:
|
||
|
compile_args:
|
||
|
type: list[str]
|
||
|
description: Compile arguments to use.
|
||
|
|
||
|
dependencies:
|
||
|
type: list[dep]
|
||
|
description: Other dependencies needed to use this dependency.
|
||
|
|
||
|
include_directories:
|
||
|
type: list[inc | str]
|
||
|
description: |
|
||
|
the directories to add to header search path,
|
||
|
must be [[@inc]] objects or *(since 0.50.0)* plain strings.
|
||
|
|
||
|
link_args:
|
||
|
type: list[str]
|
||
|
description: Link arguments to use.
|
||
|
|
||
|
link_with:
|
||
|
type: list[lib]
|
||
|
description: Libraries to link against.
|
||
|
|
||
|
link_whole:
|
||
|
type: list[lib]
|
||
|
since: 0.46.0
|
||
|
description: Libraries to link fully, same as [[executable]].
|
||
|
|
||
|
sources:
|
||
|
type: list[str | file]
|
||
|
description: |
|
||
|
sources to add to targets
|
||
|
(or generated header files
|
||
|
that should be built before sources including them are built)
|
||
|
|
||
|
version:
|
||
|
type: str
|
||
|
description: |
|
||
|
the version of this dependency,
|
||
|
such as `1.2.3`. Defaults to the project version.
|
||
|
|
||
|
variables:
|
||
|
type: dict[str] | list[str]
|
||
|
since: 0.54.0
|
||
|
description: |
|
||
|
a dictionary of arbitrary strings,
|
||
|
this is meant to be used
|
||
|
in subprojects where special variables would be provided via cmake or
|
||
|
pkg-config. *since 0.56.0* it can also be a list of `'key=value'` strings.
|