The yocto-compat-layer.py
script,
which is currently available, provides you a way to
assess how compatible your layer is with the Yocto
Project.
You should run this script prior to using the form to
apply for compatibility as described in the previous
section.
The script divides tests into three areas: COMMON, BSD, and DISTRO. For example, given a distribution layer (DISTRO), the layer must pass both the COMMON and DISTRO related tests. Furthermore, if your layer is a BSP layer, the layer must pass the COMMON and BSP set of tests.
To execute the script, enter the following commands from your build directory:
$ source oe-init-build-env
$ yocto-compat-layer.py your_layer_directory
Be sure to provide the actual directory for your layer as part of the command.
Entering the command causes the script to determine the type of layer and then to execute a set of specific tests against the layer. The following list overviews the test:
common.test_readme
:
Tests if a README
file
exists in the layer and the file is not empty.
common.test_parse
:
Tests to make sure that BitBake can parse the
files without error (i.e.
bitbake -p
).
common.test_show_environment
:
Tests that the global or per-recipe environment
is in order without errors (i.e.
bitbake -e
).
common.test_signatures
:
Tests to be sure that BSP and DISTRO layers do not
come with recipes that change signatures.
bsp.test_bsp_defines_machines
:
Tests if a BSP layer has machine configurations.
bsp.test_bsp_no_set_machine
:
Tests to ensure a BSP layer does not set the
machine when the layer is added.
distro.test_distro_defines_distros
:
Tests if a DISTRO layer has distro configurations.
distro.test_distro_no_set_distro
:
Tests to ensure a DISTRO layer does not set the
distribution when the layer is added.