当前位置：首页 > news >正文

QSimpleUpdater：解锁 Qt 应用自动更新的全新姿势

news 来源：原创 2025/6/15 5:58:10

1.简介

2.核心优势

3.更新流程图

4.使用方法

5.常问问题

1.简介

在软件开发领域，应用更新是维持用户体验的关键环节。对于 Qt 开发者而言，实现高效、稳定的自动更新功能往往面临诸多挑战。本文将深入解析 QSimpleUpdater 这一轻量级第三方模块，从原理到实战，带你解锁 Qt 应用自动更新的全新方式。

下载地址：https://gitee.com/YDusky/QSimpleUpdater

解决了传统更新方案的痛点：

实现复杂：原生 Qt 需手动处理网络请求、版本比对、安装包下载等流程

跨平台适配难：Windows、macOS、Linux 需分别处理更新逻辑

用户体验差：更新过程可能出现卡顿、进度不明确等问题

更新界面：

更新中

更新完成

2.核心优势

特性	优势说明
轻量级集成	仅需引入头文件和库文件，无需修改项目架构
跨平台支持	一套代码适配 Windows/macOS/Linux，兼容 Qt 5.6+
全流程自动化	自动检测更新、下载安装包、重启应用，支持断点续传
高度可定制	自定义更新界面、网络请求策略、版本校验规则
低耦合设计	不依赖 Qt 额外模块，可独立集成到现有项目

3.更新流程图

4.使用方法

在项目源码地址下载源码（https://github.com/alex-spataru/QSimpleUpdater）。
将QSimpleUpdater文件夹复制到"3rd-party"文件夹中。
在你的项目文件中(*.pro)包含QSimpleUpdater.pri文件即可使用。

5.常问问题

1.如何检测更新
QSimpleUpdater先下载一个json格式的升级定义文件。这个文件指定了各个平台的最新版本、下载链接和更新日志。如果需要的话可以注册你自己的平台。
接着QSimpleUpdater会对比本地版本和远程版本，如果远程版本高于本地版本，说明存在一个可用的更新，并通知用户。
一个典型的升级定义文件updates.json

{"updates": {"windows": {"open-url": "","latest-version": "1.0","download-url": "https://raw.githubusercontent.com/alex-spataru/QSimpleUpdater/master/tutorial/download/YesItWorks.jpg","changelog": "This is an example changelog for Windows. Go on...","mandatory": true},"osx": {"open-url": "","latest-version": "1.0","download-url": "https://raw.githubusercontent.com/alex-spataru/QSimpleUpdater/master/tutorial/download/YesItWorks.jpg","changelog": "This is an example changelog for Mac OS X. Go on...","mandatory": true},"linux": {"open-url": "","latest-version": "1.0","download-url": "https://raw.githubusercontent.com/alex-spataru/QSimpleUpdater/master/tutorial/download/YesItWorks.jpg","changelog": "This is an example changelog for Linux. Go on...","mandatory": true},"ios": {"open-url": "","latest-version": "1.0","download-url": "https://raw.githubusercontent.com/alex-spataru/QSimpleUpdater/master/tutorial/download/YesItWorks.jpg","changelog": "This is an example changelog for iOS. Go on...","mandatory": true},"android": {"open-url": "","latest-version": "1.0","download-url": "https://raw.githubusercontent.com/alex-spataru/QSimpleUpdater/master/tutorial/download/YesItWorks.jpg","changelog": "This is an example changelog for Android. Go on...","mandatory": true}}
}

2.能自定义升级通知么
答案是Yes，不仅可以通过QSimpleUpdater的接口来启用/关闭内置的通知，还可以连接QSimpleUpdater的信号自己实现通知。
在tutorial的界面中，可以看到五个复选框，分别表示：

●是否开启所有通知
●更新可用时是否通知我
●是否使用内置的下载器
●是否使用内置的检测通知
●是否强制升级

这五个复选框分别对应五个接口

QSimpleUpdater::getInstance->setNotifyOnFinish(url, false);
QSimpleUpdater::getInstance->setNotifyOnUpdate(url, true);
QSimpleUpdater::getInstance->setDownloaderEnabled(url, true);
QSimpleUpdater::getInstance->setUseCustomAppcast(url, false);
QSimpleUpdater::getInstance->setMandatoryUpdate(url, false);

3.应用程序能否直接下载更新？

对。如果有可用的更新，库将提示用户是否要下载更新。您可以使用以下代码启用或禁用集成下载器：

QString url = "https://MyBadassApplication.com/updates.json";
QSimpleUpdater::getInstance()->setDownloaderEnabled (url, true);

4.为何每个接口都要指定URL

QSimpleUpdater允许您使用不同的更新程序实例，可以通过更新定义的URL访问这些实例。虽然不一定要使用多个更新程序实例，但这对于使用插件或不同模块的应用程序很有用。

假设你正在开发一款游戏，在这种情况下，你可以使用以下代码：

// Update the game textures
QString textures_url = "https://MyBadassGame.com/textures.json"
QSimpleUpdater::getInstance()->setModuleName    (textures_url, "textures");
QSimpleUpdater::getInstance()->setModuleVersion (textures_url, "0.4");
QSimpleUpdater::getInstance()->checkForUpdates  (textures_url);// Update the game sounds
QString sounds_url = "https://MyBadassGame.com/sounds.json"
QSimpleUpdater::getInstance()->setModuleName    (sounds_url, "sounds");
QSimpleUpdater::getInstance()->setModuleVersion (sounds_url, "0.6");
QSimpleUpdater::getInstance()->checkForUpdates  (sounds_url);// Update the client (name & versions are already stored in qApp)
QString client_url = "https://MyBadassGame.com/client.json"
QSimpleUpdater::getInstance()->checkForUpdates (client_url);

下载地址：