test/awtk
1
0
Fork 0
mirror of https://gitee.com/zlgopen/awtk.git synced 2024-11-30 02:58:26 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
83de1b9763
awtk/README.md
xianjimli 83de1b9763 update README
2018-10-18 14:00:18 +08:00

21 KiB
Executable File
Raw Blame History

AWTK = Toolkit AnyWhere

AWTK是吸取了FTK和CanTK的精华，重新开发的GUI，计划分以下几个阶段实施：

  • 第一阶段专注于嵌入式系统，到达并超越TouchGfx/Embedded Wizard的功能。计划在2018/9底完成。
  • 第二阶段用AWTK本身开发界面编辑器(或组态软件IDE)，从而验证AWTK支持PC软件开发的能力。计划在2018年底完成。
  • 第三阶段支持Mobile应用程序开发，这一步比较容易，因为在第一阶段就是要把手机上的现代GUI推广到传统嵌入式系统中去。计划在2019/3完成。
  • 第四阶段支持2D游戏开发，把以前开发游戏引擎的经验融合到AWTK中，方便开发交互式的多媒体应用。计划在2019/6完成。

最终目标：

  • 支持开发嵌入式软件。
  • 支持开发Linux应用程序。
  • 支持开发MacOS应用程序。
  • 支持开发Windows应用程序。
  • 支持开发Android应用程序。
  • 支持开发iOS应用程序。
  • 支持开发2D游戏。

其主要特色有：

  1. 小巧。在精简配置下，不依赖第三方软件包，仅需要8K RAM+32K FLASH即可开发一些简单的图形应用程序。

  2. 高效。采用脏矩形裁剪算法，每次只绘制和更新变化的部分，极大提高运行效率和能源利用率。

  3. 稳定。通过良好的架构设计和编程风格、单元测试、动态(valgrind)检查和Code Review保证其运行的稳定性。

  4. 丰富的GUI组件。提供窗口、对话框和各种常用的组件(用户可以配置自己需要的组件，降低对运行环境的要求)。

  5. 支持多种字体格式。内置位图字体(并提供转换工具)，也可以使用stb_truetype或freetype加载ttf字体。

  6. 支持多种图片格式。内置位图图片(并提供转换工具)，也可以使用stb_image加载png/jpg等格式的图片。

  7. 紧凑的二进制界面描述格式。可以手工编辑的XML格式的界面描述文件，也可以使用Qt Designer设计界面，然后转换成紧凑的二进制界面描述格式，提高运行效率，减小内存开销。

  8. 支持主题并采用紧凑的二进制格式。开发时使用XML格式描述主题，然后转换成紧凑的二进制格式，提高运行效率，减小内存开销。

  9. 支持裸系统，无需OS和文件系统。字体、图片、主题和界面描述数据都编译到代码中，以常量数据的形式存放，运行时无需加载到内存。

  10. 内置nanovg实现高质量的矢量动画。

  11. 支持窗口动画、控件动画、滑动动画和高清LCD等现代GUI常见特性。

  12. 支持国际化(Unicode、字符串翻译和输入法等)。

  13. 可移植。支持移植到各种RTOS和嵌入式Linux系统，并通过SDL在各种流行的PC/手机系统上运行。

  14. 脚本化。从API注释中提取API的描述信息，通过这些信息可以自动生成各种脚本的绑定代码。

  15. 支持硬件2D加速(目前支持STM32的DMA2D和NXP的PXP)和GPU加速(OpenGL/OpenGLES)，充分挖掘硬件潜能。

  16. 采用LGPL协议开源发布，在商业软件中使用时无需付费。

目前核心功能已经完成，内部开始在实际项目中使用了，欢迎有兴趣的朋友评估和尝试，期待您的反馈。

模拟运行：

Mac

如果没有安装scons和sdl2，请在终端运行下面的命令(假定已安装brew)：

brew install scons sdl2

编译运行(在终端下，进入awtk所在的目录，并运行下列命令)：

scons
./bin/demoui

Ubuntu

如果没有安装scons和依赖的软件包，请在终端运行下面的命令：

sudo apt-get install scons libsndio-dev libgtk-3-dev libglu1-mesa libglu1-mesa-dev libgl1-mesa-glx libgl1-mesa-dev

编译运行(在终端下，进入awtk所在的目录，并运行下列命令)：

scons
./bin/demoui

Windows

(请先安装python2.7，scons和Visual Studio C++(版本>=2015)

编译运行(在命令行模式下，进入awtk所在的目录，并运行下列命令)：

scons
bin\demoui

演示视频

1.基本控件演示

各个平台的移植

官方支持平台

移植示例(不定期更新)

各语言的绑定

相关工程

文档

1.使用文档

2.HowTos

3.内部原理

4.移植文档

5.技术笔记

6.其它

任务完成情况

TODO.md

最新动态

  • 2018/10/18

    • 修改控件状态问题（在特殊情况下，mouse重新进入控件，状态没有改变）。
    • 修改MacOS升级后，打开窗口瞬间出现黑屏的问题。
    • 修改SDL+FB模式下刷新的问题。
    • 修改Windows下Mutex实现的BUG。
    • 增加文档。

  • 2018/10/17

    • 完善和重构bitmap、图片加载和图片数据生成等代码。
    • calibration控件支持设置点击事件处理的回调函数。

  • 2018/10/16

    • 完善图片控件。绘制带缩放和旋转的图片时，不用WTIH_VGCANVS宏，而根据get_vgcanvas是否为空来判断。
    • 同步同事改进的SDL，Windows10/Linux支持高清屏。
    • 更新文档。

  • 2018/10/15

    • 用agg实现nanovg的渲染后端。
    • 更新文档、编译脚本并测试。

  • 2018/10/14

    • 用agg实现nanovg的渲染后端。

  • 2018/10/13

    • 重新整理第三方库。
    • 集成修改过的SDL(Linux/Winodws支持高清屏)。

  • 2018/10/12

    • 增加大字体demo。
    • 修改文本垂直居中的问题。

  • 2018/10/11

    • 完善Qt UI文件转换工具。
    • 更新文档。
    • 优化。

  • 2018/10/9-10

    • 重构lcd_mem和blend，用代码产生器生成各种格式的代码。
    • 增加测试代码。
    • 更新相关工程。

  • 2018/10/8

    • 修改ui_loader_xml，特殊属性优先设置。

  • 2018/10/7

    • 更新文档。

  • 2018/10/4

    • 完善内存管理，并增加内存泄露跟踪功能。
    • 增加内存需求评估文档。
    • 增加电阻屏校准窗口。

  • 2018/10/2-3

    • 移植到sylixos

  • 2018/10/1

    • 重构
    • 修改编译警告
    • 更新文档

  • 2018/09/30

    • lcd_reg支持RGB565的图片。

  • 2018/09/28

    • 实现image_animation控件并增加demo。

  • 2018/09/27

    • 实现开关控件并增加demo。

  • 2018/09/26

    • 完善text_selector控件并增加demo。
    • 完善vgcanvas，增加paint接口。

  • 2018/09/25

    • 完成text_selector控件基本功能。

  • 2018/09/24

    • 更新文档。

  • 2018/09/23

    • 更新各个项目的工程。

  • 2018/09/21-22

    • 移植awtk到stm32f767开发板。

  • 2018/09/20

    • 移植nanovg-agge到stm32和aworks。

  • 2018/09/12-19

    • 基于agge用纯软件实现nanovg的渲染接口，去掉对cairo/agg/piccaso的依赖，以最少的代码实现vgcanvas的接口。
    • 完善vgcanvas-nanovg支持基于OpenGL和纯软件两种实现。

  • 2018/09/11

    • awtk-linux-fb在IM287A上测试通过。

  • 2018/09/10

    • awtk-linux-fb支持linux fb设备.

  • 2018/09/09

    • awtk-linux-fb支持linux tslib设备.

  • 2018/09/08

    • awtk-linux-fb支持linux input设备.

  • 2018/09/07

    • 录了一些演示视频，给不方便编译的朋友了解AWTK。

  • 2018/09/06

    • 移植到linux framebuffer

  • 2018/09/05

    • 增加guage控件。
    • 完善time_clock控件。

  • 2018/09/04

    • 修改cairo在arm平台上图片显示的问题(stack size需要32K)

  • 2018/09/03

    • 移植cairo到arm平台(基本绘图功能正常，图片和字体还不行)。

  • 2018/09/02

    • 基于cairo实现vgcanvas.

  • 2018/09/01

    • 移植cairo。

  • 2018/08/31

    • 移植pixman。

  • 2018/08/30

    • 更新stm32相关工程。

  • 2018/08/29

    • 完善str类，增加str_insert/str_remove等函数。
    • 完善path类，增加path_replace_basename等函数。
    • ui描述文件支持include指令，方便包含公共组件(请参考：demos/assets/raw/ui/tab_top.xml)。

  • 2018/08/28

    • 完善demos，运行双击直接运行demos。
    • 完善preview_ui，支持在命令行指定宽度和高度。
    • 增加文档。

  • 2018/08/27

    • 增加skia的编译脚本。

  • 2018/08/26

    • 增加path.c/path.h提供基本的目录操作函数。

  • 2018/08/25

    • 增加文件系统的接口和posix的实现。

  • 2018/08/24

    • 整理awtk的目录结构，把部分控件移到ext_widgets目录下。
    • 修改stm32编译的问题。

  • 2018/08/23

    • 完善Color Picker控件。
    • 增加Color Picker控件Demos。
    • 支持mutable的图片。

  • 2018/08/22

    • 增加Color Tile控件。

  • 2018/08/21

    • 增加Color Picker控件。

  • 2018/08/20

    • 更新文档。

  • 2018/08/19

  • 2018/08/18

    • 更新stm32相关工程。

  • 2018/08/17

    • 修改AWTK开发桌面软件的一些问题。

  • 2018/08/16

    • 新增awtk-c-demos仓库，存放c语言的示例。

  • 2018/08/15

    • javascript绑定原理文档。

  • 2018/08/14

    • 增加javascript demos。

  • 2018/08/13

    • 增加javascript demos。
    • 修改lua/javascript回调函数泄露的问题。

  • 2018/08/11

    • awtk.ts 代码产生器。

  • 2018/08/10

    • 完善jerryscript绑定代码生成器。

  • 2018/08/09

    • jerryscript绑定代码生成器。

  • 2018/08/08

    • 为每类控件增加Cast函数，方便脚本绑定。

  • 2018/08/07

    • 完善API docs
    • 完善awtk-lua。

  • 2018/08/06

    • 完善API docs
    • lua绑定放入独立的项目awtk-lua。

  • 2018/08/05

    • 重写IDL生成工具。

  • 2018/08/04

    • 用valgrind运行单元测试，并修改发现的BUG。

  • 2018/08/03

    • 修改linux下编译的问题。

  • 2018/08/02

    • 完善api docs，增加annotation。

  • 2018/08/01

    • 重构widget。

  • 2018/07/31

    • 完善rich_text控件并增加DEMO。

  • 2018/07/29

    • 完善rich_text控件。

  • 2018/07/28

    • 增加rich_text控件(未完成)。

  • 2018/07/27

    • 增加unicode linebreak。
    • 增加rich_text_parser。

  • 2018/07/26

    • 增加combo_box/combo_box_item控件和demo。

  • 2018/07/25

    • 增加popup窗口。

  • 2018/07/24

    • 完善tab_control及demo。

  • 2018/07/23

    • 增加tab_control的demo。

  • 2018/07/22

    • 实现tab_button/tab_button_group/tab_control。

  • 2018/07/20

    • 增加EVT_POINTER_DOWN_ABORT，修改ScrollView中ListItem/CheckButton/Button在滚动时被误点的问题。

  • 2018/07/19

    • 主题支持设置图标的位置，增加一些demo。

  • 2018/07/18

    • image 支持可选中和可点击属性。

  • 2018/07/17

    • widget支持自定义属性。
    • 出于易用性考虑，style_name改为字符串格式。

  • 2018/07/15

    • 实现widget_to_xml。

  • 2018/07/14

    • 增加ui_xml_writer
    • 增加ui_binary_writer
    • 实现widget_clone/widget_equal。

  • 2018/07/13

    • 在widget vtable中增加create/properies方便实现clone。
    • 重构widget

  • 2018/07/12

    • 重新整理grab/ungrab的流程。
    • 修改关闭窗口的BUG。

  • 2018/07/11

    • LCD 增加flush接口。
    • 完善图片绘制接口，增加相应demo。
    • 在Windows 7上，如果显卡太旧不支持OpenGL3时，触发assert。

  • 2018/07/10

    • 框架支持滚轮事件。
    • ListView和SpinBox支持滚轮事件。

  • 2018/07/09

    • 按钮支持repeat触发click事件，键盘和滚动条支持repeat触发。
    • keyboard点击return时提交之前输入的键值。
    • 滚动条支持禁止滚动效果。
    • ListView支持自动隐藏滚动条。

  • 2018/07/08

    • 更新文档，修改三个framebuffer的旋转时的BUG。

  • 2018/07/07

    • 支持online framebuffer, offline framebuffer和next framebuffer三个framebuffer的工作方式。

  • 2018/07/06

    • 支持双framebuffer交换。

  • 2018/07/05

    • 增加ListView和ListView Demo。

  • 2018/07/04

    • 增加ScrollView。

  • 2018/07/03

    • 更新awtk on aworks rt1052，集成硬件加速。

  • 2018/07/02

    • 实现scrollbar控件。

  • 2018/07/01

    • 实现drager控件。

  • 2018/06/30

    • 实现spinbox控件。

  • 2018/06/29

    • 改进edit。
    • 增加edit的demo。
    • theme支持border的类型。

  • 2018/06/28

    • 修改脏矩形等BUG。
    • 修改ubuntu 18上编译的问题。
    • 重构widget。

  • 2018/06/27

    • 实现输入法的联想字功能。

  • 2018/06/26

    • 更新aworks工程并测试。
    • 增加小工具用于生成输入法联想词库。

  • 2018/06/25

    • 完善候选字控件。
    • 编写输入法文档。

  • 2018/06/24

    • 集成google拼音输入法(输入法字体和完整的字体，需要4M的flash空间)。

  • 2018/06/23

    • 引入输入法引擎接口。
    • 增加候选字控件。

  • 2018/06/22

    • 完善软键盘。
    • 修改一些BUG。

  • 2018/06/21

    • 输入框被软键盘覆盖时上推窗口。
    • 接入原生输入法(目前没有中文字体，编辑器中显示为空白)。

  • 2018/06/20

    • 更新lua绑定及示例。
    • 优化软键盘并增加动画。
    • 更新stm32f103/f429的工程。

  • 2018/06/19

    • 实现输入法框架。
    • 实现软键盘基本功能。

  • 2018/06/18

    • 实现软键盘部分功能。
    • 完善现有代码。

  • 2018/06/17

    • 增强layout的功能。
    • 修改XML UI/String文件中不能处理特殊字符的问题。

  • 2018/06/16

    • demoui增加预加载资源的窗口。
    • 增加widget_factory，UI文件支持自定义的控件。

  • 2018/06/15

    • 每个窗口支持独立的主题文件。
    • 修改F429上图片显示不正常的BUG。

  • 2018/06/14

    • LCD FrameBuffer模式支持屏幕90度旋转。
    • 统一图片操作的硬件和软件实现方式。

  • 2018/06/13

    • 集成RT1052 PXP硬件加速到Aworks。

  • 2018/06/11

    • 增加显示FPS的开关。

  • 2018/06/10

    • 优化窗口动画。
    • 完善lcd的接口。
    • 完善资源管理。

  • 2018/06/09

    • 修改stb_image/stb_truetype在开发板不工作的问题(内存分配/stack大小)。
    • 图片加载支持bgra/rgb565格式。
    • 修stm32_g2d中blend_image的BUG。

  • 2018/06/08

    • 修改几个BUG。
    • 完善demos。

  • 2018/06/07

    • slide_view实现基本功能。

  • 2018/06/06

    • 增加memset/memcpy速度测试。
    • 增加widget_animator_scroll实现滚动的动画。
    • 增加滑动速度计算。

  • 2018/06/05

    • event结果中增加时间戳。
    • 完善layout参数，支持指定子控件的宽度和高度。

  • 2018/06/04

    • 移植到正点原子号令者开发板。

  • 2018/06/03

    • 把systick作为公共代码放到platform/raw下。
    • 去掉对stdio中部分函数的依赖。
    • 修改匿名union的问题。

  • 2018/06/02

    • 控件动画文档。
    • misc/new实现C++的内存分配。

  • 2018/06/01

    • 修改STM F103ZE JTAG无法下载的问题。
    • 优化lcd_reg.inc
    • STM F103ZE实现获取时间的函数。

  • 2018/05/31

    • 控件支持缩放动画(目前需要OpenGL)。
    • 控件支持旋转动画(目前需要OpenGL)。

  • 2018/05/30

    • 控件支持淡入淡出动画。

  • 2018/05/28

    • aworks平台上的memcpy有问题，暂时使用自定义的memcpy。

  • 2018/05/27

    • 改进lcd_mem的实现，编写部分文档。

  • 2018/05/26

    • 优化图片缩放算法。

  • 2018/05/25

    • 优化填充颜色算法。

  • 2018/05/24

    • 优化soft_g2d。

  • 2018/05/23

    • 移植到aworks平台。

  • 2018/05/18

    • 编写framebuffer的文档。

  • 2018/05/17

    • 支持非GUI线程添加idle/timer到GUI线程执行。

  • 2018/05/16

    • 实现控件动画框架。
    • 实现控件移动位置的动画。
    • 实现控件修改值的动画。

  • 2018/05/15

    • 重新实现timer/idle，支持timer/idle处理函数内部操作timer/idle。

  • 2018/05/14

    • 修改内存管理器的BUG，完善内存管理器的测试程序。

  • 2018/05/13

    • 编写stm32f429igtx移植文档。

  • 2018/05/12

    • lcd 支持double framebuffer，移植到stm32429igtx裸系统。

  • 2018/05/10

    • 为了方便代码管理，把硬件平台相关的代码移到独立的项目中。

  • 2018/05/09

    • 重新整理了基于framebuffer的LCD，并支持硬件加速功能。

  • 2018/05/07

    • 实现STM32的dma2d加速的矩形填充和图片合成。

  • 2018/05/05

    • lftk改名为awtk。

  • 2018/05/03

    • 增加locale，支持多国语言字符串翻译。

  • 2018/05/01

    • 更新文档。

  • 2018/04/30

    • 窗口动画的anim_hint用字符串表示，方便附加参数。

  • 2018/04/29

    • 增加str_t，widget的名称用str_t。

  • 2018/04/28

    • 图片管理器支持缓存。
    • 图片管理器支持根据不同的DPI加载不同的图片。

  • 2018/04/27

    • 资源管理器支持从文件中加载资源。

  • 2018/04/26

    • 增加picasso实现的vgcanvas。
    • 增加system_info

  • 2018/04/21

    • 对话框支持从下往上弹出、从上往下弹出、中心缩放和淡入淡出几种动画。
    • 窗口支持左右平移动画。

  • 2018/04/20

    • 实现窗口动画框架。

  • 2018/04/15

    • 增加nanovg实现的vgcanvas。
    • 增加基于vgcanvas实现的lcd。

  • 2018/04/14

    • PC环境缺省使用SDL2+nanovg渲染，解决在MacOS上文字模糊的问题。
    • 调整lcd的接口，使之具有更强的适应性。

  • 2018/04/8

    • 重新实现dialog的主题。

  • 2018/04/7

    • 增加按键定义。
    • 增加edit控件(未完成)

  • 2018/04/5

    • Slider控件支持step和事件。
    • Slider和ProgressBar支持在主题中设置图片。
    • 因为性能原因，agg中使用float代替double。

  • 2018/04/2

    • 增加Slider控件。

  • 2018/04/1

    • 字体管理器支持TTF字体。
    • 增加工具resgen。
    • 增加主题文档。

  • 2018/03/31

    • 重新设计XML主题的格式。
    • 重构window/button/label/check_buton，使用同一个绘制函数。

  • 2018/03/27

    • Luncher 加入AWTK核心团队。
    • 完善文档。

  • 2018/03/26

    • 主题支持设置背景图片和背景图片的显示方式。

  • 2018/03/25

    • 增加矢量图绘图函数接口，并用agg实现部分功能。

  • 2018/03/24

    • 支持图片居中、缩放、9宫格和平铺等10余种显示方式。

  • 2018/03/18

    • 支持anti-aliasing直线。
    • 重新设计资源管理器。

  • 2018/03/17

    • 支持将Qt的UI文件转成AWTK的UI文件。
    • 支持将VC的RC文件转成AWTK的UI文件。
    • 编写AWTK UI界面描述的文档。
    • 增加事件队列，解决在触屏中断中分发事件的问题。
    • 编写STM32移植文档。

  • 2018/03/11

    • 增加XML界面描述文件预览工具。
    • 支持极速模式(定义FAST_MODE启用)，只绘制顶层的窗口中变化的控件，绘制效率非常高，但不支持透明背景。
    • 支持基本的layout功能。

  • 2018/03/10

    • lua绑定及相关示例完成。
    • 支持从UI描述文件创建界面。