AWStudio 2 是致远电子推出的全新一体化开发环境,内置升级后的 AWTK Designer 可视化工具,我们可以直接拖拽控件完成界面布局,再搭配 C 语言编写业务逻辑,不用手写大量 XML,就能快速跑通第一个 AWTK-C 嵌入式 GUI 程序,整套流程分为环境准备、新建 AWTK-C 工程、可视化 UI 设计、C 语言事件逻辑编写、本地模拟器调试、资源打包、编译部署这几步,它适合 MCU、Linux 嵌入式设备做人机交互,入门门槛低,新手跟着步骤操作,短时间就能做出带按钮、文本的可运行 GUI 应用。
一、前期环境准备清单
| 项目 | 说明 |
|---|---|
| 软件安装包 | AWStudio 2,从 AWTK 官方下载 Windows 版本,安装完成后自带 AWTK SDK、模拟器、编译器、Designer 工具 |
| 基础储备 | C 语言基础,了解控件、事件回调、窗口这些 GUI 基础概念 |
| 可选配套 | VSCode,用来辅助编辑 C 源码;硬件(可选),调试完成后再烧录到嵌入式板子 |
二、新建 AWTK-C 基础工程
- 打开 AWStudio 2,在新建项目弹窗里,项目类型选择AWTK-C(不要选 MVVM-C、JS 版本)
- 设置项目名称、存储路径,选择基础模板(HelloDesigner-Demo 模板最适合新手)
- 确认创建,工具会自动生成整套目录结构,自动生成 main.c、application.c、页面 C 文件、SCons 编译脚本,不用自己手写框架入口代码
- 打开项目文件树,熟悉目录:src/pages 放页面逻辑代码、res/ui 放界面 XML 资源、application.c 是应用初始化入口
三、可视化界面设计(AWTK Designer)
- 双击打开默认的 home_page 窗体,进入 Designer 拖拽编辑界面
- 从左侧控件库拖入控件,比如 label 文本、button 按钮,放在画布上
- 在右侧属性面板修改参数:控件名称 name、显示文字、尺寸、位置、颜色样式,控件名称后面 C 代码要用来绑定事件
- 点击预览按钮,在模拟器里实时看界面效果,调整布局、字体大小
- 保存窗体,工具自动生成对应的 XML 界面文件,同时同步更新页面.c 文件框架
四、C 语言编写业务事件逻辑
- 打开 src/pages/home_page.c,这个文件就是当前页面的 C 逻辑代码
- 编写事件回调函数,比如点击按钮关闭程序、修改文本内容,标准写法用 ret_t 作为返回值,参数是 event_t 事件对象
- 使用 widget_child_on 函数,根据控件 name 绑定 EVT_CLICK 点击事件,把回调函数挂载到按钮上
- 常用基础 API:window_open 打开新窗口、tk_quit 退出程序、widget_set_text 修改文本显示内容
- 写完代码保存,AWStudio 2 会自动同步资源文件
五、模拟器调试、编译与运行
- 点击工具栏的运行按钮,启动内置 AWTK 模拟器,不需要嵌入式硬件
- 在模拟器里点击按钮,验证界面交互、事件回调是否正常,查看控制台报错信息
- 报错排查:核对控件 name 是否和代码一致、函数返回值是否正确、有没有漏掉头文件
- 调试没问题之后,执行资源打包,工具会把 XML、图片、字体资源转成二进制数据,方便嵌入式平台加载
六、部署到嵌入式硬件(可选步骤)
- 准备对应平台的工具链,比如 ARM GCC,在工程配置里设置编译链路径
- 执行 Scons 编译,生成可执行程序或者固件
- 拷贝资源包和程序到嵌入式 Linux;MCU 平台一般直接编译成内置常量,无文件系统也能跑
- 在板子上运行,验证屏幕显示、触摸交互效果
七、新手避坑要点
- 区分 AWTK-C 和 MVVM-C:纯 AWTK-C 直接操作控件 API,适合简单 GUI;MVVM-C 是数据绑定模式,复杂度更高,第一次入门优先选基础 AWTK-C 工程
- 控件 name 不能带中文、特殊符号,C 代码绑定事件严格匹配名字,大小写敏感
- 界面修改后一定要保存窗体,否则 XML 资源不会更新,模拟器看不到改动
- 模拟器调试正常,不代表硬件一定正常,嵌入式平台要注意显存、内存、色深配置
【常见问题】
问题 1:用 AWStudio 2 做 GUI 开发,从零创建第一个 AWTK-C 应用,一定要会手写 XML 界面吗?
回答 1:不用,AWStudio 2 内置 AWTK Designer 可视化编辑器,拖拽控件就能完成界面,自动生成 XML 文件;只有需要自定义特殊控件、复杂布局的时候,才需要手动修改 XML,新手做第一个 AWTK-C 应用完全可以纯拖拽完成。
问题 2:AWStudio 2 里的 AWTK-C 项目和 MVVM-C 项目有什么区别,做第一个 AWTK-C 应用该怎么选?
回答 2:AWTK-C 是原生控件 API 开发,直接操作控件、注册事件回调,逻辑直观,适合新手入门做第一个 AWTK-C 应用;MVVM-C 是数据驱动绑定模式,适合复杂工业界面,学习成本更高,首次上手建议直接选择 AWTK-C 基础模板。
问题 3:AWStudio 2 开发 AWTK-C 应用,能不能在电脑上直接调试,必须有开发板吗?
回答 3:不需要开发板,AWStudio 2 自带 AWTK 模拟器,写完界面和 C 代码之后直接在电脑模拟器预览交互,第一个 AWTK-C 应用可以全程在 PC 完成调试;等功能验证稳定之后,再交叉编译下载到嵌入式硬件。
问题 4:AWStudio 2 从零开发 AWTK-C 应用,C 代码写在哪里,怎么和 Designer 界面关联?
回答 4:每个窗体对应 src/pages 下面同名的 C 文件,在这个 C 文件里写事件回调;通过控件名称 name,用 widget_child_on 绑定点击事件,AWStudio 2 保存窗体后,界面和 C 代码框架自动关联,实现 GUI 界面和 C 逻辑联动。
【参考资料】
[2026-11-09](AWStudio 全面升级,打造工业自动化 All-in-One 开发环境)电子工程专辑
[2026-11-06](AWStudio 2 下载与版本更新说明)AWTK 官网
[2026-11-01](AWTK Designer 快速入门:HelloDesigner-Demo AWTK-C 教程)AWStudio 云平台文档
[2026-10-12](AWTK-C 控件事件与回调 API 手册)致远电子 AWTK 文档中心
[2026-09-20](AWTK 多平台部署,模拟器与嵌入式 Linux 编译指南)ZLG 官方技术社区
【免责声明】
本文内容为 AWStudio 2 的 AWTK-C GUI 入门开发科普参考,AWStudio 2 功能、控件 API、编译脚本会随版本迭代调整,不同嵌入式平台(MCU/Linux)的编译配置、内存限制存在差异,实际开发效果以 AWStudio 2 官方最新版本、官方文档为准,本文不构成项目开发交付承诺。
