当前仓库属于关闭状态,部分功能使用受限,详情请查阅 仓库状态说明
6 Star 1 Fork 2

OpenHarmony / graphic_ui
关闭

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 5.81 KB
一键复制 编辑 原始数据 按行查看 历史

UI

Introduction

The graphics UI module implements a system-level graphics engine.

This module provides the UIKit APIs for application development. You can use the APIs to add animations, manage layouts, transform images, process events, and operates on rich UI components.

The graphics UI directly calls the HAL API or uses the client provided by the Window Manager Service (WMS) to interact with the hardware to complete operations such as event response and image drawing.

Figure 1 Graphics subsystem architecture

Directory Structure

/foundation/arkui/ui_lite
├── frameworks                  # Framework code
│   ├── animator                # Animator module
│   ├── common                  # Common module
│   ├── components              # Components
│   ├── core                    # UI main processes (such as rendering and task management)
│   ├── default_resource
│   ├── dfx                     # Maintenance and test
│   ├── dock                    # Driver adaptation layer
│   │   └── ohos                # OHOS platform adaptation
│   ├── draw                    # Drawing logic
│   ├── engines                 # Drawing engines
│   ├── events                  # Events
│   ├── font                    # Fonts
│   ├── imgdecode               # Image management
│   ├── layout                  # Page layout
│   ├── themes                  # Theme management
│   ├── window                  # Window management adaptation layer
│   └── window_manager
│       └── dfb
├── interfaces                  # APIs
│   ├── innerkits               # APIs between modules
│   │   └── xxx                 # Sub-module APIs
│   └── kits                    # External APIs
│   │   └── xxx                 # Sub-module APIs
├── test                        # Test code
│   ├── framework
│   │   ├── include             # Header files for the test framework
│   │   └── src                 # Source code for the test framework
│   ├── uitest                  # Display effect test (The executable program is in foundation/window/window_manager_lite/test:sample_ui.)
│   │   └── test_xxx            # Specific UI effect test
│   └── unittest                # Unit testing
│       └── xxx                 # Unit testing for a specific UI component
└── tools                       # Test and simulation tools (simulator projects and resource files)
    └── qt                      # Qt project

Constraints

Platform Constraints

  • The Windows platform supports only Qt and OHOS IDE.
  • For the support of other platforms, see the graphic tag in vendor/hisilicon/[product_name]/config.json. If the graphic tag does not exist, it indicates that the product does not have the graphics subsystem.

Compilation and Building

# Generate the libui.so file in the out directory of the product folder through GN compilation.
hb build -T //foundation/arkui/ui_lite:ui_lite -f  #build libui.so
hb build -T //foundation/indow/window_manager_lite/test:sample_ui -f # build UI demo
hb build -T //foundation/arkui/ui_lite/test/unittest:arkui_ui_lite_test -f # build TDD testcases

# To compile the Qt library, see the Qt simulator project at arkui/ui_lite/tools/qt/simulator/simulator.pro.

Description

Component Description

Components are classified into basic components and container components.

  • Basic components: Implement only a single function, such as Text, Button, Image, and List.
  • Container components: Hold and combine child components to implement complex functions.

Figure 2 Graphics subsystem components

Usage

For details about how to use components and APIs of graphics, see the examples provided in foundation/arkui/ui_lite/test/uitest.

  • The Qt project can be debugged in the Windows environment. User Guide

    Project file path:

    arkui/ui_lite/tools/qt/simulator/simulator.pro
  • For other debugging environments, you can run foundation/window/window_manager_lite/test:sample_ui.

    After the building is successful, the executable program out/[product_name]/dev_tools/bin/sample_ui is obtained. You can run the program in an environment to view the display effect of a specific component.

Repositories Involved

Graphic subsystem

graphic_wms

graphic_surface

graphic_ui

graphic_utils

1
https://gitee.com/openharmony/graphic_ui.git
git@gitee.com:openharmony/graphic_ui.git
openharmony
graphic_ui
graphic_ui
master

搜索帮助