주요 내용으로 건너뛰기

새로운 TouchGFX 버전으로 업데이트하기

When a TouchGFX application is created, the .touchgfx project file will have the same version as the TouchGFX Designer/X-CUBE-TOUCHGFX used to create it. 그렇다고 향후 애플리케이션을 개발할 때 해당하는 특정 버전의 TouchGFX만 사용할 수 있는 것은 아닙니다.

TouchGFX는 하위 호환되도록 설계되어 대부분의 경우 간단한 절차만 따르면 이전 버전의 애플리케이션과 새로운 버전의 TouchGFX를 함께 사용할 수 있습니다.

새로 설치한 버전의 TouchGFX Designer를 먼저 열고, 최근 애플리케이션 또는 Open 대화상자를 통해 이전 애플리케이션을 열면 됩니다. 그러면 다음과 같은 팝업 창이 나타납니다.

Update 팝업 창

Caution
팝업 창에도 명시되어 있듯이 업데이터를 실행하기 전에 애플리케이션을 항상 백업하는 것이 좋습니다.

'Yes'를 누르면 업데이터가 시작됩니다. 업데이터를 마치면 TouchGFX Designer에서 애플리케이션이 정상적으로 열리고, 이제 새로운 버전을 바로 사용할 수 있습니다.

드물지만 새로운 TouchGFX 버전으로 완전하게 업데이트하려면 애플리케이션을 수동으로 변경해야 하는 경우도 있습니다. 애플리케이션을 새 버전으로 업데이트하면서 추가적인 문제가 발생하면 알려진 문제 섹션을 참조하십시오.

TouchGFX Generator 업데이트​

When you generate code in TouchGFX Designer for a migrated project, TouchGFX updates the TouchGFX version in the project's .ioc file automatically. TouchGFX Designer cannot, however, trigger STM32CubeMX to regenerate code. Since code generation in STM32CubeMX is often required; open the .ioc file in STM32CubeMX, confirm the X-CUBE-TOUCHGFX package shows the intended version, and then generate code.

Before opening the .ioc file, ensure that the new X-CUBE-TOUCHGFX package is installed in STM32CubeMX. You can do this in one of two ways:

  1. In STM32CubeMX go to Help → Manage embedded software packages → STMicroelectronics → X-CUBE-TOUCHGFX. Click the refresh button to fetch the latest packages, select the package, and click Install.

  2. If the release is very new and not yet available from the STM32CubeMX server, download the STMicroelectronics.X-CUBE-TOUCHGFX.x.x.x.zip package from st.com. In STM32CubeMX open Help → Manage embedded software packages → From Local..., select the downloaded ZIP, and click Open.

Software Packages Manager: Install TouchGFX Generator

After either procedure the package will be installed in STM32CubeMX. Then open the .ioc file, verify that X-CUBE-TOUCHGFX has been migrated to the new version, validate the configuration, and generate code.

Note
  • You can update the TouchGFX Generator in STM32CubeMX before updating the .touchgfx file, but the recommended order is to update the .touchgfx file first.
  • For more info on how to install X-CUBE-TOUCHGFX in STM32CubeMX see Installing TouchGFX Generator in STM32CubeMX.
Caution
  • The migration is a two-step process that requires code generation from both STM32CubeMX and TouchGFX Designer.
  • TouchGFX/target code generated by the TouchGFX Generator is written to disk only after you press the Generate Code button in STM32CubeMX.