diff --git a/.gitignore b/.gitignore index 7a2e9b6901..1366949172 100644 --- a/.gitignore +++ b/.gitignore @@ -6,6 +6,7 @@ SerialPrograms/bin/ .DS_Store build-*/ +build/ # Qt config file on a user basis *.pro.user diff --git a/SerialPrograms/BuildInstructions/Build-Windows-Qt6.8.3.md b/SerialPrograms/BuildInstructions/Build-Windows-Qt6.8.3.md index ac911feedc..200e8dc9fe 100644 --- a/SerialPrograms/BuildInstructions/Build-Windows-Qt6.8.3.md +++ b/SerialPrograms/BuildInstructions/Build-Windows-Qt6.8.3.md @@ -83,6 +83,32 @@ If you are unable or unwilling to use the online installer, the alternative is t - to: `Arduino-Source/build-SerialPrograms-Desktop_Qt_6_8_3_MSVC2022_64bit-RelWithDebInfo` +## Upgrading Qt components + +### Installing newer Qt version +If you have already have older versions of Qt installed, but need to upgrade Qt components, you can use the Maintenance tool, which comes pre-instaled with Qt (C:\Qt\MaintenanceTool.exe). + +- When prompted, in `Maintenance Actions`, choose `Add or remove components`. +- You may select the components needed, as per the instructions above, for the newer version. And de-select old versions to remove them, if you wish. +- Optional: In `Maintenance Actions`, you may also choose `Update components` as well. To update Qt Creator, and other components. + +### Building with the newer Qt version +- Open the `SerialPrograms` project in Qt, as outlined in the "Setup" section above. +- In the toolbar, click `Edit` -> `Preferences` +- Under `Kits` tab, choose the newer Qt version (e.g. Desktop Qt 6.8.3) + + +- Under `Compiler`, set it to Microsoft Visual C++ Compiler, if not already set. +- Click `Ok`. +- Click the Monitor symbol at the bottom left + + +- Under `Kit`: choose the desired Qt version. +- Under `Build`: choose `Release with Debug Information` +- Click the green arrow to compile and launch the program. +- Optional: Move the `UserSettings` folder from the old build folder to the new build folder, to keep your old settings, such as the dev key. + +
**Discord Server:** diff --git a/SerialPrograms/BuildInstructions/Images/QT-kit-build.png b/SerialPrograms/BuildInstructions/Images/QT-kit-build.png new file mode 100644 index 0000000000..53a19c8eb5 Binary files /dev/null and b/SerialPrograms/BuildInstructions/Images/QT-kit-build.png differ diff --git a/SerialPrograms/BuildInstructions/Images/QT-kits.png b/SerialPrograms/BuildInstructions/Images/QT-kits.png new file mode 100644 index 0000000000..ab2fd89c15 Binary files /dev/null and b/SerialPrograms/BuildInstructions/Images/QT-kits.png differ