引言

Qt Installer Framework (安裝程序框架)是一個強大的工具集，用于創建自定義的在線和離線安裝程序。它具有高度可配置性和可自定義性，適用于所有支持的Qt平臺：Linux、Windows和macOS。并且其提供了清晰的文檔和示例，幫助開發人員為應用程序創建安裝程序。

• 本文以Windows為例，簡述其制作一個軟件安裝包的步驟.

一、下載安裝 Qt Installer Framework

官方下載地址：https://download.qt.io/official_releases/qt-installer-framework/
也可使用源碼安裝，可參考官方文檔：https://doc.qt.io/qtinstallerframework/ifw-getting-started.html#building-from-sources

• 1. 從官方下載的安裝包，雙擊exe后無腦下一步即可
     
• 2. 配置環境變量
     在我的電腦上右鍵 > 屬性 > 高級系統設置 > 環境變量 > 在Path中增加binarycreator.exe所在路徑
     
• 3. 簡單驗證，在終端輸入binarycreator.exe，顯示如下圖所示：
     

二、簡單使用

官方文檔 Creating an Installer：https://doc.qt.io/qtinstallerframework/ifw-tutorial.html

2.1 創建目錄結構 (文件夾結構)

• 1. 創建相關目錄以及配置文件，具體結構如下圖所示：
     

-config- config.xml
-packages- com.vendor.root- data- 程序壓縮包 (包含可執行文件和依賴庫等，支持7z, zip, tar.gz, tar.bz2 and tar.xz)- meta- 安裝的軟件模塊說明 (package.xml等)

創建一個目錄結構：比如創建一個目錄叫InstallerTest。該目錄必須包含名為config和packages的子目錄。config下需包含config.xml配置文件。packages下可包含一個或多個程序 or 模塊的目錄 (安裝時可選擇安哪個)，每個目錄下又分為data (軟件相關)和 meta(安裝程序相關)

關于目錄結構的說明可參考：
使用Qt Installer Framework制作軟件安裝包：https://www.cnblogs.com/xia-weiwen/p/6857333.html
官方說明文檔 Package Directory：https://doc.qt.io/qtinstallerframework/ifw-component-description.html

• 2. config.xml文件，其控制安裝程序的歡迎、安裝文件夾和開始菜單快捷方式等，如下圖所示：

<?xml version="1.0" encoding="UTF-8"?>
<Installer><Name>軟件名稱</Name><Version>1.0.0</Version><Title>安裝程序名稱 - 會在安裝程序的標題上顯示</Title><Publisher>軟件發布者</Publisher><StartMenuDir>在開始菜單中的默認目錄名稱</StartMenuDir><TargetDir>默認的安裝目錄</TargetDir>
</Installer>

還可以設置安裝程序的顏色、Logo等
更多詳細信息可參考：https://doc.qt.io/qtinstallerframework/ifw-globalconfig.html

• 3. package.xml文件，其控制安裝程序的選擇組件和許可協議等界面，如下圖所示

<?xml version="1.0" encoding="UTF-8"?>
<Package><DisplayName>一個模塊</DisplayName><Description>相關描述</Description><Version>1.0.0-1</Version><ReleaseDate>2024-07-01</ReleaseDate>
</Package>

還可以增加許可協議以及自定義UI界面
更多詳細信息可參考：https://doc.qt.io/qtinstallerframework/ifw-component-description.html#package-information-file-syntax

2.2 制作程序壓縮包

• 1. 編譯release版的程序，然后使用windeployqt復制相關庫，如下圖所示：
     
• 2. 壓縮為7z, zip, tar.gz, tar.bz2 and tar.xz (可選)格式，放到相應的data目錄下
     

windeployqt的使用可參考：
Qt的windeployqt打包：https://blog.csdn.net/u014597198/article/details/77852483
Qt windeployqt.exe 打包qml：https://blog.51cto.com/u_15707179/6102502

2.3 制作程序安裝包

完成上述準備工作之后，就可以執行命令制作安裝包！

• 1. 在對應的路徑下執行binarycreator命令
     binarycreator -c config\config.xml -p packages MyInstaller.exe
     
• 2. 生成MyInstaller.exe，雙擊即可打開進行安裝
     
• 3. 完結！