awtk/README.md

AWTK = Toolkit AnyWhere

中文用户请看这里

I. Introduction

AWTK , the abbreviation of Toolkit AnyWhere, is an open source GUI engine developed by ZLG. It is a cross-platform GUI engine for embedded systems, WEB, mini programs, mobile phones and PC. It is a powerful, efficient, reliable and easy-to-use GUI engine for users to design beautiful GUI applications.

Welcome developers to join us in our development:Joint Ecology Building Plan

AWTK has two implications as follows:

• Toolkit AnyWhere.
• As the built-in GUI of AWorksOS, which is the ZLG IoT operating system.

AWTK source code repositories:

• Main source code repository: https://github.com/zlgopen/awtk
• Mirrored source code repository：https://gitee.com/zlgopen/awtk
• Stable version pack: https://pan.baidu.com/s/1_oRgj67M-I4kivk-YzwFWA Access code:1cmi

AWTK Designer - the UI design tool:

• It is no longer necessary to write XML by yourself.
• Design the UI by dragging and dropping. What you see is what you get.
• Support quick preview and pack resources with one-click.
• Registration and download: https://awtk.zlg.cn

Screenshots:

II. Ultimate Objectives

• To support development of embedded applications.✔
• To support development of Linux applications.✔
• To support development of MacOS applications.✔
• To support development of Windows applications.✔
• To support development of Web applications.✔
• To support development of Android applications.✔
• To support development of iOS applications.✔
• To support development of WeChat mini programs.
• To support development of AliPay mini programs.
• To support development of Baidu mini programs.
• To support development of 2D mini games.

III. Main Features

1. Cross-platform

AWTK is a cross-platform GUI engine , which has two meanings as follows:

• AWTK's code is cross-platform. At present, it is compatible with platforms such as ZLG AWorksOS, Windows, Linux, MacOS, embedded Linux, Android, iOS, Web and embedded raw systems. It can be easily ported to variety of different RTOS. In the future, AWTK can be also run as mini programs.

• In addition, AWTK has a cross-platform library of basic tools, which includes lists, arrays, strings (UTF8 and widechar), event emitters, values, objects, file system, mutex, threads, formulas and string analysis, in order that the applications you develop with AWTK can really run across platforms.

2. Efficient

AWTK ensure efficiency through the following operations:

• Update changed parts using dirty rectangles algorithms.
• Support 3 FrameBuffer to make the UI run at the highest frame rate (optional).
• UI description files and theme files are stored in efficient binary formats, in order that they can be analyzed more fast.
• Support different GPU acceleration interfaces, including OpenGL, DirectX, Vulkan and Metal and so on.
• Support 2D acceleration interfaces of embedded platforms, such as NXP's PXP interfaces and STM32's DMA2D interfaces, user can easy to adapt to other acceleration interfaces.

3. Stable

AWTK makes codes as stable and reliable as possible in following ways:

• Perform static checks using cppcheck and facebook infer.
• Dynamically check memory with valgrind.
• With approximately 20,000 lines of codes for unit testing.
• With support from the powerful GUI team of ZLG.
• Has been validated in multiple practical projects.
• Has been validated by multiple platforms and compilers.
• With excellent architecture design.
• Code Review.
• Manual test.

4. Powerful

• Abundant widgets (being add more widgets).
• Support multiple image formats (png/jpg/gif/svg).
• Support multiple font formats (bitmap and vector fonts).
• Support window animation function.
• Support widget animation function.
• Support HD screen.
• Support UI layout description file.
• Support UI theme file.
• Support switch themes in runtime.
• Support custom rule for widget layout.
• Support custom rule for highlighting dialogs.
• With many auxiliary tools.
• Support different CPU from low-end (such as Cortex M3) to high-end.
• Support no-filesystem platform and custom filesystem.
• Support raw systems platform and RTOS.

5. Easy-to-use

• With many demonstration codes.
• With complete API document and user guide document.
• With technical support from the powerful team of ZLG.
• With the UI designer, which also developed with AWTK (https://awtk.zlg.cn).
• Use declarative UI description language. user can enable widget animation, window animation, and image display (png/jpg/svg/gif) with one line code.

6. Customizable

• Support extend custom widgets.
• Support extend custom animations.
• Support implement custom main loop.
• Support extend custom soft keyboard.
• Support extend custom image loader.
• Support extend custom font loader.
• Support extend custom input method engine.
• Support extend custom layout algorithms for widgets.
• Support extend custom rule for highlighting dialogs.
• Support implement custom LCD interface.
• Support extend custom vector engines (e.g.skia/cairo).
• All extended and built-in widgets are treated the same.

7. Multiple Development Languages

AWTK is been developed in the C Program Language. Scripts in different languages can be generated by the IDL. The binding code generated not only simply mapping the C API to the target script language, but also with the native code styles of the target script language. At present, following languages are supported (More languages will be added):

• C
• Go
• C++
• lua
• java
• python
• Javascript on jerryscript
• Javascript on nodejs
• Javascript on quickjs

8. Internationalization

• Support Unicode.
• Support input methods.
• Support translate strings.
• Support translate images.
• Support text bidirectional algorithms.

9. The MVVM framework for embedded software thoroughly separate user interfaces from business logic

• High performances.
• Low memory usage.
• More thorough isolation.
• Portable to other GUI.
• Less codes (~5,000 lines).
• No need for learning API of AWTK.
• Support multiple programming languages (support C/JS at present).

For details, please see https://github.com/zlgopen/awtk-mvvm

10. Open source codes are freely available for commercial purposes (LGPL)

IV. Simulation Run

Code Downloading

• Download with git

Git under Windows

Code Downloading

git clone https://github.com/zlgopen/awtk.git

Under Windows, codes can be downloaded by git with GUI tool.

Code Updating (in the awtk directory)

git pull

The advantage of using Git is that it is very convenient to update the code later.

• Directly download the zip file.

Download the zip file. Once unzipped, the file shall be renamed awtk.

Mac

If nodejs, scons and sdl2 aren't installed, please run the following command in the terminal (assuming that brew has been installed):

brew install scons sdl2 node

Compile and run (Enter the directory where awtk is and run the following command in the terminal):

scons
./bin/demoui

Ubuntu （version >=16)

If scons and the dependent software pack aren't installed, please run the following command in the terminal:

sudo apt-get install gcc g++ scons libsndio-dev libgtk-3-dev libglu1-mesa libglu1-mesa-dev libgl1-mesa-glx libgl1-mesa-dev libasound2-dev libibus-1.0-dev fcitx-libs-dev git vim clang-format libharfbuzz-dev nodejs libreadline-dev

Compile and run (Enter the awtk directory and run the following command in the terminal):

scons
./bin/demoui

If it can't be run in Ubuntu 14, please refer to FAQ.

Windows

Please install python (64-bit python shall be installed for a 64-bit system), scons and Visual Studio C++ (version>=2017) first.

If pywin32 isn't installed, please use pip to install:

pip install pywin32

Compile and run (Enter the awtk directory and run the following command in the terminal):

Install nodejs

scons
bin\demoui

for all platforms

If PIL isn't installed, please use pip to install:

pip install Pillow

If nodejs glob isn't installed, please use npm to install:

npm install -g glob

V. Online Demonstration

• Online Demonstration of Basic Widgets

• Graphical Demonstration

• Music Player Demonstration

• Smart Watch Demonstration

VI. Platform Porting

• For details, refer to the Joint Ecology Building Plan for AWTK

VII. Language Binding

• AWTK Binding Code Generator

• LUA Binding

• Go Binding

• C++ Binding

• JAVA Binding

• Python Binding

• MiniJVM Binding

• JS-Binding QuickJS

• JS-Binding NodeJS

• JS-Binding JerryScript

VIII. Related Projects

• Template Project

• MVVM Template Project

• awtk-csv-file

• awtk-database-repository

• awtk-sqlite3

• awtk-vscode-plugin

• awtk-restful-httpd

• Auto Test Engine

• Regression Test

• Demonstration Codes with C Program

• Wonderful Examples

• HTTP Client

• AWTK-MVVM

• MVC/MVVM Example Demonstration

• Examples for Custom Widgets: Widget Generator

• Examples for Custom Widgets: QR code

• Examples for Custom Widgets: TinyGL

• Examples for Custom Widgets: Number-label

• Examples for Custom Widgets: Code Editor

• Examples for Custom Widgets: Date Picker

• Examples for Custom Widgets: Table View

• Examples for Custom Widgets: Tree View

• Examples for Custom Widgets: Shape

• Examples for Custom Widgets: HTML View

• Examples for Custom Widgets: ios/android like list item

• Examples for Custom Widgets: VLabel

• Examples for Custom Widgets: rlottie

• Examples for Custom Widgets: rive

• Examples for Custom Font Loader

• Write AWTK App With ReactJS

The third party provides:

• Examples for Custom Widgets: QR code

• Examples for Custom Widgets: Circle Sliders

• Examples for Custom Widgets: Gesture Lock

IX. Documentation

• Development Docs

• Change Logs

• TODO

• Beginners' Guide and Handbook

X. Joint Ecology Building Plan

• Joint Ecology Building Plan
• In-depth Partners

　　　

XI. Developer Community

Welcome any interested developer to evaluate and try to use AWTK. If you have any suggestions or questions about AWTK, please add the WeChat account zlgmcu-888 to enter the AWTK communication group, and ZLG R&D team will answer them for you.