如何通过QtIFW禁止在不同目录重复安装应用（CMake集成场景）

核心方案 #

利用Qt Installer Framework（QtIFW）的脚本API检测系统中已安装的同包名实例，在安装前拦截重复操作；同时通过CMake的CPack IFW生成器集成该脚本。

1. 编写QtIFW安装拦截脚本 #

创建名为installscript.qs的脚本文件，通过QInstaller.installedPackages()遍历已安装包，匹配你的应用唯一包名来阻止重复安装：

function Component() {}

Component.prototype.isInstallable = function() {
    const targetPkgName = "com.yourcompany.yourapp"; // 替换为你的应用唯一包名
    const installedPkgs = installer.installedPackages();

    for (let i = 0; i < installedPkgs.length; i++) {
        if (installedPkgs[i].name === targetPkgName) {
            installer.setMessageBoxTitle("安装错误");
            installer.setMessageBoxInformativeText("该应用已在系统中安装，无法重复安装。");
            return false;
        }
    }
    return true;
};

如果需要支持版本升级（阻止同/旧版本重复安装，允许新版本覆盖），可修改脚本逻辑：

Component.prototype.isInstallable = function() {
    const targetPkgName = "com.yourcompany.yourapp";
    const currentVersion = installer.value("ProductVersion");
    const installedPkgs = installer.installedPackages();

    for (let i = 0; i < installedPkgs.length; i++) {
        const pkg = installedPkgs[i];
        if (pkg.name === targetPkgName) {
            if (pkg.version >= currentVersion) {
                installer.setMessageBoxTitle("安装错误");
                installer.setMessageBoxInformativeText("已安装相同或更高版本的应用，无需重复安装。");
                return false;
            }
            // 版本低于当前，允许升级
            return true;
        }
    }
    return true;
};

2. CMake集成配置 #

在项目的CMakeLists.txt中，通过CPack的IFW生成器指定上述脚本，并确保包名与脚本一致：

# 基础CPack配置
set(CPACK_PACKAGE_NAME "YourAppName")
set(CPACK_PACKAGE_VENDOR "YourCompany")
set(CPACK_PACKAGE_VERSION_MAJOR "1")
set(CPACK_PACKAGE_VERSION_MINOR "0")
set(CPACK_PACKAGE_VERSION_PATCH "0")

# QtIFW生成器配置
set(CPACK_GENERATOR "IFW")
# 指定安装脚本路径
set(CPACK_IFW_INSTALL_SCRIPT "${CMAKE_SOURCE_DIR}/installscript.qs")
# 设置唯一包名（必须与脚本中的targetPkgName完全一致）
set(CPACK_IFW_PACKAGE_PRODUCT_CODE "com.yourcompany.yourapp")
# 可选：设置版本，供脚本的版本判断使用
set(CPACK_IFW_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH}")

include(CPack)

关键注意事项 #

• 包名唯一性：必须使用反向域名格式（如com.yourcompany.yourapp），避免与其他QtIFW安装的应用冲突。
• 系统兼容性：QtIFW会自动读取Windows注册表、macOS plist、Linux配置文件中的安装记录，installedPackages()可跨平台正常工作。
• 测试验证：安装一个实例后，再次运行安装程序，应弹出错误提示并终止安装流程。

内容的提问来源于stack exchange，提问作者Martin Fehrs