Provide GIT rev/tag info to a bitbake recipe.
Some string manipulation (via regex) of the tag is available.
This layer depends on:
URI: git://git.openembedded.org/bitbake
URI: git://git.openembedded.org/openembedded-core
layers: meta
branch: master
In order to use this layer, the build system must be aware of it.
Assuming this layer exists at the top-level of the yocto build tree; add the location of this layer to bblayers.conf, along with any additional layers needed:
BBLAYERS ?= " \
/path/to/yocto/meta \
/path/to/yocto/meta-poky \
/path/to/yocto/meta-yocto-bsp \
/path/to/yocto/meta-bitbake-git-version \
"
Alternatively, run bitbake-layers to add:
$ bitbake-layers add-layer /path/to/yocto/meta-bitbake-git-version
| Variable | Defaults | Description |
|---|---|---|
BITBAKE_GIT_DESCRIBE_ARGS |
--tags --always --dirty |
arguments for git describe command |
BITBAKE_GIT_VER_RE_SUB_SEARCH |
```` | regex pattern to replace, if any (blank = noop) |
BITBAKE_GIT_VER_RE_SUB_REPLACE |
```` | replace found regex pattern with (blank = delete) |
BITBAKE_GIT_VER_RE_SUB_COUNT |
0 |
max number of found instances to replace (0 = replace them all) |
BITBAKE_GIT_VER_RE_MATCH |
. |
if found in tag string, only return matching portion |
These are all optional. All the _RE_ variables are hooks to manipulate the returned tag/rev.
- Add
inherit bitbake-git-versionto the recipe(s). - Additional/optional set configuration variables.
The following variables are produced by this layer/class.
| Variable | Description |
|---|---|
BITBAKE_GIT_VER_TAG |
GIT Tag, after any regex processing |
BITBAKE_GIT_VER_SHA |
Full GIT Hash |
BITBAKE_GIT_VER_SHA_SHORT |
Short GIT HASH |
These variables can be used inside other recipes to embedded git version information.
This layer will remain compatible with the latest YOCTO LTS.