mirrors/lvgl
0
0
Fork 0
mirror of https://github.com/lvgl/lvgl.git synced 2024-11-27 11:43:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
7c7e99604f
lvgl/tests
History
nicusorcitu 7c7e99604f
feat(gpu): improve NXP's PXP and VGLite accelerators (#3948) 
Signed-off-by: Nicușor Cîțu <nicusor.citu@nxp.com>
Signed-off-by: Stefan Babatie <stefan.babatie@nxp.com>
Signed-off-by: Wenbin Yuan <wenbin.yuan@nxp.com>
Co-authored-by: Stefan Babatie <stefan.babatie@nxp.com>
Co-authored-by: Wenbin Yuan <wenbin.yuan@nxp.com>
2023-01-28 23:14:40 +01:00
..
makefile ci: protect test.c with #if LV_BUILD_TEST 2022-07-25 21:22:56 +02:00
ref_imgs feat(margin): add margin style property (#3807) 2023-01-18 09:52:30 +01:00
src feat(gpu): improve NXP's PXP and VGLite accelerators (#3948) 2023-01-28 23:14:40 +01:00
unity test add valgrind support and address technical debt (#3731) 2022-10-09 17:06:56 -04:00
.gitignore test convert Makefile to CMake (#2495) 2021-08-27 15:49:31 +02:00
CMakeLists.txt ci: avoide having files with the same name 2023-01-18 09:26:51 +01:00
config.yml feat(test) first experiement with Unity test engine 2021-06-18 14:13:41 +02:00
main.py ci: use headers for text config instead of CMake 2022-11-25 11:32:14 +01:00
README.md ci(test): automatically create missing reference images for TEST_ASSERT_EQUAL_SCREENSHOT 2022-09-21 22:10:20 +02:00

README.md

Tests for LVGL

The tests in the folder can be run locally and automatically by GitHub CI.

Running locally

Requirements (Linux)

Install requirements by:

scripts/install-prerequisites.sh

Run test

  1. Run all executable tests with ./tests/main.py test.
  2. Build all build-only tests with ./tests/main.py build.
  3. Clean prior test build, build all build-only tests, run executable tests, and generate code coverage report ./tests/main.py --clean --report build test.

For full information on running tests run: ./tests/main.py --help.

Running automatically

GitHub's CI automatically runs these tests on pushes and pull requests to master and releasev8.* branches.

Directory structure

  • src Source files of the tests
    • test_cases The written tests,
    • test_runners Generated automatically from the files in test_cases.
    • other miscellaneous files and folders
  • ref_imgs - Reference images for screenshot compare
  • report - Coverage report. Generated if the report flag was passed to ./main.py
  • unity Source files of the test engine

Add new tests

Create new test file

New test needs to be added into the src/test_cases folder. The name of the files should look like test_<name>.c. The basic skeleton of a test file copy _test_template.c.

Asserts

See the list of asserts here.

There are some custom, LVGL specific asserts:

  • TEST_ASSERT_EQUAL_SCREENSHOT("image1.png") Render the active screen and compare its content with an image in the ref_imgs folder.
    • If the reference image is not found it will be created automatically from the rendered screen.
    • If the compare fails lvgl/test_screenshot_error.h is created with the content of the frame buffer as an image. To see the that image #include "test_screenshot_error.h" and call test_screenshot_error_show();.
  • TEST_ASSERT_EQUAL_COLOR(color1, color2) Compare two colors.