471
引言
隨著 TouchGFX 不斷進(jìn)行軟件版本更新，其提供的功能也越來越豐富，有些新的功能只有更新的版本才有，所以很多時(shí)候會(huì)面臨將舊版本的 TouchGFX 遷移到更新版本的問題。在創(chuàng)建 TouchGFX 應(yīng)用時(shí)，生成的.touchgfx 工程文件版本與用來創(chuàng)建應(yīng)用的TouchGFX Designer 版本相同，TouchGFX Designer 在設(shè)計(jì)上是向后兼容的，您可以使用更新版本的軟件來開發(fā)您的應(yīng)用。在大多數(shù)情況下，僅需一個(gè)極簡(jiǎn)單的流程便可使舊版本應(yīng)用能夠工作在 TouchGFX 新版本上。
本文檔提供了如何從較舊版本的 TouchGFX 升級(jí)到較新版本的教程，總結(jié)可能發(fā)生的常見問題及其各自的解決方案。本文檔可能并不詳盡，可能在將來進(jìn)行更新，但旨在解決用戶在版本更新時(shí)遇到的大多數(shù)問題，以確保順利過渡到最新版本的 TouchGFX，從而享受最新版本的 TouchGFX 功能。
TouchGFX 軟件升級(jí)安裝
X-CUBE-TOUCHGFX 是 STM32Cube 生態(tài)系統(tǒng)的一個(gè)軟件包，它包含以下組件：TouchGFX Designer，TouchGFX Generator 和 TouchGFX Engine，其中 TouchGFXDesigner 是用來構(gòu)建 UI 的 GUI 構(gòu)建工具，TouchGFX Generator 是通過 STM32CubeMX來生成用戶 TouchGFX HAL 的工具，TouchGFX Engine 是驅(qū)動(dòng) UI 應(yīng)用程序的TouchGFX C++框架。軟件升級(jí)所涉及到的主要是 STM32CubeMX 中 TouchGFXGenerator 插件升級(jí)安裝和 TouchGFX Designer 升級(jí)安裝。
工程項(xiàng)目由舊版本遷移到新版本 TouchGFX
安裝好新版本的 TouchGFX 軟件后，下面介紹將您的工程代碼遷移至新版本TouchGFX 的方法。一個(gè)完整的軟件工程升級(jí)到新版本包括 STM32CubeMX 中TouchGFX Generator 配置升級(jí)并生成代碼和使用新版本 TouchGFXDesigner 打開文件并生成代碼。
軟件升級(jí)遇到的常見問題
在軟件版本升級(jí)之前一定要備份自己的軟件工程，這是十分重要的。在將舊版本的TouchGFX 工程遷移到新版本的過程中，有以下事項(xiàng)需要檢查確認(rèn)：
（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 行。使用某些功能時(shí)，保證始終在每個(gè)文件中包含正確的路徑。
（3）檢查您使用的函數(shù)是否已被棄用，或者是否更改了名稱。您可以參考幫助文檔中的更新日志頁面。
（4）建議使用 STM32CubeMX 單機(jī)應(yīng)用程序，而不要使用 STM32CubeIDE 中的STM32CubeMX。因?yàn)樵?STM32CubeIDE 使用 STM32CubeMX 進(jìn)行升級(jí)會(huì)遇到更多的問題。
（5）升級(jí)結(jié)束后，在重新編譯代碼之前，Clean 你的工程和去除之前編譯的目標(biāo)文件。
（7）在遷移之前，請(qǐng)確保您沒有用戶代碼部分之外的代碼，否則您的代碼將在代碼生成后被刪除。
（8）TouchGFX/Target 文件夾將在遷移后被修改，因此您可能需要將以前的代碼復(fù)制粘貼到新創(chuàng)建的文件中。
（9）TouchGFX 設(shè)計(jì)團(tuán)隊(duì)已經(jīng)列出了 TouchGFX 版本中已知存在的問題，以及可能的解決方法。
