2021-02-24 10:59:10 +08:00
|
|
|
|
|
|
|
|
|
## ZLG AWTK 1.6 Release Notes
|
|
|
|
|
|
|
|
|
|
## 一、介绍
|
|
|
|
|
|
|
|
|
|
[AWTK](README.md) 全称 Toolkit AnyWhere,是 [ZLG](http://www.zlg.cn/) 开发的开源 GUI 引擎,旨在为嵌入式系统、WEB、各种小程序、手机和 PC 打造的通用 GUI 引擎,为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。
|
|
|
|
|
|
|
|
|
|
> 欢迎广大开发者一起参与开发:[生态共建计划](docs/awtk_ecology.md)。
|
|
|
|
|
|
|
|
|
|
#### [AWTK](README.md) 寓意有两个方面:
|
|
|
|
|
|
|
|
|
|
* Toolkit AnyWhere。
|
|
|
|
|
* ZLG 物联网操作系统 AWorksOS 内置 GUI。
|
|
|
|
|
|
|
|
|
|
#### [AWTK](README.md) 源码仓库:
|
|
|
|
|
|
|
|
|
|
* 主源码仓库:[https://github.com/zlgopen/awtk](https://github.com/zlgopen/awtk)
|
|
|
|
|
* 镜像源码仓库:[https://gitee.com/zlgopen/awtk](https://gitee.com/zlgopen/awtk)
|
|
|
|
|
|
|
|
|
|
#### AWTK Designer 界面设计工具:
|
|
|
|
|
|
|
|
|
|
* 不再需要手写 XML
|
|
|
|
|
* 拖拽方式设计界面,所见即所得
|
|
|
|
|
* 快速预览,一键打包资源
|
|
|
|
|
* 注册及下载地址:https://awtk.zlg.cn
|
|
|
|
|
|
|
|
|
|
![AWTK Designer](../images/designer.png)
|
|
|
|
|
|
|
|
|
|
#### 运行效果截图:
|
|
|
|
|
|
|
|
|
|
![Chart-Demo](../images/chart_main.png)
|
|
|
|
|
|
|
|
|
|
![MusicPlayer-Demo](../images/musicplayer_main.png)
|
|
|
|
|
|
|
|
|
|
![Watch](../images/smartwatch_main.png)
|
|
|
|
|
|
|
|
|
|
## 二、最终目标:
|
|
|
|
|
|
|
|
|
|
* 支持开发嵌入式应用程序。✔
|
|
|
|
|
* 支持开发 Linux 应用程序。✔
|
|
|
|
|
* 支持开发 MacOS 应用程序。✔
|
|
|
|
|
* 支持开发 Windows 应用程序。✔
|
|
|
|
|
* 支持开发 Web APP。✔
|
|
|
|
|
* 支持开发 Android 应用程序。✔
|
|
|
|
|
* 支持开发 iOS 应用程序。✔
|
|
|
|
|
* 支持开发微信小程序。
|
|
|
|
|
* 支持开发支付宝小程序。
|
|
|
|
|
* 支持开发百度小程序。
|
|
|
|
|
* 支持开发 2D 小游戏。
|
|
|
|
|
|
|
|
|
|
## 三、主要特色
|
|
|
|
|
|
|
|
|
|
### 1. 跨平台
|
|
|
|
|
|
|
|
|
|
[AWTK](README.md) 是跨平台的,这有两个方面的意思:
|
|
|
|
|
|
|
|
|
|
* AWTK 本身是跨平台的。目前支持的平台有 ZLG AWorksOS、Windows、Linux、MacOS、嵌入式 Linux、Android、iOS、Web 和嵌入式裸系统,可以轻松的移植到各种 RTOS 上。AWTK 以后也可以运行在各种小程序平台上运行。
|
|
|
|
|
|
|
|
|
|
* AWTK 同时还提供了一套跨平台的基础工具库。其中包括链表、数组、字符串 (UTF8 和 widechar),事件发射器、值、对象、文件系统、互斥锁和线程、表达式和字符串解析等等,让你用 AWTK 开发的应用程序可以真正跨平台运行。
|
|
|
|
|
|
|
|
|
|
### 2. 高效
|
|
|
|
|
|
|
|
|
|
[AWTK](README.md) 通过一系列的手段保证 AWTK 应用程序高效运行:
|
|
|
|
|
|
|
|
|
|
* 通过脏矩算法只更新变化的部分。
|
|
|
|
|
* 支持 3 FrameBuffer 让界面以最高帧率运行 (可选)。
|
2021-05-11 15:50:24 +08:00
|
|
|
|
* UI 描述文件和窗体样式文件使用高效的二进制格式,解析在瞬间完成。
|
2021-02-24 10:59:10 +08:00
|
|
|
|
* 支持各种 GPU 加速接口。如 OpenGL、DirectX、Vulkan 和 Metal 等。
|
|
|
|
|
* 支持嵌入式平台的各种 2D 加速接口。目前 STM32 的 DMA2D 和 NXP 的 PXP 接口,厂家可以轻松扩展自己的加速接口。
|
|
|
|
|
|
|
|
|
|
### 3. 稳定
|
|
|
|
|
|
|
|
|
|
[AWTK](README.md) 通过下列方式极力让代码稳定可靠:
|
|
|
|
|
|
|
|
|
|
* 使用 cppcheck 和 facebook infer 进行静态检查。
|
|
|
|
|
* 使用 valgrind 进行动态内存检查。
|
|
|
|
|
* 近两万行的单元测试代码。
|
|
|
|
|
* ZLG 强大 GUI 团队的支持。
|
|
|
|
|
* 经过多个实际项目验证。
|
|
|
|
|
* 多平台 / 多编译器验证。
|
|
|
|
|
* 优秀的架构设计。
|
|
|
|
|
* Code Review。
|
|
|
|
|
* 手工测试。
|
|
|
|
|
|
|
|
|
|
### 4. 强大
|
|
|
|
|
|
|
|
|
|
* 丰富的控件 (持续增加中)。
|
|
|
|
|
* 支持各种图片格式 (png/jpg/gif/svg)。
|
|
|
|
|
* 支持各种字体格式 (点阵和矢量)。
|
|
|
|
|
* 支持窗口动画。
|
|
|
|
|
* 支持控件动画。
|
|
|
|
|
* 支持高清屏。
|
|
|
|
|
* 支持界面描述文件。
|
2021-05-11 15:50:24 +08:00
|
|
|
|
* 支持窗体样式描述文件。
|
2021-02-24 10:59:10 +08:00
|
|
|
|
* 主题切换实时生效。
|
|
|
|
|
* 支持控件布局策略。
|
|
|
|
|
* 支持对话框高亮策略。
|
|
|
|
|
* 丰富的辅助工具。
|
|
|
|
|
* 支持从低端的 Cortex M3 到各种高端 CPU。
|
|
|
|
|
* 支持无文件系统和自定义的文件系统。
|
|
|
|
|
* 支持裸系统和 RTOS。
|
|
|
|
|
* 支持事件录制与重放进行压力测试。
|
|
|
|
|
* 支持 Appium 进行全自动化 UI 测试。
|
|
|
|
|
|
|
|
|
|
### 5. 易用
|
|
|
|
|
|
|
|
|
|
* 大量的示例代码。
|
|
|
|
|
* 完善的 API 文档和使用文档。
|
|
|
|
|
* ZLG 强大的技术支持团队。
|
|
|
|
|
* 用 AWTK 本身开发的 [界面编辑器](https://awtk.zlg.cn)。
|
|
|
|
|
* 声明式的界面描述语言。一行代码启用控件动画,启用窗口动画,显示图片 (png/jpg/svg/gif)。
|
|
|
|
|
|
|
|
|
|
### 6. 高度扩展性
|
|
|
|
|
|
|
|
|
|
* 可以扩展自己的控件。
|
|
|
|
|
* 可以扩展自己的动画。
|
|
|
|
|
* 可以实现自己的主循环。
|
|
|
|
|
* 可以扩展自己的软键盘。
|
|
|
|
|
* 可以扩展自己的图片加载器。
|
|
|
|
|
* 可以扩展自己的字体加载器。
|
|
|
|
|
* 可以扩展自己的输入法引擎。
|
|
|
|
|
* 可以扩展自己的控件布局算法。
|
|
|
|
|
* 可以扩展自己的对话框高亮策略。
|
|
|
|
|
* 可以实现自己的 LCD 接口。
|
|
|
|
|
* 可以扩展自己的矢量引擎 (如使用 skia/cairo)。
|
|
|
|
|
* 所有扩展组件和内置组件具有相同的待遇。
|
|
|
|
|
|
|
|
|
|
### 7. 多种开发语言
|
|
|
|
|
|
|
|
|
|
[AWTK](README.md) 本身是用 C 语言开发的,可以通过 IDL 生成各种脚本语言的绑定。生成的绑定代码不是简单的把 C 语言的 API 映射到脚本语言,而是生成脚本语言原生代码风格的 API。目前支持以下语言 (以后根据需要增加):
|
|
|
|
|
|
|
|
|
|
* C
|
|
|
|
|
* C++
|
|
|
|
|
* lua
|
|
|
|
|
* java
|
|
|
|
|
* python
|
|
|
|
|
* Javascript on jerryscript
|
|
|
|
|
* Javascript on nodejs
|
|
|
|
|
* Javascript on quickjs
|
|
|
|
|
|
|
|
|
|
### 8. 国际化
|
|
|
|
|
|
|
|
|
|
* 支持 Unicode。
|
|
|
|
|
* 支持输入法。
|
|
|
|
|
* 支持字符串翻译 (实时生效)。
|
|
|
|
|
* 支持图片翻译 (实时生效)。
|
|
|
|
|
* 文字双向排版。
|
|
|
|
|
|
|
|
|
|
### 9. 为嵌入式软件定制的 MVVM 框架,彻底分离用户界面和业务逻辑。
|
|
|
|
|
* 性能高。
|
|
|
|
|
* 内存开销小。
|
|
|
|
|
* 隔离更彻底。
|
|
|
|
|
* 可移植到其它 GUI。
|
|
|
|
|
* 代码小 (~5000 行)。
|
|
|
|
|
* 无需学习 AWTK 控件本身的 API。
|
|
|
|
|
* 支持多种编程语言(目前支持 C/JS)。
|
|
|
|
|
|
|
|
|
|
> 详情请参考:https://github.com/zlgopen/awtk-mvvm
|
|
|
|
|
|
|
|
|
|
### 10. 开放源码,免费商用 (LGPL)。
|
|
|
|
|
|
|
|
|
|
## 四、1.6 版本更新
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
### 1. 细节完善
|
|
|
|
|
* rich text 增加 yslidable 属性。
|
|
|
|
|
* text\_selector 控件增加循环显示功能。
|
|
|
|
|
* 进度条增加 reverse 属性,用于反向显示进度。
|
|
|
|
|
* overlay 窗口支持 always\_on\_top 属性。
|
|
|
|
|
* image\_animation 支持运行时修改 interval。
|
|
|
|
|
* label 增加 line\_wrap 属性 和 word\_wrap 属性。
|
|
|
|
|
* EVT\_VALUE\_WILL\_CHANGE 事件返回 RET\_STOP 可以阻止修改值
|
|
|
|
|
* 增加 TK\_KEY\_LONG\_PRESS\_TIME,让触屏长按和键盘长按可以设置为不同的时间。
|
|
|
|
|
* mledit 增加 open\_im\_when\_focused 和 close\_im\_when\_blured 属性。
|
|
|
|
|
* overlay 增加 click\_throgh 属性,允许 overlay 窗口在没点击到子控件时,穿透到底层窗口。
|
|
|
|
|
|
|
|
|
|
> 大量细节完善去请参考: https://github.com/zlgopen/awtk/blob/master/docs/changes.md
|
|
|
|
|
|
|
|
|
|
### 2. 新增文档
|
|
|
|
|
* 《如何将生成的可执行文件和资源打包》
|
|
|
|
|
* 《如何在打开新窗口时关闭当前窗口?》
|
|
|
|
|
* 《如何设置当前的语言?》
|
|
|
|
|
* 《如何将板子键盘的键值映射到 AWTK?》
|
|
|
|
|
* 《如何定制软键盘/候选字的风格?》
|
|
|
|
|
* 《fscript widget 扩展函数》
|
|
|
|
|
* 《value 扩展函数》
|
|
|
|
|
* 《object 扩展函数》
|
|
|
|
|
* 《app\_conf 扩展函》数
|
|
|
|
|
* 《CRC 扩展函数》
|
|
|
|
|
* 《大端小端扩展模块》
|
|
|
|
|
* 《JSON 扩展模块》
|
|
|
|
|
* 《文件系统扩展模块》
|
|
|
|
|
* 《日期和时间扩展模块》
|
|
|
|
|
* 《读缓冲区扩展模块》
|
|
|
|
|
* 《istream 扩展模块》
|
|
|
|
|
* 《TCP/UDP 流扩展模块》
|
|
|
|
|
* 《文件流扩展模块》
|
|
|
|
|
* 《串口流扩展模块》
|
|
|
|
|
* 《动态数组扩展模块》
|
|
|
|
|
* 《ostream 扩展模块》
|
|
|
|
|
* 《typed array 扩展模块》
|
|
|
|
|
* 《写缓冲区扩展模块》
|
|
|
|
|
* 《读缓冲区扩展模块》
|
|
|
|
|
* 《应用程序的类型》
|
|
|
|
|
|
|
|
|
|
### 3. 新增特性
|
|
|
|
|
* 支持长按键事件。
|
|
|
|
|
* 增加 url 解析器。
|
|
|
|
|
* 增加插件管理器。
|
|
|
|
|
* 增加 csv file库。
|
|
|
|
|
* 水平视图支持按页滚动。
|
|
|
|
|
* 增加脚本引擎 fscript。
|
|
|
|
|
* android 增加 BLE 插件。
|
|
|
|
|
* 支持将多张图片打包成一张图片。
|
|
|
|
|
* 支持多点手势识别事件(旋转和缩放)。
|
|
|
|
|
* 增加根据子控件以及文本调整空间自身大小
|
|
|
|
|
* 支持自动根据屏幕大小自动缩放控件的位置和大小。
|
|
|
|
|
|
|
|
|
|
### 4. 新增重要 API
|
2021-03-03 09:06:49 +08:00
|
|
|
|
* 增加 str\_encode\_hex
|
|
|
|
|
* 增加 data\_reader\_mem
|
|
|
|
|
* 增加 data\_writer\_wbuffer
|
|
|
|
|
* 增加 conf\_ini\_create
|
|
|
|
|
* 增加 conf\_json\_create
|
|
|
|
|
* 增加 conf\_ubjson\_create
|
|
|
|
|
* 增加 timer\_resume/timer\_suspend
|
2021-02-24 10:59:10 +08:00
|
|
|
|
* 增加 window\_manager\_switch\_to
|
2021-03-03 09:06:49 +08:00
|
|
|
|
* 增加 fs\_copy\_file、fs\_copy\_dir和dir\_exist
|
2021-02-24 10:59:10 +08:00
|
|
|
|
* 增加 fs\_get\_temp\_path、fs\_remove\_dir\_r、fs\_create\_dir\_r 和 fs\_change\_dir
|
|
|
|
|
|
|
|
|
|
### 5. 新增控件
|
|
|
|
|
|
|
|
|
|
* [垂直文本](https://github.com/zlgopen/awtk-widget-vlabel)
|
|
|
|
|
|
|
|
|
|
![](https://github.com/zlgopen/awtk-widget-vlabel/raw/master/docs/images/ui.jpg)
|
|
|
|
|
|
|
|
|
|
### 6. 新增相关项目
|
|
|
|
|
|
|
|
|
|
* 增加 [vscode 实时预览插件](https://github.com/zlgopen/awtk-vscode-plugin)。
|
2021-02-25 16:03:46 +08:00
|
|
|
|
* 增加录音功能[awtk-media-player](https://github.com/zlgopen/awtk-media-player)
|
|
|
|
|
* 增加 [awtk-openxlsx](https://github.com/zlgopen/awtk-openxlsx)
|
2021-02-24 10:59:10 +08:00
|
|
|
|
|
|
|
|
|
> 欢迎广大开发者一起参与开发:[生态共建计划](../awtk_ecology.md)。
|