升級專案

TouchGFX Generator的相關參數儲存在STM32CubeMX專案的.ioc檔案當中。發佈新版TouchGFX Generator時，舊版參數可能與新版參數不相容，此時便需要進行轉移。本節說明所需步驟，以便在STM32CubeMX之中成功轉移及更新專案。

STM32CubeMX不支援X-CUBE版本之間的升級。按下Generate Code(產生程式碼)時，TouchGFX Designer會自動執行升級，原因在於.touchgfx檔案內PostGenerateTargetCommand區段中的下列指令。

.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開發板設定從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開啟升級過的專案時，STM32CubeMX會提示使用者要安裝.ioc檔案所指定的X-CUBE-TOUCHGFX版本(若指定版本尚未安裝的情況下)。點擊Download now(立即下載)後將下載並安裝新版的X-CUBE-TOUCHGFX。

遺漏其他軟體元件：TouchGFX Generator 4.14.0

升級期間會保留TouchGFX Generator中的所有設定，.ioc檔案的備份會以前置檔名backup_的方式置於原始檔旁。

如果在先前版本之後新增新功能，或是現有功能已經變更選項，則STM32CubeMX可能無法將現有或是新參數對應到值。因此我們建議請務必在STM32CubeMX內部檢查TouchGFX Generator參數，以確認專案升級後所有項目都有適當的值。

要使用TouchGFX Generator所提供的新功能，必須在STM32CubeMX中再執行Generate Code (產生程式碼)。

Caution
如果透過STM32CubeMX(而不是透過TouchGFX Designer)為現有的TouchGFX專案升級X-CUBE-TOUCHGFX，TouchGFX Generator參數將重設為預設值，因為這些參數適用於不同版本。