使用第三方安裝器aqt安裝Qt環境

2024.3.26 更新: 於原版安裝器加入mirror方式，加快下載速度。

前言

由於公司未來規劃，之後會需要學期Qt的應用開發。
但Qt官方提供的安裝器，在下載Qt的環境時速度太慢了…（慢的跟牛一樣。）
並且官方於5.15版開始就不再提供開源開發者「離線安裝包」，需要離線安裝包的使用者必須付費購買授權。

但Qt的授權金超貴，我根本不敢付。

在這樣的原因下，我找尋了一些方式，藉此可以快速的下載qt的環境。
我這裡示範安裝的版本為5.15.2，編譯器為MinGW-w64 8.1.0，並且會一同安裝CMake、Ninja與QtCreater。

方式1：切換安裝器的鏡像源

切換的方式也很簡單，只需在command line執行qtintaller的後面加入這一行:

1

$ .\qt-unified-windows-x64-x.x.x-online.exe --mirror https://ftp.jaist.ac.jp/pub/qtproject

之後照常登入帳號，選擇欲安裝qt的環境、依賴包、其他工具…等等。
到了下載那一步，因為有切換鏡像源、因此下載速度會是比平常快很多。（從牛車變成火箭）

方式2：使用aqt

另外一種方式，是改用第三方安裝工具 - aqtinstall 來安裝Qt。

安裝步驟

提示：由於我不知道這樣的做法有無違反Qt的使用協議，想要照我這個做法下載的可能要先留意一下是否會違法。

1. 到 這裡 下載安裝工具。
   
2. 打開作業系統的終端機，照著下面的指令，在終端機上逐步運作。
   

• 安裝Qt Windows環境 (MinGW)：

  1 2 3

  # Install Qt 5.15.2 $ .\aqt_x64.exe install-qt windows desktop 5.15.2 win64_mingw81 > ...

• 安裝MinGW、cmake、ninja tools、官方編輯器…等：

  1 2 3 4 5 6 7 8 9

  # Install Qt Tools # MinGW-w64 8.1.0 $ .\aqt_x64.exe install-tool windows desktop tools_mingw qt.tools.win64_mingw810 # Cmake $ .\aqt_x64.exe install-tool windows desktop tools_cmake # Ninja $ .\aqt_x64.exe install-tool windows desktop tools_ninja # Qt Creator $ .\aqt_x64.exe install-tool windows desktop tools_qtcreator

  順利的話可以看到類似下面的訊息。

  1 2	> INFO : Finished installation > INFO : Time elapsed: 368.86221440 second

3. 所有檔案下載完成之後，可以開個資料夾，將安裝工具與其他環境通通放進去：
   
4. 到..\Tools\QtCreator\bin，打開Qt Creator，點選Edit->Preferences，設定編譯環境。
   這一部可以照我的設定參考，但放置的位置需要取決於你真實放置的位置：
   
   
   
   
   
5. 到此為此可以算是設定完畢，要確認環境是否有成功被設定，可以新建一個專案並嘗試編譯。
   如果過程中沒有提示任何的錯誤，說明環境設定成功。
   
   
   

編譯測試

補充

查詢 Qt 版本與可用元件

1
2
3

# Check Qt Version
$ ./aqt.exe list-qt windows desktop --arch 5.15.2
> win32_mingw81 win32_msvc2019 win64_mingw81 win64_msvc2015_64 win64_msvc2019_64 wasm_32

1
2
3

# Check Qt Module
$ ./aqt.exe list-qt windows desktop --arch 5.15.2 win64_mingw81
> debug_info qtcharts qtdatavis3d qtlottie qtnetworkauth qtpurchasing qtquick3d qtquicktimeline qtscript qtvirtualkeyboard qtwebglplugin

切換Mirror載點

如果嫌速度太慢，或者一直看到切換鏡像的警告提示，
可以嘗試到Qt 官方提供的鏡像站總覽挑選覺得離你較近的載點。
方法是找到載點後，下載的指令後面加入下面這一段：

1

$ -b https://ftp.jaist.ac.jp/pub/qtproject --timeout 100

上面的指令是切到日本的Mirror載點，並且將連線逾時的時間改為100秒(預設5秒)，讓編譯環境可以順利安裝。

出現clazy-standalone.exe的錯誤提示

在編輯程式碼時會一直跳出這個視窗，說明找不到相對應的DLL。

解決方法：重新安裝一遍QT環境。

參考資料

• Qt 5.15 之後不再提供預編譯安裝包 - shengyu7697.github.io
• Qt第三方安装方法 - hongch_911 - 簡書
• aqtinstall Github
• aqtinstall Manual