プロジェクトのアップグレード

TouchGFX Generatorのパラメータは.iocファイル（STM32CubeMXプロジェクト）に格納されます。 TouchGFX Generatorの新バージョンがリリースされると、旧バージョンのパラメータが新バージョンと互換性を持たないために移行が必要になる可能性があります。このセクションでは、STM32CubeMXでプロジェクトを正常に移行および更新するために必要な手順について説明します。

STM32CubeMXはX-CUBEバージョン間のアップグレードをサポートしていないため、［Generate Code］が押されると、.touchgfxファイルのPostGenerateTargetCommandセクション内の以下のコマンドによってTouchGFX Designerで自動的にアップグレードが実行されます。

.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をインストールするように求められます（まだインストールしていない場合）。［Download now］をクリックすると、X-CUBE-TOUCHGFXの新しいバージョンのダウンロードとインストールが行われます。

追加ソフトウェア･コンポーネントが見つからない場合: TouchGFX Generator 4.14.0

アップグレード･プロセスの実行時、TouchGFX Generatorの設定はすべて保持され、.iocファイルのバックアップは先頭にbackup_が付いた状態で、元のファイルと同じ場所に配置されます。

TouchGFX Generatorによって提供される新機能を使用するには、STM32CubeMXで［Generate Code］を実行する必要があります。

Caution
既存のTouchGFXプロジェクト用にSTM32CubeMXを介してX-CUBE-TOUCHGFXをアップグレードするときに、そのアップグレード･プロセスがTouchGFX Designerによって実行されない場合、TouchGFX Generatorのパラメータは別のバージョンに適用されるパラメータであるため、デフォルトにリセットされます。