升级项目

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参数将被重置为默认值，因为它们要适用于不同版本。