跳转到主要内容

升级项目

TouchGFX Generator参数存储在.ioc文件中(STM32CubeMX工程)。 当发布新版TouchGFX 生成器时,旧版的参数可能与新版的参数不兼容,并可能需要迁移。 本节介绍在STM32CubeMX中成功迁移和更新项目所需的步骤。

由于STM32CubeMX不支持X-CUBE版本之间的升级,因此,由于.touchgfx文件的PostGenerateTargetCommand部分中的以下命令,当按下生成代码时,将通过TouchGFX 设计器自动执行升级。

.touchgfx
"PostGenerateTargetCommand" : "touchgfx update_project --project-file=../upgrade.ioc --platform=m7"

该命令将读取.ioc文件并更新参数,以适应X-CUBE-TOUCHGFX的当前版本。 以下是在X-CUBE-TOUCHGFX 4.13.0创建的.ioc文件上手动运行脚本(X-CUBE-TOUCHGFX 4.14.0)的示例。

使用STM32F746 DISCO TouchGFX Board Setup的升级示例,从4.13.0升级到4.14.0
$ touchgfx update_project --project-file=../STM32F746G_DISCO.ioc
TouchGFX Generator 4.13.0 found
Creating backup of ../STM32F746G_DISCO.ioc as ../backup_STM32F746G_DISCO.ioc
Performing upgrade 4.13.0 -> 4.14.0 ... OK

使用STM32CubeMX打开更新过的项目时,系统会提示用户安装.ioc文件提示的X-CUBE-TOUCHGFX版本(如果尚未安装)。 单击立即下载将下载并安装新版本的X-CUBE-TOUCHGFX。

缺失其他软件组件:TouchGFX Generator 4.14.0

升级期间将保留TouchGFX 生成器中的所有配置,.ioc文件的备份文件将被放在原始文件旁,并带有前缀backup_

如果自上一版本以来添加了新功能,或者现有功能更改了选项,则STM32CubeMX可能无法将现有和/或新参数映射到某个值。 因此,升级项目后,始终建议检查STM32CubeMX内TouchGFX生成器的参数,以验证所有参数均具有适当的值。

要使用TouchGFX Generator提供的新功能,必须在STM32CubeMX中执行生成代码
Caution
如果通过STM32CubeMX为现有的TouchGFX项目升级X-CUBE-TOUCHGFX,升级过程并非通过TouchGFX Designer来运行,TouchGFX Generator参数将被重置为默认值,因为它们要适用于不同版本。