开发环境搭建：工欲善其事，必先利其器

做嵌入式UI开发，环境搭建往往是第一个坑。我记得刚入行那会儿，光装软件就折腾了两天，最后发现是版本不匹配。这节课，我把这些年踩过的坑和总结的经验一次性告诉你。

2.1 整体流程概览

说白了，整个搭建流程就四步。我习惯先画个图，把逻辑理清楚再动手。

2.2 TouchGFX Designer 安装

这是ST官方提供的UI设计工具，说白了就是个可视化编辑器。你拖拽控件、设置动画，它自动生成C++代码。

2.2.1 下载与安装

• 下载地址：ST官网搜索"TouchGFX Designer"，或者直接去GitHub的TouchGFX仓库找。
• 版本选择：我个人建议用4.20以上版本，对动画刷新支持更好。我遇到过用4.18版本，有些动画API不兼容，折腾了半天。
• 安装注意：安装路径不要有中文和空格。嗯，这个老生常谈了，但每次都有同学中招。

2.2.2 许可证激活

TouchGFX Designer对个人开发者是免费的，但需要注册ST账号。你想想看，ST这么做也是为了收集用户数据改进产品。

1. 打开Designer，点击"Activate License"。
2. 登录你的ST账号（没有就注册一个，很快）。
3. 选择"Free License"，激活完成。

2.3 STM32CubeMX 配置

CubeMX的作用是配置MCU的时钟、外设、中间件。TouchGFX需要依赖FreeRTOS和LTDC（或DMA2D）驱动。

2.3.1 创建新工程

• 选择MCU：我常用STM32F429或STM32H743，这两款带硬件TFT控制器和2D加速器，跑动画很流畅。
• 时钟配置：LTDC需要精确的像素时钟，建议用HSE+PLL，不要用内部RC振荡器，否则屏幕会闪烁。
• 外设使能：LTDC、DMA2D、FMC（如果外挂SDRAM）、I2C（触摸屏）。

2.3.2 TouchGFX 中间件集成

在CubeMX的"Software Packs"里，选择"TouchGFX Generator"。这一步很多人会漏掉。

配置项	推荐值	说明
Application Display	1	单屏应用选1，双屏选2
Frame Buffer	Double Buffer	双缓冲，动画刷新必备
OS	FreeRTOS	TouchGFX依赖OS调度
Touch Controller	FT5336 / GT911	根据你的触摸IC选

2.4 IDE 工程导入

CubeMX配置完成后，点击"Generate Code"，会生成一个完整的IDE工程。你可以在IAR或KEIL中直接打开。

2.4.1 IAR 导入步骤

1. 在CubeMX的"Project Manager"里，Toolchain选"IAR for ARM"。
2. 生成代码后，找到 .eww 文件，双击打开。
3. 编译前，检查一下优化等级。我建议选"High (Balanced)"，太高了调试不方便。

2.4.2 KEIL 导入步骤

1. Toolchain选"MDK-ARM V5"。
2. 打开 .uvprojx 文件。
3. KEIL有时候会报"Missing Device"，需要安装对应的Device Family Pack。

2.5 模拟器运行

模拟器是TouchGFX的一大亮点。你可以在PC上直接运行UI，不用烧录到板子上。这大大加快了开发速度。

2.5.1 模拟器配置

在Designer里，点击"Run Simulator"。第一次运行会有点慢，因为要编译模拟器工程。

• 分辨率：模拟器默认是480x272，你可以改成你的目标屏幕分辨率。
• 触摸模拟：用鼠标模拟触摸，左键点击就是触摸按下。
• 性能监控：按F12可以打开帧率显示，这个在调试动画刷新时非常有用。

2.5.2 常见问题

问题	原因	解决方法
模拟器黑屏	缺少OpenGL驱动	安装显卡驱动，或更新DirectX
编译报错"找不到头文件"	路径配置错误	检查Designer的SDK路径设置
模拟器卡顿	帧率设置过高	在模拟器设置里把帧率降到30fps

2.6 验证环境是否搭建成功

环境搭好了，怎么确认没问题？我一般会跑一个简单的Demo。

1. 在Designer里，打开"Examples" -> "WidgetGallery"。
2. 点击"Run Simulator"，确认能看到各种控件和动画。
3. 在模拟器里点击按钮，看交互是否正常。
4. 按F12看帧率，稳定在60fps说明环境没问题。