win-build-qt-mingw.md

An instruction to help you compile Qt from source code on Windows through MSYS2.

win-build-qt.bat

A Windows batch script to help you compile Qt from source code. You must know that this batch script can only help you on configuring the compiler, it will not install anything to your system, you still have to install all the prerequisites manually before running it.

Usage

1. Open cmd or power shell.
2. CALL "Script file path" [Option1] [Option2] [Option3] [Option4] [Option5] [Option6] [Option7] [Option8]
   • Script file path: The relative/absolute path of the batch file
   • Option1: Qt version, default is 5.11.0
   • Option2: Compiler, win32-clang-g++, win32-clang-msvc, win32-g++, win32-icc, win32-icc-k1om or win32-msvc, default is win32-msvc
   • Option3: Target architecture, x86 or x64, default is x64
   • Option4: Target file type, dll or lib, default is dll
   • Option5: Compile mode, debug, release or debug-and-release, default is release
   • Option6: Qt source code dir, default is ".\src"
   • Option7: Qt install dir, default is ".\qt"
   • Option8: Extra parameters you want to pass to the config program, default is empty
3. If all the prerequisites are installed correctly, the compiling process will start automatically and there is no more to do manually, the compiler will do all the rest things. The whole compiling process may take many hours, perhaps you should leave your computer and do some interesting things.
4. If you want to link Qt against ICU and OpenSSL libraries, you will have to change the script file. Please add the following config parameters:
   • ICU:

     -icu ICU_PREFIX="%_ICU_DIR%" ICU_LIBS_DEBUG="-licudtd -licuind -licuucd" ICU_LIBS_RELEASE="-licudt -licuin -licuuc"
     REM If you do not have/need the debug version of ICU, use the following command line
     REM -icu ICU_PREFIX="%_ICU_DIR%" ICU_LIBS="-licudt -licuin -licuuc"

   • OpenSSL:

     -openssl-linked OPENSSL_PREFIX="%_OPENSSL_DIR%" OPENSSL_LIBS_DEBUG="-lssleay32d -llibeay32d" OPENSSL_LIBS_RELEASE="-lssleay32 -llibeay32"
     REM If you do not have/need the debug version of OpenSSL, use the following command line
     REM -openssl-linked OPENSSL_PREFIX="%_OPENSSL_DIR%" OPENSSL_LIBS="-lssleay32 -llibeay32"

   Notes:
   • "%_ICU_DIR%" and "%_OPENSSL_DIR%" are the directories that contain "bin", "lib" and "include" directories of ICU and OpenSSL, remember to set them in the batch script.
   • ICU will increase the size of your application for about 40MB, if you don't need it then do not link against it, that's also what the Qt Company already did.
   • Remember to add the ICU and OpenSSL's "bin" directories into your PATH variable, otherwise the whole Qt compiling process will fail.

Notes:

• If you want to compile QWebEngine, you have to change your system locale to English(United States) and don't forget to change it back after compiling Qt.
• According to Qt official wiki, QWebEngine module cannot be compiled statically.
• nmake(provided by VS) is very slow, I recommend you use jom.

Example

CALL "C:\Qt\Qt5.10.2\win-build-qt.bat" 5.10.2 win32-clang-g++ x86 lib debug-and-release "C:\Qt\Qt5.10.2\src" "C:\Qt\Qt5.10.2\5.10.2\clang_g++_static_64" -force-debug-info

Tested on

Windows 10 + MSVC 2017 + Qt 5.11.0

(Theoretically, this batch script only supports Qt 5.7.x and newer)

win-deploy-qt.bat

A Windows batch script to help you deploy your Qt applications. This script is mainly designed for my personal use, but everyone can use it normally as well (if you don't have any special requirements).

Usage

1. Open cmd or power shell.
2. CALL "Script file path" [Option1] [Option2] [Option3] [Option4]
   • Script file path: The relative/absolute path of the batch file
   • Option1: The install directory's path of Qt (not the "bin" directory, it's the host directory)
   • Option2: The path of your application's executable file
   • Option3: The path of the directory of your application's executable file
   • Option4: If your application is not an Qt Quick application, leave this option empty

Example

CALL "C:\Code\MyApp\win-deploy-qt.bat" "C:\Qt\Qt5.11.0\5.11.0\msvc2017_64" "C:\Code\MyApp\bin64\release\app.exe" "C:\Code\MyApp\bin64\release" qml(or anything else you like)

Tested on

Windows 10 + MSVC 2017 + Qt 5.11.0

(Theoretically, this batch script only supports Qt 5.x and newer)

win-build-openssl.bat

A Windows batch script to help you build OpenSSL. You have to install Perl before running this script.

Usage

1. Open cmd or power shell.
2. CALL "Script file path" [Option1] [Option2] [Option3] [Option4] [Option5] [Option6] [Option7]
   • Script file path: The relative/absolute path of the batch file
   • Option1: OpenSSL version, 1.0.2 or 1.1.0, default is 1.1.0
   • Option2: Target architecture, x86 or x64, default is x64
   • Option3: Target file type, dll or lib, default is dll
   • Option4: Compile mode, debug, release or debug-and-release, default is release
   • Option5: OpenSSL source code dir, default is ".\src"
   • Option6: OpenSSL install dir, default is ".\openssl"
   • Option7: Extra parameters you want to pass to the config program, default is empty

Example

CALL "C:\openssl\1.0.2\win-build-openssl.bat" 1.0.2 x86 lib debug "C:\openssl\1.0.2\src" "C:\openssl\1.0.2\openssl"

Tested on

Windows 10 + MSVC 2017 + OpenSSL 1.0.2.x & 1.1.0.x

(Theoretically, this batch script only supports OpenSSL 1.0.2.x and 1.1.0.x)