mirror of
https://git.yoctoproject.org/poky
synced 2026-05-31 12:49:46 +00:00
contributor-guide: add notes for tests
This adds some hints that and how changes should be tested when contributing. Fixes [YOCTO #15412] (From yocto-docs rev: 6f3dbb2a909ba5b71efb09b251ee3f8650e30146) Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
c2fd0446ec
commit
f9e1cfe9e8
@@ -221,6 +221,38 @@ to add the upgraded version.
|
|||||||
<https://www.kernel.org/doc/html/latest/process/submitting-patches.html#using-reported-by-tested-by-reviewed-by-suggested-by-and-fixes>`__
|
<https://www.kernel.org/doc/html/latest/process/submitting-patches.html#using-reported-by-tested-by-reviewed-by-suggested-by-and-fixes>`__
|
||||||
in the Linux kernel documentation.
|
in the Linux kernel documentation.
|
||||||
|
|
||||||
|
Test your changes
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
For each contributions you make, you should test your changes as well.
|
||||||
|
For this the Yocto Project offers several types of tests. Those tests cover
|
||||||
|
different areas and it depends on your changes which are feasible. For example run:
|
||||||
|
|
||||||
|
- For changes that affect the build environment:
|
||||||
|
|
||||||
|
- ``bitbake-selftest``: for changes within BitBake
|
||||||
|
|
||||||
|
- ``oe-selftest``: to test combinations of BitBake runs
|
||||||
|
|
||||||
|
- ``oe-build-perf-test``: to test the performance of common build scenarios
|
||||||
|
|
||||||
|
- For changes in a recipe:
|
||||||
|
|
||||||
|
- ``ptest``: run package specific tests, if they exist
|
||||||
|
|
||||||
|
- ``testimage``: build an image, boot it and run testcases on it
|
||||||
|
|
||||||
|
- If applicable, ensure also the ``native`` and ``nativesdk`` variants builds
|
||||||
|
|
||||||
|
- For changes relating to the SDK:
|
||||||
|
|
||||||
|
- ``testsdk``: to build, install and run tests against a SDK
|
||||||
|
|
||||||
|
- ``testsdk_ext``: to build, install and run tests against an extended SDK
|
||||||
|
|
||||||
|
Note that this list just gives suggestions and is not exhaustive. More details can
|
||||||
|
be found here: :ref:`test-manual/intro:Yocto Project Tests --- Types of Testing Overview`.
|
||||||
|
|
||||||
Creating Patches
|
Creating Patches
|
||||||
================
|
================
|
||||||
|
|
||||||
@@ -285,8 +317,9 @@ Validating Patches with Patchtest
|
|||||||
``patchtest`` is available in ``openembedded-core`` as a tool for making
|
``patchtest`` is available in ``openembedded-core`` as a tool for making
|
||||||
sure that your patches are well-formatted and contain important info for
|
sure that your patches are well-formatted and contain important info for
|
||||||
maintenance purposes, such as ``Signed-off-by`` and ``Upstream-Status``
|
maintenance purposes, such as ``Signed-off-by`` and ``Upstream-Status``
|
||||||
tags. Currently, it only supports testing patches for
|
tags. Note that no functional testing of the changes will be performed by ``patchtest``.
|
||||||
``openembedded-core`` branches. To setup, perform the following::
|
Currently, it only supports testing patches for ``openembedded-core`` branches.
|
||||||
|
To setup, perform the following::
|
||||||
|
|
||||||
pip install -r meta/lib/patchtest/requirements.txt
|
pip install -r meta/lib/patchtest/requirements.txt
|
||||||
source oe-init-build-env
|
source oe-init-build-env
|
||||||
|
|||||||
Reference in New Issue
Block a user