|
1 | | -# How to Build (Qt 6.3.2) - Windows |
2 | | - |
3 | | -We recommend that you install everything here in the exact order listed and the exact versions mentioned. Failing either will likely result in a broken Qt Creator installation that must be fixed by manually configuring it (which is not fun if you don't know what you're doing). |
4 | | - |
5 | | -Required Versions: |
6 | | -- **Visual Studio 2019** - You must install VS2019. If you install VS2022 instead, your Qt Creator installation will be broken. It is ok to have both VS2019 and VS2022 installed. But you must have VS2019 as that is the version that Qt Creator will look for. |
7 | | -- **Qt 6.3.2** - Do not install a later version of Qt. All Qt versions 6.4.x - 6.5.2 are broken for this project. |
8 | | - |
9 | | -## Build Tools: |
10 | | - |
11 | | -The installation order here is important. While other orderings may work, this is the specific order that we have tested. And the Qt installation must be the last thing installed. |
12 | | - |
13 | | -1. Install Visual Studio 2019: |
14 | | - 1. [Download Page](https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes) |
15 | | - 2. Make sure you select the C++ development tools. |
16 | | -2. Install Windows Development SDK: |
17 | | - 1. [Download Page](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/) |
18 | | -3. Install CMake: |
19 | | - 1. [Download Page](https://cmake.org/download/) |
20 | | - 2. When prompted select, "Add CMake to the system PATH for all users". |
21 | | - |
22 | | -## Install Qt 6.3.2: |
23 | | - |
24 | | -Unlike with Qt 5.12, there is no offline installer for it. So you have two options here, use the online installer, or use a copy of an installation. |
25 | | - |
26 | | -### Official Online Installer: |
27 | | - |
28 | | -If you are ok with creating an account with Qt and using their online installer, then use this method. |
29 | | - |
30 | | -1. Download the online installer from here: https://www.qt.io/download-qt-installer |
31 | | -2. When prompted to select components, check `Archive` on the right side bar, then click `Filter`. Then select the following options: |
32 | | - |
33 | | - - Qt 6.3.2 |
34 | | - - MSVC 2019 64-bit |
35 | | - - Sources |
36 | | - - Additional Libraries |
37 | | - - Qt Image Formats |
38 | | - - Qt Multimedia |
39 | | - - Qt Serial Port |
40 | | - - Qt Debug Information Files |
41 | | - |
42 | | - |
43 | | - |
44 | | -If you repeatedly run into an error involving "SSL handshake failed", you will not be able to use the online installer. Please try the other option. |
45 | | - |
46 | | -### Unofficial Installation Copy: |
47 | | - |
48 | | -If you are unable or unwilling to use the online installer, the alternative is to copy an installation directly into your system. To do this, you will need to download the installation from us, and copy it into your C drive. |
49 | | - |
50 | | -1. Join our [Discord server](https://discord.gg/cQ4gWxN) and ask for the link to the Qt6 standalone. Someone will DM you with a link*. |
51 | | -2. Download `Qt6.3.2.7z` and decompress it. You can use [7-zip](https://www.7-zip.org/) to decompress it. This will create a folder with the same name. |
52 | | -3. Move this folder to `C:\`. It will probably ask you for permissions to do it. |
53 | | -4. Navigate to: `C:\Qt6.3.2\Tools\QtCreator\bin\` and create a shortcut to `qtcreator.exe`. Copy this shortcut to somewhere convenient. (By default this shortcut is named, `Qt Creator 8.0.1 (Community)`) |
54 | | - |
55 | | -*This Qt6 standalone file is 3GB in size and is being hosted by our staff for our own developers. We don't want the entire world converging here and overrunning the server. |
56 | | - |
57 | | -## Setup: |
58 | | - |
59 | | -1. Clone this repo. |
60 | | -2. Clone the [Packages Repo](https://github.com/PokemonAutomation/Packages). |
61 | | -3. In the `Packages` repo, copy the `SerialPrograms/Resources` folder into the root of the `Arduino-Source` repo. |
62 | | - |
63 | | - |
64 | | - |
65 | | -4. Open Qt Creator. |
66 | | -5. Click on `File` -> `Open File or Project`. |
67 | | -6. Navigate to [`SerialPrograms`](./) and select `CMakeLists.txt`. |
68 | | -7. It will then ask you to configure the project. Select `Desktop Qt 6.3.2 MSVC2019 64bit`. Click `Configure Project`. |
69 | | - |
70 | | -8. At the bottom left corner, click on the little monitor and select `Release with Debug Information`. |
71 | | - |
72 | | -9. At the bottom left corner, click the upper green arrow to compile and launch the program. |
73 | | - |
74 | | - |
75 | | -<hr> |
76 | | - |
77 | | -**Discord Server:** |
78 | | - |
79 | | - |
80 | | -[<img src="https://canary.discordapp.com/api/guilds/695809740428673034/widget.png?style=banner2">](https://discord.gg/cQ4gWxN) |
81 | | - |
| 1 | +# How to Build (Qt 6.3.2) - Windows |
| 2 | + |
| 3 | +We recommend that you install everything here in the exact order listed and the exact versions mentioned. Failing either will likely result in a broken Qt Creator installation that must be fixed by manually configuring it (which is not fun if you don't know what you're doing). |
| 4 | + |
| 5 | +Required Versions: |
| 6 | +- **Visual Studio 2019** - You must install VS2019. If you install VS2022 instead, your Qt Creator installation will be broken. It is ok to have both VS2019 and VS2022 installed. But you must have VS2019 as that is the version that Qt Creator will look for. |
| 7 | +- **Qt 6.3.2** - Do not install a later version of Qt. All Qt versions 6.4.x - 6.5.2 are broken for this project. |
| 8 | + |
| 9 | +## Build Tools: |
| 10 | + |
| 11 | +The installation order here is important. While other orderings may work, this is the specific order that we have tested. And the Qt installation must be the last thing installed. |
| 12 | + |
| 13 | +1. Install Visual Studio 2019: |
| 14 | + 1. [Download Page](https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes) |
| 15 | + 2. Make sure you select the C++ development tools. |
| 16 | +2. Install Windows Development SDK: |
| 17 | + 1. [Download Page](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/) |
| 18 | +3. Install CMake: |
| 19 | + 1. [Download Page](https://cmake.org/download/) |
| 20 | + 2. When prompted select, "Add CMake to the system PATH for all users". |
| 21 | + |
| 22 | +## Install Qt 6.3.2: |
| 23 | + |
| 24 | +Unlike with Qt 5.12, there is no offline installer for it. So you have two options here, use the online installer, or use a copy of an installation. |
| 25 | + |
| 26 | +### Official Online Installer: |
| 27 | + |
| 28 | +If you are ok with creating an account with Qt and using their online installer, then use this method. |
| 29 | + |
| 30 | +1. Download the online installer from here: https://www.qt.io/download-qt-installer |
| 31 | +2. When prompted to select components, check `Archive` on the right side bar, then click `Filter`. Then select the following options: |
| 32 | + |
| 33 | + - Qt 6.3.2 |
| 34 | + - MSVC 2019 64-bit |
| 35 | + - Sources |
| 36 | + - Additional Libraries |
| 37 | + - Qt Image Formats |
| 38 | + - Qt Multimedia |
| 39 | + - Qt Serial Port |
| 40 | + - Qt Debug Information Files |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +If you repeatedly run into an error involving "SSL handshake failed", you will not be able to use the online installer. Please try the other option. |
| 45 | + |
| 46 | +### Unofficial Installation Copy: |
| 47 | + |
| 48 | +If you are unable or unwilling to use the online installer, the alternative is to copy an installation directly into your system. To do this, you will need to download the installation from us, and copy it into your C drive. |
| 49 | + |
| 50 | +1. Join our [Discord server](https://discord.gg/cQ4gWxN) and ask for the link to the Qt6 standalone. Someone will DM you with a link*. |
| 51 | +2. Download `Qt6.3.2.7z` and decompress it. You can use [7-zip](https://www.7-zip.org/) to decompress it. This will create a folder with the same name. |
| 52 | +3. Move this folder to `C:\`. It will probably ask you for permissions to do it. |
| 53 | +4. Navigate to: `C:\Qt6.3.2\Tools\QtCreator\bin\` and create a shortcut to `qtcreator.exe`. Copy this shortcut to somewhere convenient. (By default this shortcut is named, `Qt Creator 8.0.1 (Community)`) |
| 54 | + |
| 55 | +*This Qt6 standalone file is 3GB in size and is being hosted by our staff for our own developers. We don't want the entire world converging here and overrunning the server. |
| 56 | + |
| 57 | +## Setup: |
| 58 | + |
| 59 | +1. Clone this repo. |
| 60 | +2. Clone the [Packages Repo](https://github.com/PokemonAutomation/Packages). |
| 61 | +3. In the `Packages` repo, copy the `SerialPrograms/Resources` folder into the root of the `Arduino-Source` repo. |
| 62 | + |
| 63 | + |
| 64 | + |
| 65 | +4. Open Qt Creator. |
| 66 | +5. Click on `File` -> `Open File or Project`. |
| 67 | +6. Navigate to [`SerialPrograms`](./) and select `CMakeLists.txt`. |
| 68 | +7. It will then ask you to configure the project. Select `Desktop Qt 6.3.2 MSVC2019 64bit`. Click `Configure Project`. |
| 69 | + |
| 70 | +8. At the bottom left corner, click on the little monitor and select `Release with Debug Information`. |
| 71 | + |
| 72 | +9. At the bottom left corner, click the upper green arrow to compile and launch the program. |
| 73 | + |
| 74 | + |
| 75 | +<hr> |
| 76 | + |
| 77 | +**Discord Server:** |
| 78 | + |
| 79 | + |
| 80 | +[<img src="https://canary.discordapp.com/api/guilds/695809740428673034/widget.png?style=banner2">](https://discord.gg/cQ4gWxN) |
| 81 | + |
0 commit comments