https://github.com/lvgl/lv_web_emscripten

LVGL ported to Emscripten to be converted to JavaScript
https://github.com/lvgl/lv_web_emscripten

gui lvgl simulator web

Last synced: 8 days ago
JSON representation

LVGL ported to Emscripten to be converted to JavaScript

• Host: GitHub
• URL: https://github.com/lvgl/lv_web_emscripten
• Owner: lvgl
• License: mit
• Created: 2019-01-13T06:51:57.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-08-23T04:21:42.000Z (3 months ago)
• Last Synced: 2024-08-23T05:31:03.604Z (3 months ago)
• Topics: gui, lvgl, simulator, web
• Language: C
• Homepage:
• Size: 26.7 MB
• Stars: 68
• Watchers: 4
• Forks: 26
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Emscripten port

**LVGL ported to Emscripten to be converted to JavaScript**

The result looks like this https://lvgl.io/demos

# How to get started

## Install SDL

Downlad [SDL](https://www.libsdl.org/) (a graphics library to ope na window and handle the mouse). On Linux:

1. Find the current version of SDL2: `apt-cache search libsdl2 (e.g. libsdl2-2.0-0)`

2. Install SDL2: `sudo apt-get install libsdl2-2.0-0` (replace with the found version)

3. Install SDL2 development package: `sudo apt-get install libsdl2-dev`

4. If build essentials are not installed yet: `sudo apt-get install build-essential`

## Install Emscripten SDK

Download the [Emscripten SDK](https://kripken.github.io/emscripten-site/) and make sure it is in your PATH.

1. `git clone https://github.com/emscripten-core/emsdk.git`

2. `cd `

3. `git pull`

4. `./emsdk install latest`

5. `./emsdk activate latest`

6. `source ./emsdk_env.sh`

More info here: https://kripken.github.io/emscripten-site/docs/getting_started/downloads.html

## Get the Emscripten-LVGL project

1. Be sure you ran `. /emsdk_env.sh` to add EMSDK to `PATH`

2. In any directoy: `git clone --recursive https://github.com/lvgl/lv_web_emscripten.git`

3. `cd `

4. `mkdir cmbuild`

5. `cd cmbuild`

6. `emcmake cmake ..`

7. `emmake make -j4`

5. A file called `index.html` will be generated. Run this in your browser.

### Build options (environment variables)

* `LVGL_CHOSEN_DEMO` can be set to the desired demo name so that you don't need to change any C files. This is useful to compile many demos in bulk using a script.

Example `emcmake cmake .. -DLVGL_CHOSEN_DEMO=lv_demo_widgets`

### Known issue with Google Chrome browser

Chrome might not be able to open the generated html file offline. It works if you copy the files to a server. Use Firefox or other browser for offline testing if needed.

### Known issue with Firefox

Firefox cmight no be able to open the generated html file offline unless you go to `about:config` and change `privacy.file_unique_origin` to `false`.