使用 Qt Installer Framework (QtIFW) 制作安裝包全流程

一文看懂如何利用QtIFW制作安裝包，小白也能看懂且學會的軟件安裝包制作教程

更新：團隊現在改成使用 Installer Studio 這個軟件來打包了对扶，用過NSIS， Inno Setup涮较，InstallShield威创，Qt Installer Framework（QtIFW），Advanced Installer和 Installer Studio蒿涎，還是覺得 Installer Studio 好用太多了

preview.png

前言
安裝包制作工具的選擇
安裝程序生成工具就是將應用程序和依賴的文件打包到一個可執(zhí)行的安裝程序種穿撮，可以簡化用戶的安裝流程和體驗缺脉，但開發(fā)的軟件依賴和配置過于繁雜的時候，制作一個安裝包就特別必要悦穿，所以需要簡單學習一下安裝程序生成工具攻礼，以下是常見的安裝程序生成工具：

Installer Studio
無需編寫代碼，1分鐘即可完成軟件打包栗柒。
基于近百個模板快速構建如QQ等精美高質量安裝包礁扮，
可以制作離線/在線/靜默安裝包制作，在線安裝包大小只有2MB瞬沦。
支持自定義注冊表太伊，環(huán)境變量，快捷方式以及Java逛钻，.Net等環(huán)境的安裝僚焦。
可以打包任何類型的應用（html Electron flutter Cocos Unity3D）。
支持構建預覽曙痘，像畫圖一樣制作產品的安裝包叠赐。
國際化安裝包，產品出海無憂屡江。

Inno Setup
免費且開源的安裝程序制作工具，適用于Windows平臺赛不。
使用Pascal腳本語言編寫安裝程序腳本惩嘉。
提供了豐富的功能和靈活的自定義選項。
擁有詳細的文檔和活躍的社區(qū)支持踢故。

NSIS (Nullsoft Scriptable Install System)
免費且開源的安裝程序制作工具文黎，適用于Windows平臺。
使用自定義的腳本語言編寫安裝程序腳本殿较。
具有較小的安裝包大小和快速的安裝速度耸峭。
社區(qū)支持廣泛，有大量的插件可用淋纲。

InstallShield
商業(yè)的安裝程序制作工具劳闹，適用于多個平臺，包括Windows、Linux和macOS本涕。
提供了強大的功能和靈活的自定義選項业汰。
擁有可視化界面和向導，使得制作安裝程序變得簡單菩颖。
文檔和支持資源豐富样漆，適用于中大型企業(yè)項目。

WiX Toolset (Windows Installer XML)
免費且開源的安裝程序制作工具晦闰，適用于Windows平臺放祟。
使用XML和自定義的腳本語言編寫安裝程序腳本。
可以創(chuàng)建符合Windows Installer標準的安裝程序呻右。
需要一定的學習曲線跪妥，但具備強大的靈活性和可擴展性。

Advanced Installer
商業(yè)的安裝程序制作工具窿冯，適用于Windows平臺骗奖。
提供了易于使用的可視化界面和向導，使得制作安裝程序變得簡單醒串。
具有豐富的功能执桌，如自動升級、數字簽名等芜赌。
提供文檔和支持渠道仰挣。

QtIFW (Qt Installer Framework)
開源的安裝程序制作工具，由Qt官方提供缠沈，適用于多個平臺膘壶，包括Windows、Linux和macOS洲愤。
使用基于XML的描述語言來配置和自定義安裝程序颓芭。
可以輕松創(chuàng)建復雜的安裝程序，并具有強大的自定義能力柬赐。
擁有官方的文檔和示例亡问，同時有活躍的社區(qū)支持。
這里不賣關子，就選擇QtIFW，QtIFW本身就是作為Qt項目的一部分開發(fā)的森篷，框架本身使用Qt。然而床玻，它可以用于安裝所有類型的應用程序，包括（但不限于）使用Qt構建的應用程序沉帮。

而且它是跨平臺且使用XML的描述語言來配置安裝程序的锈死，所以這里選擇QtIFW贫堰；以下是使用它制作安裝包的詳細步驟：

一、環(huán)境準備

首先確保你已經安裝了 Qt 開發(fā)環(huán)境馅精，并且 Qt Installer Framework 也已正確安裝严嗜。在安裝好 Qt 后，Qt Installer Framework 通持薷遥可以在 Qt 安裝目錄下的 Tools 文件夾中找到漫玄。

二、創(chuàng)建項目結構

新建文件夾：
新建一個文件夾作為安裝包項目的根目錄压彭，例如“MyAppInstaller”睦优。
創(chuàng)建子文件夾：
在該目錄下創(chuàng)建以下幾個重要的子文件夾：
- “meta”：這個文件夾用于存放安裝包的配置信息，如包的名稱壮不、版本汗盘、描述等。
- “packages”：包含了實際要安裝的文件和組件信息询一。

三隐孽、編寫配置文件

在“meta”文件夾中創(chuàng)建“package.xml”文件。這是一個 XML 格式的文件健蕊，用于定義安裝包的基本屬性菱阵。例如：

<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>My Awesome App</DisplayName>
    <Description>An application that does amazing things.</Description>
    <Version>1.0.0</Version>
    <ReleaseDate>2024-11-22</ReleaseDate>
    <Licenses>
        <License name="MIT License" file="LICENSE.txt"/>
    </Licenses>
    <Default>true</Default>
</Package>

在這個文件中，你可以設置顯示名稱缩功、描述晴及、版本號、發(fā)布日期以及許可證等信息嫡锌。

同樣在“meta”文件夾中虑稼，創(chuàng)建“config.xml”文件。這是一個 XML 格式的文件势木，用于配置安裝過程中的一些參數蛛倦，如安裝路徑、目標平臺等啦桌。例如：

<?xml version="1.0" encoding="UTF-8"?>
<Installer>
    <Name>MyAppInstaller</Name>
    <Version>1.0.0</Version>
    <Title>My Awesome App Installer</Title>
    <Publisher>Your Company Name</Publisher>
    <ProductUrl>https://yourcompany.com/myapp</ProductUrl>
    <TargetDir>@HomeDir@/MyApp</TargetDir>
</Installer>

這里設置了安裝程序的名稱溯壶、版本、標題震蒋、發(fā)布者、產品網址以及默認的安裝目標目錄躲庄。

四查剖、準備安裝文件

在“packages”文件夾下創(chuàng)建與你的應用程序相關的子文件夾。例如噪窘，如果你的應用程序有可執(zhí)行文件笋庄、庫文件和資源文件，可以分別創(chuàng)建對應的文件夾。
將實際要安裝的文件復制到相應的文件夾中直砂。例如菌仁，將可執(zhí)行文件“MyApp.exe”復制到“packages/MyApp/bin”文件夾下，將庫文件復制到“packages/MyApp/libs”文件夾下等静暂。

五济丘、創(chuàng)建組件描述文件

在每個包含安裝文件的子文件夾中創(chuàng)建一個“meta”文件夾。
在這些“meta”文件夾中創(chuàng)建“package.xml”文件洽蛀，用于描述該組件的信息摹迷。例如，對于可執(zhí)行文件組件的“package.xml”可以這樣寫：

<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>MyApp Executable</DisplayName>
    <Description>The main executable of MyApp.</Description>
    <Version>1.0.0</Version>
    <ReleaseDate>2024-11-22</ReleaseDate>
    <Licenses>
        <License name="MIT License" file="LICENSE.txt"/>
    </Licenses>
    <Script>script.js</Script>
</Package>

這里除了基本信息外郊供，還指定了一個腳本文件“script.js”峡碉，用于在安裝過程中對該組件進行一些自定義操作，如創(chuàng)建快捷方式等驮审。

六鲫寄、編寫腳本（可選但強大）

如果需要在安裝過程中執(zhí)行一些自定義操作，如創(chuàng)建桌面快捷方式疯淫、注冊組件等地来，可以在組件的“meta”文件夾下創(chuàng)建腳本文件（如上面提到的“script.js”）。以下是一個簡單的創(chuàng)建桌面快捷方式的腳本示例：

function Component()
{
}

Component.prototype.createOperations = function()
{
    // 調用父類的 createOperations 方法
    component.createOperations();

    // 創(chuàng)建桌面快捷方式操作
    var shortcutOp = this.createShortcutOperation("MyAppDesktopShortcut",
        "@TargetDir@/MyApp.exe",
        "@DesktopDir@/MyApp.lnk",
        "My Awesome App",
        "MyAppIcon.ico",
        "");

    // 將快捷方式操作添加到安裝操作序列中
    this.addOperation(shortcutOp);
}

這個腳本定義了一個組件類峡竣，并在其中重寫了“createOperations”方法靠抑，用于創(chuàng)建一個桌面快捷方式操作并添加到安裝操作序列中。

七适掰、構建安裝包

打開命令行工具颂碧，切換到安裝包項目的根目錄（“MyAppInstaller”），然后運行以下命令：

binarycreator.exe -c meta/config.xml -p packages MyAppInstaller.exe

其中类浪，“binarycreator.exe”是 Qt Installer Framework 提供的構建工具载城，“-c”參數指定配置文件“meta/config.xml”，“-p”參數指定包含安裝文件的“packages”文件夾费就，最后的“MyAppInstaller.exe”是生成的安裝包文件名诉瓦。

執(zhí)行完命令后，如果沒有錯誤力细，將會在當前目錄下生成“MyAppInstaller.exe”安裝包文件睬澡。這個安裝包就可以在目標平臺上運行，按照我們配置的步驟和操作來安裝應用程序及其相關組件了眠蚂。

通過以上步驟煞聪，你就可以使用 Qt Installer Framework 成功創(chuàng)建一個功能豐富的安裝包，為你的 Qt 應用程序提供便捷的部署方式逝慧。