## ZLG AWTK 1.2 Release Notes

## 一、介绍

[AWTK](https://github.com/zlgopen/awtk) 全称 Toolkit AnyWhere，是 [ZLG](http://www.zlg.cn/) 开发的开源 GUI 引擎，旨在为嵌入式系统、WEB、各种小程序、手机和 PC 打造的通用 GUI 引擎，为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎。

#### [AWTK](https://github.com/zlgopen/awtk) 寓意有两个方面：

* Toolkit AnyWhere。 
* ZLG 物联网操作系统 AWorksOS 内置 GUI。

#### [AWTK](https://github.com/zlgopen/awtk) 源码仓库：

* 主源码仓库：[https://github.com/zlgopen/awtk](https://github.com/zlgopen/awtk)
* 镜像源码仓库：[https://gitee.com/zlgopen/awtk](https://gitee.com/zlgopen/awtk)

#### 运行效果截图：

![Chart-Demo](../images/chart_main.png)

![MusicPlayer-Demo](../images/musicplayer_main.png)

## 二、最终目标：

* 支持开发嵌入式应用程序。
* 支持开发 Linux 应用程序。
* 支持开发 MacOS 应用程序。
* 支持开发 Windows 应用程序。
* 支持开发 Web APP。
* 支持开发微信小程序。
* 支持开发支付宝小程序。
* 支持开发百度小程序。
* 支持开发 Android 应用程序。
* 支持开发 iOS 应用程序。
* 支持开发 2D 小游戏。

## 三、主要特色

### 1. 跨平台

[AWTK](https://github.com/zlgopen/awtk) 是跨平台的，这有两个方面的意思：

* AWTK 本身是跨平台的。目前支持的平台有 ZLG AWorksOS、Windows、Linux、MacOS、嵌入式 Linux 和嵌入式裸系统，可以轻松的移植到各种 RTOS 上。AWTK 以后也可以运行在浏览器（即将公测）、各种小程序、Android 和 iOS 等平台上运行。

* AWTK 同时还提供了一套跨平台的基础工具库。其中包括链表、数组、字符串 (UTF8 和 widechar)，事件发射器、值、对象、文件系统、互斥锁和线程、表达式和字符串解析等等，让你用 AWTK 开发的应用程序可以真正跨平台运行。

### 2. 高效

[AWTK](https://github.com/zlgopen/awtk) 通过一系列的手段保证 AWTK 应用程序高效运行：

* 通过脏矩算法只更新变化的部分。
* 支持 3 FrameBuffer 让界面以最高帧率运行（可选）。
* UI 描述文件和窗体样式文件使用高效的二进制格式，解析在瞬间完成。
* 支持各种 GPU 加速接口。如 OpenGL、DirectX、Vulkan 和 Metal 等。
* 支持嵌入式平台的各种 2D 加速接口。目前 STM32 的 DMA2D 和 NXP 的 PXP 接口，厂家可以轻松扩展自己的加速接口。

### 3. 稳定

[AWTK](https://github.com/zlgopen/awtk) 通过下列方式极力让代码稳定可靠：

* 使用 cppcheck 和 facebook infer 进行静态检查。
* 使用 valgrind 进行动态内存检查。
* 近两万行的单元测试代码。
* ZLG 强大 GUI 团队的支持。
* 经过多个实际项目验证。
* 多平台/多编译器验证。
* 优秀的架构设计。
* Code Review。
* 手工测试。

### 4. 强大

* 丰富的控件（持续增加中）。
* 支持各种图片格式 (png/jpg/gif/svg)。
* 支持各种字体格式（点阵和矢量）。
* 支持窗口动画
* 支持控件动画
* 支持高清屏。
* 支持界面描述文件。
* 支持窗体样式描述文件。
* 支持控件布局策略。
* 支持对话框高亮策略。
* 丰富的辅助工具。
* 支持从低端的 Cortex M3 到各种高端 CPU。
* 支持无文件系统和自定义的文件系统。
* 支持裸系统和 RTOS。

### 5. 易用

* 大量的示例代码。
* 完善的 API 文档和使用文档。
* ZLG 强大的技术支持团队。
* 用 AWTK 本身开发的界面编辑器（开发中）。
* 声明式的界面描述语言。一行代码启用控件动画，启用窗口动画，显示图片 (png/jpg/svg/gif)。

### 6. 高度扩展性

* 可以扩展自己的控件。
* 可以扩展自己的动画。
* 可以实现自己的主循环。
* 可以扩展自己的软键盘。
* 可以扩展自己的图片加载器。
* 可以扩展自己的字体加载器。
* 可以扩展自己的输入法引擎。
* 可以扩展自己的控件布局算法。
* 可以扩展自己的对话框高亮策略。
* 可以实现自己的 LCD 接口。
* 可以扩展自己的矢量引擎（如使用 skia/cairo)。
* 所有扩展组件和内置组件具有相同的待遇。

### 7. 多种开发语言

[AWTK](https://github.com/zlgopen/awtk) 本身是用 C 语言开发的，可以通过 IDL 生成各种脚本语言的绑定。生成的绑定代码不是简单的把 C 语言的 API 映射到脚本语言，而是生成脚本语言原生代码风格的 API。目前支持以下语言（以后根据需要增加）：

* C
* Lua
* Javascript on jerryscript
* Javascript on nodejs

### 8. 国际化

* 支持 Unicode。
* 支持输入法。
* 支持字符串翻译（实时生效）。
* 支持图片翻译（实时生效）。
* 文字双向排版（计划中）。

### 9. 开放源码，免费商用 (LGPL)。

## 四、1.2 版本更新
-------------------

### 1. 细节完善
  * 输入法候选字支持滚动。
  * slider 支持上下左右键。
  * guage pointer 支持锚点。
  * slide view indicator作为独立控件。
  * 修改 slider 支持放在 slide\_view 中。
  * 完善 idl gen 工具支持外部项目并编写文档。 
  * 完善 doc gen 工具支持外部项目并编写文档。 
  * 修改 slide\_menu 支持放在 slide\_view 中。
  * edit 在焦点状态时，如果文本为空，仍然显示 tips。
  * button/check\_button 在收到回车和空格键时触发 click 事件。
  * 重构 pointer/key 事件处理流程，分成三个阶段：子控件处理前、子控件和子控件处理后。
  * 重构 image loader 支持自定义的 image loader（使用 imae\_loader\_register 注册自己的 loader)。
  * 因为脚本绑定生成工具只接受一个 IDL 文件，所以增加 merge.js 工具用于将多个 IDL 文件合并成一个 IDL 文件。
  * 支持用 focusable 属性将控件设置可获得焦点，实现 tab stop 类似的效果。focusable 的控件，其 style 必须具有 focused 状态，否则无法显示。
  * 窗口在切换到前台和后台时分别触发事件 EVT\_WINDOW\_TO\_FOREGROUND 和 EVT\_WINDOW\_TO\_BACKGROUND
  * 去掉 TK\_DEFAULT\_FONT 宏定义，提供函数 system\_info\_set\_default\_font 设置缺省字体（一般不用调用）。
  * 将 ListView 的布局策略放到 children\_layouter\_list\_view 中，并支持边距和间距等参数。
  * children\_layouter\_list\_view 增加 keep\_disable 和 keep\_invisible 参数。
  * children\_layouter\_default 增加 keep\_disable 和 keep\_invisible 参数。
  * 缺省启用 style mutable，具体用法请参考窗体样式文档。
  * 增加 style border\_width
  * 支持动态修改屏保时间。
  * 增加 app_root 自动检测。
  * SDL FB 模式启用脏矩形。
  * 新增内存耗尽处理。

### 3. 新增特性
  * cairo 实现的 vgcanvas。
  * 支持 32 位 Windows 编译。
  * 增加条件变量 tk\_cond\_var。
  * 支持用 tab 键切换控件的焦点。
  * 完整弹出窗口动画，支持在不同位置弹出。
  * image/svg/gif 支持从文件系统中加载图片。
  * 增加widget_gen脚本用于生成自定义控件的框架。
  * 增加 self\_layouter\_menu 方便实现弹出菜单。
  * 增加 lcd\_mem\_special 用于实现一些特殊的 FB 格式。
  * style 增加 margin\_left/margin\_right/margin\_top/margin\_bottom 几个参数用于细化之前的 margin 参数。

### 4. 新增控件
  * mledit 多行编辑器。
  * overlay overlay 窗口。
  * hscroll_label 可水平滚动的文本。

### 5. 新增重要 API
  * timer_modify
  * widget\_add\_idle。
  * widget\_find\_animator

### 6.Bug 修改和完善功能

详情请参考 [docs/changes.md](https://github.com/zlgopen/awtk/blob/master/docs/changes.md)。