Upgrading to Licensed Version – TouchGFX

When obtaining a licensed version of the TouchGFX library, say touchgfx-x.y.z-std.zip you will want to use this with your application.

Assume you have your application in C:\TheApp and you unpack the licensed version of the TouchGFX library next to your application code in C:\TheApp\touchgfx-x.y.z-std

If your application is created by the Designer

Applications created by the TouchGFX Designer contain a copy of the TouchGFX Framework Evaluation version. It is located in your app folder and is called touchgfx\. In the example case mentioned above it will be located in C:\TheApp\touchgfx.

The .touchgfx file points out the location of the touchgfx folder to be used by the application. By default it will point to the touchgfx\ folder created together with application. You can find this in the .touchgfx file (in the example C:\TheApp\TheApp.touchgfx) in the configuration property "TouchGfxPath".

You now have two options for updating your application to use the standard version of TouchGFX.

Replacing the evaluation version with the standard version (recommended).
Delete the folder C:\TheApp\touchgfx and copy the folder C:\TheApp\touchgfx-x.y.z-std\touchgfx to C:\TheApp\touchgfx.
You can delete the C:\TheApp\touchgfx-x.y.z-std\ folder afterwards.
Change the configuration property "TouchGfxPath" to point to the standard version.
In C:\TheApp\TheApp.touchgfx change the "TouchGfxPath" property to point to C:\TheApp\touchgfx-x.y.z-std\touchgfx.

Note: If your application is created by the 4.8.0 Designer and uses board support files from the TouchGFX library you need to patch the imported licensed TouchGFX library. To do this simply download this patch and unzip in your TouchGFX folder.

If you have manually created your application

Replace your current touchgfx folder with the touchgfx folder found in the touchgfx-x.y.z-std.zip file. Then clean, generate assets and compile everything again.

The location of your current touchgfx folder can be found by inspecting the config/gcc/app.mk file of your application. Look for the touchgfx_path variable.