The LVGL is written mainly for microcontrollers and embedded systems however you can run the library on your PC as well without any embedded hardware. The code written on PC can be simply copied when your are using an embedded system.
The PC simulator is cross platform. Windows, Linux and OSX are supported, however on Windows it's easier to get started with a another simulator project.
This project uses Eclipse CDT (as an IDE) and SDL =a low level driver library to open a window, and handle mouse, keyboard etc.)
On Linux you can easiyl install it the requirements via terminal:
sudo apt-get update
sudo apt-get install -y build-essential \
libsdl2-dev libsdl2-image-dev libjpeg-dev libpng-dev
Or you can download SDL from https://www.libsdl.org/.
Clone this repository and the related submodules to the workspace folder of Eclipse:
git clone --recursive https://github.com/lvgl/lv_port_pc_eclipse
- Open Eclipse CDT
- Click File->Import and choose General->Existing project into Workspace
- Browse the root directory of the project and click Finish
- Build your project and run it
This configures in this project, but if you start a new Eclipse project due to an Eclipse bug you need modify the Assembler command:
- In Project properties -> C/C++ build -> Settings -> Cross GCC
Assembler -> Command: change
as
togcc
- On the same place: Cross GCC Assembler -> General -> Assembler
flags: add
-c
The following steps can be used with CMake on a Unix-like system. This may also work on other OSes but has not been tested.
- Ensure CMake is installed, i.e. the
cmake
command works on the terminal. - Make a new directory. The name doesn't matter but
build
will be used for this tutorial. - Type
cd build
. - Type
cmake ..
. CMake will generate the appropriate build files.- To build with SDL draw unit, add
-DLV_USE_DRAW_SDL=ON
to command line - To build with libpng to support PNG image, add
-DLV_USE_LIBPNG=ON
to command line - To build with libjpeg-turbo to support JPEG image, add
-DLV_USE_LIBJPEG_TURBO=ON
to command line
- To build with SDL draw unit, add
- You can use
cmake -DCMAKE_BUILD_TYPE=Debug ..
to build a version with GDB symbols. - Type
make -j
or (more portable)cmake --build . --parallel
.
NOTE: --parallel
is supported from CMake v3.12 onwards. If you
are using an older version of CMake, remove --parallel
from the
command or use the make option.
- The binary will be in
../bin/main
, and can be run by typing that command.
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request!
If you find an issue, please report it on GitHub!