LAT1227 TouchGFX 從舊版本升級到新版本的方法

引言

隨著 TouchGFX 不斷進行軟件版本更新，其提供的功能也越來越豐富，有些新的功能只有更新的版本才有，所以很多時候會面臨將舊版本的 TouchGFX 遷移到更新版本的問題。在創(chuàng)建 TouchGFX 應用時，生成的.touchgfx 工程文件版本與用來創(chuàng)建應用的TouchGFX Designer 版本相同，TouchGFX Designer 在設計上是向后兼容的，您可以使用更新版本的軟件來開發(fā)您的應用。在大多數(shù)情況下，僅需一個極簡單的流程便可使舊版本應用能夠工作在 TouchGFX 新版本上。

本文檔提供了如何從較舊版本的 TouchGFX 升級到較新版本的教程，總結可能發(fā)生的常見問題及其各自的解決方案。本文檔可能并不詳盡，可能在將來進行更新，但旨在解決用戶在版本更新時遇到的大多數(shù)問題，以確保順利過渡到最新版本的 TouchGFX，從而享受最新版本的 TouchGFX 功能。

TouchGFX 軟件升級安裝

X-CUBE-TOUCHGFX 是 STM32Cube 生態(tài)系統(tǒng)的一個軟件包，它包含以下組件：TouchGFX Designer，TouchGFX Generator 和 TouchGFX Engine，其中 TouchGFXDesigner 是用來構建 UI 的 GUI 構建工具，TouchGFX Generator 是通過 STM32CubeMX來生成用戶 TouchGFX HAL 的工具，TouchGFX Engine 是驅動 UI 應用程序的TouchGFX C++框架。軟件升級所涉及到的主要是 STM32CubeMX 中 TouchGFXGenerator 插件升級安裝和 TouchGFX Designer 升級安裝。

工程項目由舊版本遷移到新版本 TouchGFX

安裝好新版本的 TouchGFX 軟件后，下面介紹將您的工程代碼遷移至新版本TouchGFX 的方法。一個完整的軟件工程升級到新版本包括 STM32CubeMX 中TouchGFX Generator 配置升級并生成代碼和使用新版本 TouchGFXDesigner 打開文件并生成代碼。

軟件升級遇到的常見問題

在軟件版本升級之前一定要備份自己的軟件工程，這是十分重要的。在將舊版本的TouchGFX 工程遷移到新版本的過程中，有以下事項需要檢查確認：

（1）使用新版本 TouchGFX Designer 生成代碼之前，是否在 STM32CubeMX 中使用相同版本的 TouchGFX Generator 并生成代碼？如果您使用 TouchGFX 4.20，則需要在STM32CubeMX 中使用 TouchGFX Generator 4.20 和 TouchGFX Designer 4.20, 版本要保持一致。STM32CubeMX 的版本要選擇支持 TouchGFX Generator 最新版本的版本，例如，要使用 TouchGFX Generator 4.20，那么 STM32CubeMX 的版本要最低為 6.5。

（2）檢查代碼中是否缺少#include 行。使用某些功能時，保證始終在每個文件中包含正確的路徑。

（3）檢查您使用的函數(shù)是否已被棄用，或者是否更改了名稱。您可以參考幫助文檔中的更新日志頁面。

（4）建議使用 STM32CubeMX 單機應用程序，而不要使用 STM32CubeIDE 中的STM32CubeMX。因為在 STM32CubeIDE 使用 STM32CubeMX 進行升級會遇到更多的問題。

（5）升級結束后，在重新編譯代碼之前，Clean 你的工程和去除之前編譯的目標文件。

（7）在遷移之前，請確保您沒有用戶代碼部分之外的代碼，否則您的代碼將在代碼生成后被刪除。

（8）TouchGFX/Target 文件夾將在遷移后被修改，因此您可能需要將以前的代碼復制粘貼到新創(chuàng)建的文件中。

（9）TouchGFX 設計團隊已經(jīng)列出了 TouchGFX 版本中已知存在的問題，以及可能的解決方法。