メイン･コンテンツまでスキップ

新しい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ダイアログを介して、古いアプリケーションを開いてみます。次のポップアップが表示されます。

更新のポップアップ

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.