system_ui_phone.md

Phone

• 中文版本

Phone is a smartphone-like system UI. The running effects on ESP Development Boards and PC are shown below:

Running on ESP Development Boards

Running on PC Simulator (Click to view the video)

It has the following features:

• Hardware Requirements: Suitable for screens with touch, mouse, or other pointer-type input devices.
• Multi-Resolution Support: The default style supports resolutions of 240 x 240 and above, with automatic adjustment of GUI element sizes according to the resolution.
• Background Management: Supports the coexistence and management of multiple Apps in the background.
• Navigation Bar and Gesture Control: Supports switching between interfaces within the app through the navigation bar or gesture control.

Note

• The default style of Phone is designed for resolution compatibility, so the display may not be optimal at many resolutions. It is recommended to use a UI stylesheet that matches the screen's resolution. If no suitable stylesheet is available, manual adjustments may be required.
• The "Recents Screen" in Phone, which displays screenshots of App GUIs, requires enabling the LV_USE_SNAPSHOT configuration in LVGL and sufficient memory space; otherwise, screenshots will be replaced with App icons.

To achieve the best display performance at fixed resolutions, esp-brookesia also provides UI stylesheets for the following resolutions:

• 320 x 240
• 320 x 480
• 480 x 480
• 720 x 1280
• 800 x 480
• 800 x 1280
• 1024 x 600
• 1280 x 800

Note

If your screen resolution is not listed in the above UI stylesheets, please refer to the GitHub issue - Phone Resolution Support.