3#if defined(QT_UTILITIES_GUI_QTWIDGETS)
7#include "resources/config.h"
12#include <c++utilities/application/argumentparser.h>
16#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
17#include <c++utilities/io/ansiescapecodes.h>
18#include <c++utilities/io/archive.h>
20#include <QCoreApplication>
25#include <QFutureWatcher>
27#include <QJsonDocument>
29#include <QJsonParseError>
32#include <QNetworkAccessManager>
33#include <QNetworkReply>
35#include <QRegularExpression>
36#include <QStringBuilder>
37#include <QVersionNumber>
38#include <QtConcurrentRun>
41#if defined(QT_UTILITIES_GUI_QTWIDGETS)
48#if defined(QT_UTILITIES_GUI_QTWIDGETS)
49#include <QCoreApplication>
52#if defined(QT_UTILITIES_SETUP_TOOLS_ENABLED)
53#include "ui_updateoptionpage.h"
57class UpdateOptionPage {
59 void setupUi(QWidget *)
62 void retranslateUi(QWidget *)
71#include "resources/config.h"
73#if (QT_VERSION >= QT_VERSION_CHECK(6, 0, 0))
74#define QT_UTILITIES_VERSION_SUFFIX QString()
76#define QT_UTILITIES_VERSION_SUFFIX QStringLiteral("-qt5")
79#if defined(Q_OS_WINDOWS)
80#define QT_UTILITIES_EXE_REGEX "\\.exe"
82#define QT_UTILITIES_EXE_REGEX ""
85#if defined(Q_OS_WIN64)
86#if defined(Q_PROCESSOR_X86_64)
87#define QT_UTILITIES_DOWNLOAD_REGEX "-.*-x86_64-w64-mingw32"
88#elif defined(Q_PROCESSOR_ARM_64)
89#define QT_UTILITIES_DOWNLOAD_REGEX "-.*-aarch64-w64-mingw32"
91#elif defined(Q_OS_WIN32)
92#define QT_UTILITIES_DOWNLOAD_REGEX "-.*-i686-w64-mingw32"
93#elif defined(__GNUC__) && defined(Q_OS_LINUX) && !defined(Q_OS_ANDROID)
94#if defined(Q_PROCESSOR_X86_64)
95#define QT_UTILITIES_DOWNLOAD_REGEX "-.*-x86_64-pc-linux-gnu"
96#elif defined(Q_PROCESSOR_ARM_64)
97#define QT_UTILITIES_DOWNLOAD_REGEX "-.*-aarch64-pc-linux-gnu"
101#if defined(Q_OS_WINDOWS) && (QT_VERSION >= QT_VERSION_CHECK(6, 6, 0))
102#include <QNtfsPermissionCheckGuard>
107#if (QT_VERSION >= QT_VERSION_CHECK(6, 4, 0))
113#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
114static QNetworkRequest makeNetworkRequest(
const QUrl &url, QNetworkRequest::CacheLoadControl cacheLoadControl)
116 auto request = QNetworkRequest(url);
117 request.setAttribute(QNetworkRequest::RedirectPolicyAttribute, QNetworkRequest::NoLessSafeRedirectPolicy);
118 request.setAttribute(QNetworkRequest::CacheLoadControlAttribute, cacheLoadControl);
122struct VersionAndSuffix {
123 operator bool()
const
125 return !version.isNull();
127 bool operator>(
const VersionAndSuffix &rhs)
const
129 const auto cmp = QVersionNumber::compare(version, rhs.version);
132 }
else if (cmp < 0) {
135 if (!suffix.isEmpty() && rhs.suffix.isEmpty()) {
138 if (suffix.isEmpty() && !rhs.suffix.isEmpty()) {
142 return suffix > rhs.suffix;
144 QString toString()
const
146 return version.toString() + suffix;
148 static VersionAndSuffix fromString(
const QString &versionString)
150 auto res = VersionAndSuffix();
152 res.version = QVersionNumber::fromString(versionString, &suffixIndex);
153 res.suffix = suffixIndex >= 0 ? versionString.mid(suffixIndex) : QString();
155 if (
static const auto validSuffixRegex = QRegularExpression(QRegularExpression::anchoredPattern(QStringLiteral(
"-?\\w+\\d?")));
156 !validSuffixRegex.match(res.suffix).hasMatch()) {
161 QVersionNumber version;
166 QNetworkRequest makeRequest(
const QUrl &url)
const
168 return makeNetworkRequest(url, cacheLoadControl);
171 QNetworkAccessManager *nm =
nullptr;
172 CppUtilities::DateTime lastCheck;
174 QNetworkRequest::CacheLoadControl cacheLoadControl = QNetworkRequest::PreferNetwork;
175 VersionAndSuffix currentVersion;
176 QRegularExpression gitHubRegex = QRegularExpression(QStringLiteral(
".*/github.com/([^/]+)/([^/]+)(/.*)?"));
177 QRegularExpression gitHubRegex2 = QRegularExpression(QStringLiteral(
".*/([^/.]+)\\.github.io/([^/]+)(/.*)?"));
178 QRegularExpression assetRegex = QRegularExpression();
179 QString executableName;
180 QString previouslyFoundNewVersion;
182 QString latestVersion;
183 QString additionalInfo;
184 QString releaseNotes;
189 QUrl previousVersionDownloadUrl;
190 QUrl previousVersionSignatureUrl;
191 QList<std::variant<QJsonArray, QString>> previousVersionAssets;
192 bool inProgress =
false;
193 bool updateAvailable =
false;
194 bool verbose =
false;
206#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
209 m_p->verbose = qEnvironmentVariableIntValue(PROJECT_VARNAME_UPPER
"_UPDATER_VERBOSE");
211 const auto &appInfo = CppUtilities::applicationInfo;
212 const auto url = QString::fromUtf8(appInfo.url);
213 auto gitHubMatch = m_p->gitHubRegex.match(url);
214 if (!gitHubMatch.hasMatch()) {
215 gitHubMatch = m_p->gitHubRegex2.match(url);
217 const auto gitHubOrga = gitHubMatch.captured(1);
218 const auto gitHubRepo = gitHubMatch.captured(2);
219 if (gitHubOrga.isNull() || gitHubRepo.isNull()) {
224 = QStringLiteral(
"https://api.github.com/repos/") % gitHubOrga % QChar(
'/') % gitHubRepo % QStringLiteral(
"/releases?per_page=25");
225 m_p->currentVersion = VersionAndSuffix::fromString(QString::fromUtf8(appInfo.version));
226#ifdef QT_UTILITIES_DOWNLOAD_REGEX
227 m_p->assetRegex = QRegularExpression(m_p->executableName + QStringLiteral(QT_UTILITIES_DOWNLOAD_REGEX
"\\..+"));
230 qDebug() <<
"deduced executable name: " << m_p->executableName;
231 qDebug() <<
"assumed current version: " << m_p->currentVersion.version;
232 qDebug() <<
"asset regex for current platform: " << m_p->assetRegex;
238#ifdef QT_UTILITIES_FAKE_NEW_VERSION_AVAILABLE
239 QTimer::singleShot(10000, Qt::VeryCoarseTimer,
this, [
this] { emit
updateAvailable(QStringLiteral(
"foo"), QString()); });
249#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
252 return !m_p->assetRegex.pattern().isEmpty();
258#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
261 return m_p->inProgress;
267#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
270 return m_p->updateAvailable;
276#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
285#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
294#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
295 static const auto v = QString();
298 return m_p->executableName;
304#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
305 static const auto v = QString();
308 return m_p->newVersion;
314#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
315 static const auto v = QString();
318 return m_p->latestVersion;
324#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
325 static const auto v = QString();
328 return m_p->additionalInfo;
334#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
335 static const auto v = QString();
338 return m_p->releaseNotes;
349#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
350 static const auto v = QUrl();
353 return m_p->downloadUrl;
359#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
360 static const auto v = QUrl();
363 return m_p->signatureUrl;
369#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
370 static const auto v = QUrl();
373 return m_p->previousVersionDownloadUrl;
379#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
380 static const auto v = QUrl();
383 return m_p->previousVersionSignatureUrl;
389#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
390 return CppUtilities::DateTime();
392 return m_p->lastCheck;
398#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
401 settings->beginGroup(QStringLiteral(
"updating"));
402 m_p->newVersion = settings->value(
"newVersion").toString();
403 m_p->latestVersion = settings->value(
"latestVersion").toString();
404 m_p->releaseNotes = settings->value(
"releaseNotes").toString();
405 m_p->downloadUrl = settings->value(
"downloadUrl").toUrl();
406 m_p->signatureUrl = settings->value(
"signatureUrl").toUrl();
407 m_p->previousVersionDownloadUrl = settings->value(
"previousVersionDownloadUrl").toUrl();
408 m_p->previousVersionSignatureUrl = settings->value(
"previousVersionSignatureUrl").toUrl();
409 m_p->lastCheck = CppUtilities::DateTime(settings->value(
"lastCheck").toULongLong());
410 m_p->flags =
static_cast<UpdateCheckFlags>(settings->value(
"flags").toULongLong());
411 settings->endGroup();
417#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
420 settings->beginGroup(QStringLiteral(
"updating"));
421 settings->setValue(
"newVersion", m_p->newVersion);
422 settings->setValue(
"latestVersion", m_p->latestVersion);
423 settings->setValue(
"releaseNotes", m_p->releaseNotes);
424 settings->setValue(
"downloadUrl", m_p->downloadUrl);
425 settings->setValue(
"signatureUrl", m_p->signatureUrl);
426 settings->setValue(
"previousVersionDownloadUrl", m_p->previousVersionDownloadUrl);
427 settings->setValue(
"previousVersionSignatureUrl", m_p->previousVersionSignatureUrl);
428 settings->setValue(
"lastCheck",
static_cast<qulonglong
>(m_p->lastCheck.ticks()));
429 settings->setValue(
"flags",
static_cast<qulonglong
>(m_p->flags));
430 settings->endGroup();
436#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
437 if (m_p->inProgress) {
438 return tr(
"checking …");
441 if (!m_p->error.isEmpty()) {
442 return tr(
"unable to check: %1").arg(m_p->error);
444#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
445 if (!m_p->newVersion.isEmpty()) {
446 return tr(
"new version available: %1 (last checked: %2)").arg(m_p->newVersion, QString::fromStdString(m_p->lastCheck.toIsoString()));
447 }
else if (!m_p->latestVersion.isEmpty()) {
448 return tr(
"no new version available, latest release is: %1 (last checked: %2)")
449 .arg(m_p->latestVersion, QString::fromStdString(m_p->lastCheck.toIsoString()));
452 return tr(
"unknown");
457#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
464#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
465void UpdateNotifier::setCacheLoadControl(QNetworkRequest::CacheLoadControl cacheLoadControl)
467 m_p->cacheLoadControl = cacheLoadControl;
471void UpdateNotifier::setError(
const QString &context, QNetworkReply *reply)
473#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
477 m_p->error = context + reply->errorString();
483void UpdateNotifier::setError(
const QString &context,
const QJsonParseError &jsonError,
const QByteArray &response)
485#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
490 m_p->error = context % jsonError.errorString() % QChar(
' ') % QChar(
'(') % tr(
"at offset %1").arg(jsonError.offset) % QChar(
')');
491 if (!response.isEmpty()) {
492 m_p->error += QStringLiteral(
"\nResponse was: ");
493 m_p->error += QString::fromUtf8(response);
501#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
502 m_p->error = tr(
"This build of the application does not support checking for updates.");
506 if (!m_p->nm || m_p->inProgress) {
510 auto *
const reply = m_p->nm->get(m_p->makeRequest(m_p->releasesUrl));
511 connect(reply, &QNetworkReply::finished,
this, &UpdateNotifier::readReleases);
517#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
518 m_p->updateAvailable =
false;
519 m_p->downloadUrl.clear();
520 m_p->signatureUrl.clear();
521 m_p->latestVersion.clear();
522 m_p->newVersion.clear();
523 m_p->releaseNotes.clear();
527void UpdateNotifier::lastCheckNow()
const
529#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
530 m_p->lastCheck = CppUtilities::DateTime::now();
534#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
539bool UpdateNotifier::isVersionHigher(
const QString &lhs,
const QString &rhs)
541 return VersionAndSuffix::fromString(lhs) > VersionAndSuffix::fromString(rhs);
547#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
551 auto jsonError = QJsonParseError();
552 const auto replyDoc = QJsonDocument::fromJson(data, &jsonError);
553 if (jsonError.error != QJsonParseError::NoError) {
554 setError(tr(
"Unable to parse releases: "), jsonError, data);
558#if !defined(QT_JSON_READONLY)
560 qDebug().noquote() <<
"Update check: found releases: " << QString::fromUtf8(replyDoc.toJson(QJsonDocument::Indented));
564 const auto replyArray = replyDoc.array();
567 auto latestVersionFound = VersionAndSuffix();
568 auto latestVersionAssets = QJsonValue();
569 auto latestVersionAssetsUrl = QString();
570 auto latestVersionReleaseNotes = QString();
571 auto previousVersionAssets = QMap<QVersionNumber, std::variant<QJsonArray, QString>>();
572 for (
const auto &releaseInfoVal : replyArray) {
573 const auto releaseInfo = releaseInfoVal.toObject();
574 const auto tag = releaseInfo.value(QLatin1String(
"tag_name")).toString();
575 if ((skipPreReleases && releaseInfo.value(QLatin1String(
"prerelease")).toBool())
576 || (skipDrafts && releaseInfo.value(QLatin1String(
"draft")).toBool())) {
577 qDebug() <<
"Update check: skipping prerelease/draft: " << tag;
580 const auto versionStr = tag.startsWith(QChar(
'v')) ? tag.mid(1) : tag;
581 const auto version = VersionAndSuffix::fromString(versionStr);
582 const auto assets = releaseInfo.value(QLatin1String(
"assets"));
583 const auto assetsUrl = releaseInfo.value(QLatin1String(
"assets_url")).toString();
584 if (!latestVersionFound || version > latestVersionFound) {
585 latestVersionFound = version;
586 latestVersionAssets = assets;
587 latestVersionAssetsUrl = assetsUrl;
588 latestVersionReleaseNotes = releaseInfo.value(QLatin1String(
"body")).toString();
590 if (assets.isArray()) {
591 previousVersionAssets[version.version] = assets.toArray();
592 }
else if (!assetsUrl.isEmpty()) {
593 previousVersionAssets[version.version] = assetsUrl;
596 qDebug() <<
"Update check: skipping release: " << tag;
599 if (latestVersionFound) {
600 m_p->latestVersion = latestVersionFound.toString();
601 m_p->releaseNotes = latestVersionReleaseNotes;
602 previousVersionAssets.remove(latestVersionFound.version);
604 m_p->previousVersionAssets = previousVersionAssets.values();
606 const auto foundUpdate = latestVersionFound && latestVersionFound > m_p->currentVersion;
608 m_p->newVersion = latestVersionFound.toString();
610 if (latestVersionAssets.isArray()) {
611 return processAssets(latestVersionAssets.toArray(), foundUpdate,
false);
612 }
else if (foundUpdate) {
613 return queryRelease(latestVersionAssetsUrl, foundUpdate,
false);
620void UpdateNotifier::readReleases()
622#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
623 auto *
const reply =
static_cast<QNetworkReply *
>(sender());
624 reply->deleteLater();
625 switch (reply->error()) {
626 case QNetworkReply::NoError: {
630 case QNetworkReply::OperationCanceledError:
634 setError(tr(
"Unable to request releases: "), reply);
639void UpdateNotifier::queryRelease(
const QUrl &releaseUrl,
bool forUpdate,
bool forPreviousVersion)
641#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
644 Q_UNUSED(forPreviousVersion)
646 auto *
const reply = m_p->nm->get(m_p->makeRequest(releaseUrl));
647 reply->setProperty(
"forUpdate", forUpdate);
648 reply->setProperty(
"forPreviousVersion", forPreviousVersion);
649 connect(reply, &QNetworkReply::finished,
this, &UpdateNotifier::readRelease);
653void UpdateNotifier::readRelease()
655#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
656 auto *
const reply =
static_cast<QNetworkReply *
>(sender());
657 reply->deleteLater();
658 switch (reply->error()) {
659 case QNetworkReply::NoError: {
661 auto jsonError = QJsonParseError();
662 const auto response = reply->readAll();
663 const auto replyDoc = QJsonDocument::fromJson(response, &jsonError);
664 if (jsonError.error != QJsonParseError::NoError) {
665 setError(tr(
"Unable to parse release: "), jsonError, response);
668#if !defined(QT_JSON_READONLY)
670 qDebug().noquote() <<
"Update check: found release info: " << QString::fromUtf8(replyDoc.toJson(QJsonDocument::Indented));
673 processAssets(replyDoc.object().value(QLatin1String(
"assets")).toArray(), reply->property(
"forUpdate").toBool(),
674 reply->property(
"forPreviousVersion").toBool());
677 case QNetworkReply::OperationCanceledError:
681 setError(tr(
"Unable to request release: "), reply);
686void UpdateNotifier::processAssets(
const QJsonArray &assets,
bool forUpdate,
bool forPreviousVersion)
688#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
691 Q_UNUSED(forPreviousVersion)
693 for (
const auto &assetVal : assets) {
694 if (forPreviousVersion ? !m_p->previousVersionDownloadUrl.isEmpty() && !m_p->previousVersionSignatureUrl.isEmpty()
695 : !m_p->downloadUrl.isEmpty() && !m_p->signatureUrl.isEmpty()) {
698 const auto asset = assetVal.toObject();
699 const auto assetName = asset.value(QLatin1String(
"name")).toString();
700 if (assetName.isEmpty()) {
703 if (!m_p->assetRegex.match(assetName).hasMatch()) {
705 qDebug() <<
"Update check: skipping asset: " << assetName;
709 const auto url = asset.value(QLatin1String(
"browser_download_url")).toString();
710 if (assetName.endsWith(QLatin1String(
".sig"))) {
711 (forPreviousVersion ? m_p->previousVersionSignatureUrl : m_p->signatureUrl) = url;
713 (forPreviousVersion ? m_p->previousVersionDownloadUrl : m_p->downloadUrl) = url;
717 m_p->updateAvailable = !m_p->downloadUrl.isEmpty();
719 if (m_p->downloadUrl.isEmpty() && m_p->previousVersionDownloadUrl.isEmpty() && !m_p->previousVersionAssets.isEmpty()) {
720 auto previousVersionAssets = m_p->previousVersionAssets.takeLast();
721 if (std::holds_alternative<QJsonArray>(previousVersionAssets)) {
722 return processAssets(std::get<QJsonArray>(previousVersionAssets), forUpdate,
true);
724 return queryRelease(std::get<QString>(previousVersionAssets), forUpdate,
true);
729 if (forUpdate && m_p->updateAvailable && m_p->newVersion != m_p->previouslyFoundNewVersion) {
731 m_p->previouslyFoundNewVersion = m_p->newVersion;
737#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
739 QNetworkRequest makeRequest(
const QUrl &url)
const
741 return makeNetworkRequest(url, cacheLoadControl);
744 QNetworkAccessManager *nm =
nullptr;
745 QFile *fakeDownload =
nullptr;
746 QNetworkReply *currentDownload =
nullptr;
747 QNetworkReply *signatureDownload =
nullptr;
748 QNetworkRequest::CacheLoadControl cacheLoadControl = QNetworkRequest::PreferNetwork;
749 QString
error, statusMessage;
750 QByteArray signature;
751 QFutureWatcher<QPair<QString, QString>> watcher;
752 QString executableName;
753 QString signatureExtension;
754 QRegularExpression executableRegex = QRegularExpression();
765 :
Updater(executableName, QString(), parent)
769Updater::Updater(
const QString &executableName,
const QString &signatureExtension, QObject *parent)
773#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
774 Q_UNUSED(executableName)
775 Q_UNUSED(signatureExtension)
777 connect(&m_p->watcher, &QFutureWatcher<void>::finished,
this, &Updater::concludeUpdate);
778 m_p->executableName = executableName;
779 m_p->signatureExtension = signatureExtension;
780 const auto signatureRegex = signatureExtension.isEmpty()
782 : QString(QStringLiteral(
"(") % QRegularExpression::escape(signatureExtension) % QStringLiteral(
")?"));
783#ifdef QT_UTILITIES_EXE_REGEX
784 m_p->executableRegex = QRegularExpression(executableName % QStringLiteral(
QT_UTILITIES_EXE_REGEX) % signatureRegex);
795#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
796 return m_p->currentDownload !=
nullptr || m_p->signatureDownload !=
nullptr || m_p->watcher.isRunning();
804#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
805 return isInProgress() ? tr(
"Update in progress …") : (m_p->error.isEmpty() ? tr(
"Update done") : tr(
"Update failed"));
818#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
819 return m_p->statusMessage.isEmpty() ? m_p->error : m_p->statusMessage;
827#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
828 return m_p->storedPath;
830 static const auto empty = QString();
837#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
846#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
847 m_p->verifyFunction = std::move(verifyFunction);
849 Q_UNUSED(verifyFunction)
853#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
854void Updater::setCacheLoadControl(QNetworkRequest::CacheLoadControl cacheLoadControl)
856 m_p->cacheLoadControl = cacheLoadControl;
862#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
863 Q_UNUSED(downloadUrl)
864 Q_UNUSED(signatureUrl)
865 setError(tr(
"This build of the application does not support self-updating."));
871 startDownload(downloadUrl, signatureUrl);
878#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
879 if (m_p->currentDownload) {
880 m_p->currentDownload->abort();
882 if (m_p->signatureDownload) {
883 m_p->signatureDownload->abort();
885 if (m_p->watcher.isRunning()) {
886 m_p->watcher.cancel();
891void Updater::setError(
const QString &error)
893#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
894 m_p->statusMessage.clear();
902void Updater::startDownload(
const QString &downloadUrl,
const QString &signatureUrl)
904#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
905 Q_UNUSED(downloadUrl)
906 Q_UNUSED(signatureUrl)
909 m_p->storedPath.clear();
910 m_p->signature.clear();
912 if (
const auto fakeDownloadPath = qEnvironmentVariable(PROJECT_VARNAME_UPPER
"_UPDATER_FAKE_DOWNLOAD"); !fakeDownloadPath.isEmpty()) {
913 m_p->fakeDownload =
new QFile(fakeDownloadPath);
914 if (!m_p->fakeDownload->open(QFile::ReadOnly)) {
915 qWarning() <<
"Unable to open fake download file from:" << m_p->fakeDownload->errorString();
916 qDebug() << PROJECT_VARNAME_UPPER
"_UPDATER_FAKE_DOWNLOAD was set to:" << fakeDownloadPath;
923 auto request = m_p->makeRequest(QUrl(downloadUrl));
924 m_p->statusMessage = tr(
"Downloading %1").arg(downloadUrl);
925 m_p->currentDownload = m_p->nm->get(request);
929 connect(m_p->currentDownload, &QNetworkReply::finished,
this, &Updater::handleDownloadFinished);
931 if (!signatureUrl.isEmpty()) {
932 request.setUrl(signatureUrl);
933 m_p->signatureDownload = m_p->nm->get(request);
934 connect(m_p->signatureDownload, &QNetworkReply::finished,
this, &Updater::handleDownloadFinished);
939void Updater::handleDownloadFinished()
941#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
942 if (m_p->signatureDownload && !m_p->signatureDownload->isFinished()) {
947 if (!m_p->currentDownload->isFinished()) {
951 if (m_p->signatureDownload) {
953 m_p->signatureDownload->deleteLater();
954 m_p->signatureDownload =
nullptr;
957 if (m_p->error.isEmpty()) {
960 m_p->currentDownload->deleteLater();
962 m_p->currentDownload =
nullptr;
966void Updater::readSignature()
968#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
969 switch (m_p->signatureDownload->error()) {
970 case QNetworkReply::NoError:
971 m_p->signature = m_p->signatureDownload->readAll();
974 setError(tr(
"Unable to download signature: ") + m_p->signatureDownload->errorString());
979void Updater::storeExecutable()
981#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
982 m_p->statusMessage = tr(
"Extracting …");
985 auto *reply =
static_cast<QIODevice *
>(m_p->fakeDownload);
986 auto archiveName = QString();
987 auto hasError =
false;
989 archiveName = m_p->fakeDownload->fileName();
990 hasError = m_p->fakeDownload->error() != QFileDevice::NoError;
992 reply = m_p->currentDownload;
993 archiveName = m_p->currentDownload->request().url().fileName();
994 hasError = m_p->currentDownload->error() != QNetworkReply::NoError;
997 reply->deleteLater();
998 setError(tr(
"Unable to download update: ") + reply->errorString());
1001 auto res = QtConcurrent::run([
this, reply, archiveName] {
1002 const auto data = reply->readAll();
1003 const auto dataView = std::string_view(data.data(),
static_cast<std::size_t
>(data.size()));
1004 auto foundExecutable =
false, foundSignature =
false;
1005 auto error = QString(), storePath = QString();
1006 auto newExeName = std::string(), signatureName = std::string();
1007 auto newExeData = std::string();
1008 auto newExe = QFile();
1009 reply->deleteLater();
1012 const auto appDirPath = QCoreApplication::applicationDirPath();
1013 const auto appFilePath = QCoreApplication::applicationFilePath();
1014 if (appDirPath.isEmpty() || appFilePath.isEmpty()) {
1015 error = tr(
"Unable to determine application path.");
1016 return QPair<QString, QString>(
error, storePath);
1020 const auto checkCancellation = [
this, &
error] {
1021 if (m_p->watcher.isCanceled()) {
1022 error = tr(
"Extraction was cancelled.");
1028 if (checkCancellation()) {
1029 return QPair<QString, QString>(
error, storePath);
1033 CppUtilities::walkThroughArchiveFromBuffer(
1034 dataView, archiveName.toStdString(),
1035 [
this](
const char *filePath,
const char *fileName, mode_t mode) {
1038 if (m_p->watcher.isCanceled()) {
1041 return m_p->executableRegex.match(QString::fromUtf8(fileName)).hasMatch();
1043 [&](std::string_view path, CppUtilities::ArchiveFile &&file) {
1045 if (checkCancellation()) {
1048 if (file.type != CppUtilities::ArchiveFileType::Regular) {
1053 const auto fileName = QString::fromUtf8(file.name.data(),
static_cast<QString::size_type
>(file.name.size()));
1054 if (!m_p->signatureExtension.isEmpty() && fileName.endsWith(m_p->signatureExtension)) {
1055 m_p->signature = QByteArray::fromStdString(file.content);
1056 foundSignature =
true;
1057 signatureName = file.name;
1058 return foundExecutable;
1062 if (fileName.endsWith(QLatin1String(
".sig"))) {
1067 foundExecutable =
true;
1068 newExeName = file.name;
1069 newExe.setFileName(appDirPath % QChar(
'/') % fileName % QStringLiteral(
".tmp"));
1070 if (!newExe.open(QFile::WriteOnly | QFile::Truncate)) {
1071 error = tr(
"Unable to create new executable under \"%1\": %2").arg(newExe.fileName(), newExe.errorString());
1074 const auto size =
static_cast<qint64
>(file.content.size());
1075 if (!(newExe.write(file.content.data(), size) == size) || !newExe.flush()) {
1076 error = tr(
"Unable to write new executable under \"%1\": %2").arg(newExe.fileName(), newExe.errorString());
1079 if (!newExe.setPermissions(
1080 newExe.permissions() | QFileDevice::ExeOwner | QFileDevice::ExeUser | QFileDevice::ExeGroup | QFileDevice::ExeOther)) {
1081 error = tr(
"Unable to make new binary under \"%1\" executable.").arg(newExe.fileName());
1085 storePath = newExe.fileName();
1086 newExeData = std::move(file.content);
1087 return foundSignature || m_p->signatureExtension.isEmpty();
1089 }
catch (
const CppUtilities::ArchiveException &e) {
1090 error = tr(
"Unable to open downloaded archive: %1").arg(e.what());
1092 if (
error.isEmpty() && foundExecutable) {
1094 if (m_p->verifyFunction) {
1095 if (const auto verifyError = m_p->verifyFunction(Updater::Update{ .executableName = newExeName,
1096 .signatureName = signatureName,
1098 .signature = std::string_view(m_p->signature.data(), static_cast<std::size_t>(m_p->signature.size())) });
1099 !verifyError.isEmpty()) {
1100 error = tr(
"Unable to verify whether downloaded binary is valid: %1").arg(verifyError);
1101 return QPair<QString, QString>(error, storePath);
1106 auto currentExeInfo = QFileInfo(appFilePath);
1107 auto currentExe = QFile(appFilePath);
1108 const auto completeSuffix = currentExeInfo.completeSuffix();
1109 const auto suffixWithDot = completeSuffix.isEmpty() ? QString() : QChar(
'.') + completeSuffix;
1110 for (
auto i = 0; i < 100; ++i) {
1111 const auto backupNumber = i ? QString::number(i) : QString();
1112 const auto backupPath = QString(currentExeInfo.path() % QChar(
'/') % currentExeInfo.baseName() % QStringLiteral(
"-backup")
1113 % backupNumber % QChar(
'-') % QString::fromUtf8(CppUtilities::applicationInfo.version) % suffixWithDot);
1114 if (QFile::exists(backupPath)) {
1117 if (!currentExe.rename(backupPath)) {
1118 error = tr(
"Unable to move current executable to \"%1\": %2").arg(backupPath, currentExe.errorString());
1119 return QPair<QString, QString>(
error, storePath);
1125 if (!newExe.rename(appFilePath)) {
1126 error = tr(
"Unable to rename new executable \"%1\" to \"%2\": %3").arg(newExe.fileName(), appFilePath, newExe.errorString());
1127 return QPair<QString, QString>(error, storePath);
1129 storePath = newExe.fileName();
1131 if (error.isEmpty() && !foundExecutable) {
1132 error = tr(
"Unable to find executable in downloaded archive.");
1134 return QPair<QString, QString>(error, storePath);
1136 m_p->watcher.setFuture(std::move(res));
1140void Updater::concludeUpdate()
1142#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1143 auto res = m_p->watcher.result();
1144 m_p->error = res.first;
1145 m_p->storedPath = res.second;
1146 if (!m_p->error.isEmpty()) {
1147 m_p->statusMessage.clear();
1148 emit updateFailed(m_p->error);
1150 m_p->statusMessage = tr(
"Update stored under: %1").arg(m_p->storedPath);
1151 emit updateStored();
1153 emit updateStatusChanged(statusMessage());
1154 emit updatePercentageChanged(0, 0);
1155 emit inProgressChanged(
false);
1161 :
updater(executableName.isEmpty() ?
notifier.executableName() : executableName, signatureExtension)
1188 const QString &executableName,
const QString &signatureExtension, QSettings *settings, QNetworkAccessManager *nm, QObject *parent)
1192 m_p->notifier.setNetworkAccessManager(nm);
1193 m_p->updater.setNetworkAccessManager(nm);
1194 m_p->timer.setSingleShot(
true);
1195 m_p->timer.setTimerType(Qt::VeryCoarseTimer);
1196 m_p->settings = settings;
1207 return &m_p->notifier;
1212 return &m_p->updater;
1217 if (m_p->checkInterval.has_value()) {
1218 return m_p->checkInterval.value();
1220 m_p->settings->beginGroup(QStringLiteral(
"updating"));
1222 checkInterval.duration = CppUtilities::TimeSpan::fromMilliseconds(m_p->settings->value(
"checkIntervalMs", 60 * 60 * 1000).toInt());
1223 checkInterval.enabled = m_p->settings->value(
"automaticChecksEnabled",
false).toBool();
1224 m_p->settings->endGroup();
1231 m_p->settings->beginGroup(QStringLiteral(
"updating"));
1232 m_p->settings->setValue(
"checkIntervalMs",
checkInterval.duration.totalMilliseconds());
1233 m_p->settings->setValue(
"automaticChecksEnabled",
checkInterval.enabled);
1234 m_p->settings->endGroup();
1235#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1236 scheduleNextUpdateCheck();
1242 return m_p->considerSeparateSignature;
1247 m_p->considerSeparateSignature = consideringSeparateSignature;
1252 auto error = QString();
1253#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1254 static const auto appDirPath = QCoreApplication::applicationDirPath();
1255 if (appDirPath.isEmpty()) {
1256 return tr(
"Unable to determine the application directory.");
1258#if defined(Q_OS_WINDOWS) && (QT_VERSION >= QT_VERSION_CHECK(6, 6, 0))
1259 const auto permissionGuard = QNtfsPermissionCheckGuard();
1261 const auto dirInfo = QFileInfo(appDirPath);
1262 if (!dirInfo.isWritable()) {
1263 return tr(
"The directory where the executable is stored (%1) is not writable.").arg(appDirPath);
1269#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1270void UpdateHandler::setCacheLoadControl(QNetworkRequest::CacheLoadControl cacheLoadControl)
1272 m_p->notifier.setCacheLoadControl(cacheLoadControl);
1273 m_p->updater.setCacheLoadControl(cacheLoadControl);
1279#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1280 m_p->notifier.restore(m_p->settings);
1281 scheduleNextUpdateCheck();
1287 const auto &downloadUrl = !m_p->notifier.downloadUrl().isEmpty() ? m_p->notifier.downloadUrl() : m_p->notifier.previousVersionDownloadUrl();
1288 const auto &signatureUrl = !m_p->notifier.downloadUrl().isEmpty() ? m_p->notifier.signatureUrl() : m_p->notifier.previousVersionSignatureUrl();
1289 m_p->updater.performUpdate(downloadUrl.toString(), m_p->considerSeparateSignature ? signatureUrl.toString() : QString());
1294#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1295 m_p->notifier.save(m_p->settings);
1299void UpdateHandler::handleUpdateCheckDone()
1301#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1303 scheduleNextUpdateCheck();
1307#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1308void UpdateHandler::scheduleNextUpdateCheck()
1313 if (!interval.enabled || (interval.duration.isNull() && m_p->hasCheckedOnceSinceStartup)) {
1316 const auto timeLeft = interval.duration - (CppUtilities::DateTime::now() - m_p->notifier.lastCheck());
1317 std::cerr << CppUtilities::EscapeCodes::Phrases::Info
1318 <<
"Check for updates due in: " << timeLeft.toString(CppUtilities::TimeSpanOutputFormat::WithMeasures)
1319 << CppUtilities::EscapeCodes::Phrases::End;
1320 m_p->hasCheckedOnceSinceStartup =
true;
1321 m_p->timer.start(std::max(1000,
static_cast<int>(timeLeft.totalMilliseconds())));
1327 m_restartRequested =
true;
1328#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1329 QCoreApplication::quit();
1335#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1336 if (!m_restartRequested) {
1339 auto *
const process =
new QProcess(QCoreApplication::instance());
1340 auto args = QCoreApplication::arguments();
1342 process->setProgram(QCoreApplication::applicationFilePath());
1343 process->setArguments(args);
1344 process->startDetached();
1348#ifdef QT_UTILITIES_GUI_QTWIDGETS
1349struct UpdateOptionPagePrivate {
1351 : updateHandler(updateHandler)
1354 UpdateHandler *updateHandler =
nullptr;
1355 std::function<void()> restartHandler;
1358UpdateOptionPage::UpdateOptionPage(
UpdateHandler *updateHandler, QWidget *parentWidget)
1359 : UpdateOptionPageBase(parentWidget)
1360#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1361 , m_p(std::make_unique<UpdateOptionPagePrivate>(updateHandler))
1364#ifndef QT_UTILITIES_SETUP_TOOLS_ENABLED
1365 Q_UNUSED(updateHandler)
1369UpdateOptionPage::~UpdateOptionPage()
1373void UpdateOptionPage::setRestartHandler(std::function<
void()> &&handler)
1375 m_p->restartHandler = std::move(handler);
1376#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1377 if (ui() && m_p->restartHandler) {
1378 QObject::connect(ui()->restartPushButton, &QPushButton::clicked, widget(), m_p->restartHandler);
1383bool UpdateOptionPage::apply()
1385#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1386 if (!m_p->updateHandler) {
1390 .duration = CppUtilities::TimeSpan::fromMinutes(ui()->checkIntervalSpinBox->value()), .enabled = ui()->enabledCheckBox->isChecked() });
1394 m_p->updateHandler->notifier()->setFlags(flags);
1395 m_p->updateHandler->saveNotifierState();
1400void UpdateOptionPage::reset()
1402#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1403 if (!m_p->updateHandler) {
1406 const auto &checkInterval = m_p->updateHandler->checkInterval();
1407 ui()->checkIntervalSpinBox->setValue(
static_cast<int>(checkInterval.duration.totalMinutes()));
1408 ui()->enabledCheckBox->setChecked(checkInterval.enabled);
1409 const auto flags = m_p->updateHandler->notifier()->flags();
1415#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1416static QString formatReleaseNotes(
const QString &version,
const QString &releaseNotes)
1418 auto res = QCoreApplication::translate(
"QtGui::UpdateOptionPage",
"**Release notes of version %1:**\n\n").arg(version) + releaseNotes;
1421 static const auto re = QRegularExpression(R
"(https://github\.com/[^\s)]+)");
1422 static constexpr auto replacementLengthDiff = QString::difference_type(2);
1423 auto offset = QString::size_type();
1424 for (
auto it = re.globalMatch(res); it.hasNext(); offset += replacementLengthDiff) {
1425 const auto match = it.next();
1426 const auto replacement = QChar(
'<') % match.captured(0) % QChar(
'>');
1427 res.replace(match.capturedStart() + offset, match.capturedLength(), replacement);
1434QWidget *UpdateOptionPage::setupWidget()
1436#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1437 if (m_p->updateHandler && m_p->updateHandler->notifier()->isSupported()) {
1438 auto *
const widget = UpdateOptionPageBase::setupWidget();
1439 ui()->versionInUseValueLabel->setText(QString::fromUtf8(CppUtilities::applicationInfo.version));
1440 ui()->updateWidget->hide();
1441 ui()->releaseNotesPushButton->hide();
1442 updateLatestVersion();
1444 QObject::connect(ui()->updatePushButton, &QPushButton::clicked, widget, [
this, widget] {
1445 if (
const auto preCheckError = m_p->updateHandler->preCheck(); preCheckError.isEmpty()
1446 || QMessageBox::critical(widget, QCoreApplication::applicationName(),
1447 QCoreApplication::translate(
"QtGui::UpdateOptionPage",
"<p>%1</p><p><strong>Try the update nevertheless?</strong></p>")
1448 .arg(preCheckError),
1449 QMessageBox::Yes | QMessageBox::No)
1450 == QMessageBox::Yes) {
1451 m_p->updateHandler->performUpdate();
1454 QObject::connect(ui()->abortUpdatePushButton, &QPushButton::clicked, m_p->updateHandler->updater(), &
Updater::abortUpdate);
1455 if (m_p->restartHandler) {
1456 QObject::connect(ui()->restartPushButton, &QPushButton::clicked, widget, m_p->restartHandler);
1458 QObject::connect(ui()->releaseNotesPushButton, &QPushButton::clicked, widget, [
this, widget] {
1459 const auto *
const notifier = m_p->updateHandler->notifier();
1460 auto infobox = QMessageBox(widget);
1461 infobox.setWindowTitle(QCoreApplication::applicationName());
1462 infobox.setIcon(QMessageBox::Information);
1463 infobox.setText(formatReleaseNotes(notifier->latestVersion(), notifier->releaseNotes()));
1464#if QT_VERSION >= QT_VERSION_CHECK(5, 14, 0)
1465 infobox.setTextFormat(Qt::MarkdownText);
1467 infobox.setTextFormat(Qt::PlainText);
1474 const auto *const updater = m_p->updateHandler->updater();
1475 ui()->updateWidget->setVisible(true);
1476 ui()->updateInProgressLabel->setText(updater->overallStatus());
1477 ui()->updateProgressBar->setVisible(inProgress);
1478 ui()->abortUpdatePushButton->setVisible(inProgress);
1479 ui()->restartPushButton->setVisible(!inProgress && !updater->storedPath().isEmpty() && updater->error().isEmpty());
1482 [
this](
const QString &statusMessage) { ui()->updateStatusLabel->setText(statusMessage); });
1484 if (bytesTotal == 0) {
1485 ui()->updateProgressBar->setMaximum(0);
1487 ui()->updateProgressBar->setValue(static_cast<int>(bytesReceived * 100 / bytesTotal));
1488 ui()->updateProgressBar->setMaximum(100);
1495 auto *
const label =
new QLabel;
1496 label->setWindowTitle(QCoreApplication::translate(
"QtGui::UpdateOptionPage",
"Updating"));
1497 label->setAlignment(Qt::AlignCenter);
1498 label->setWordWrap(
true);
1499#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1500 label->setText(QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"Checking for updates is not supported on this platform."));
1502 label->setText(QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
1503 "This build of %1 has automatic updates disabled. You may update the application in an automated way via your package manager, though.")
1504 .arg(CppUtilities::applicationInfo.name));
1509void UpdateOptionPage::updateLatestVersion(
bool)
1511#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1512 if (!m_p->updateHandler) {
1515 const auto ¬ifier = *m_p->updateHandler->notifier();
1516 const auto &downloadUrl = notifier.downloadUrl();
1517 const auto &previousVersionDownloadUrl = notifier.previousVersionDownloadUrl();
1518 const auto downloadUrlEscaped = downloadUrl.toString().toHtmlEscaped();
1519 const auto previousVersionDownloadUrlEscaped = previousVersionDownloadUrl.toString().toHtmlEscaped();
1520 ui()->latestVersionValueLabel->setText(notifier.status());
1521 ui()->downloadUrlLabel->setText(downloadUrl.isEmpty()
1522 ? (notifier.latestVersion().isEmpty()
1523 ? QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"no new version available for download")
1524 : (QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"latest version provides no build for the current platform yet")
1525 + (previousVersionDownloadUrl.isEmpty()
1527 : QString(QStringLiteral(
"<br>")
1528 % QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"for latest build: ")
1529 % QStringLiteral(
"<a href=\"") % previousVersionDownloadUrlEscaped % QStringLiteral(
"\">")
1530 % previousVersionDownloadUrlEscaped % QStringLiteral(
"</a>")))))
1531 : (QStringLiteral(
"<a href=\"") % downloadUrlEscaped % QStringLiteral(
"\">") % downloadUrlEscaped % QStringLiteral(
"</a>")));
1532 ui()->updatePushButton->setText(!downloadUrl.isEmpty() || previousVersionDownloadUrl.isEmpty()
1533 ? QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"Update to latest version")
1534 : QCoreApplication::translate(
"QtUtilities::UpdateOptionPage",
"Update to latest available build"));
1535 ui()->updatePushButton->setDisabled(downloadUrl.isEmpty() && previousVersionDownloadUrl.isEmpty());
1536 ui()->releaseNotesPushButton->setHidden(notifier.releaseNotes().isEmpty());
1540VerificationErrorMessageBox::VerificationErrorMessageBox()
1542#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1543 setWindowTitle(QCoreApplication::applicationName());
1544 setStandardButtons(QMessageBox::Cancel | QMessageBox::Ignore);
1545 setDefaultButton(QMessageBox::Cancel);
1546 setIcon(QMessageBox::Critical);
1550VerificationErrorMessageBox::~VerificationErrorMessageBox()
1554int VerificationErrorMessageBox::execForError(QString &errorMessage,
const QString &explanation)
1556#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1557 auto loop = QEventLoop();
1558 QObject::connect(
this, &QDialog::finished, &loop, &QEventLoop::exit);
1559 QMetaObject::invokeMethod(
this,
"openForError", Qt::QueuedConnection, Q_ARG(QString, errorMessage), Q_ARG(QString, explanation));
1560 auto res = loop.exec();
1561 if (res == QMessageBox::Ignore) {
1562 errorMessage.clear();
1566 Q_UNUSED(errorMessage)
1567 Q_UNUSED(explanation)
1572void VerificationErrorMessageBox::openForError(
const QString &errorMessage,
const QString &explanation)
1574#ifdef QT_UTILITIES_SETUP_TOOLS_ENABLED
1575 setText(tr(
"<p>The signature of the downloaded executable could not be verified: %1</p>").arg(errorMessage) + explanation);
1578 Q_UNUSED(errorMessage)
1579 Q_UNUSED(explanation)
1583struct UpdateDialogPrivate {
1584 UpdateOptionPage *updateOptionPage =
nullptr;
1587UpdateDialog::UpdateDialog(QWidget *parent)
1589 , m_p(std::make_unique<UpdateDialogPrivate>())
1591 auto *
const category =
new OptionCategory;
1593 category->assignPages({ m_p->updateOptionPage });
1594 setWindowTitle(m_p->updateOptionPage->widget()->windowTitle());
1595 setTabBarAlwaysVisible(
false);
1596 setSingleCategory(category);
1599UpdateDialog::~UpdateDialog()
1603UpdateOptionPage *UpdateDialog::page()
1605 return m_p->updateOptionPage;
1608const UpdateOptionPage *UpdateDialog::page()
const
1610 return m_p->updateOptionPage;
1617#if defined(QT_UTILITIES_GUI_QTWIDGETS)
void respawnIfRestartRequested()
The SettingsDialog class provides a framework for creating settings dialogs with different categories...
The UpdateHandler class manages the non-graphical aspects of checking for new updates and performing ...
~UpdateHandler() override
bool isConsideringSeparateSignature() const
static UpdateHandler * mainInstance()
void setConsideringSeparateSignature(bool consideringSeparateSignature)
UpdateHandler(QSettings *settings, QNetworkAccessManager *nm, QObject *parent=nullptr)
Handles checking for updates and performing an update of the application if available.
const CheckInterval & checkInterval() const
UpdateNotifier * notifier
void setCheckInterval(CheckInterval checkInterval)
The UpdateNotifier class allows checking for new updates.
void setFlags(UpdateCheckFlags flags)
void setNetworkAccessManager(QNetworkAccessManager *nm)
UpdateNotifier(QObject *parent=nullptr)
void save(QSettings *settings)
bool isInProgress() const
QUrl previousVersionSignatureUrl
bool isUpdateAvailable() const
void inProgressChanged(bool inProgress)
QUrl previousVersionDownloadUrl
void supplyNewReleaseData(const QByteArray &data)
UpdateCheckFlags flags() const
const QString & latestVersion() const
void restore(QSettings *settings)
CppUtilities::DateTime lastCheck() const
~UpdateNotifier() override
The Updater class allows downloading and applying an update.
Updater(const QString &executableName, QObject *parent=nullptr)
void updatePercentageChanged(qint64 bytesReceived, qint64 bytesTotal)
void updateStatusChanged(const QString &statusMessage)
void updateFailed(const QString &error)
std::function< QString(const Update &)> VerifyFunction
bool performUpdate(const QString &downloadUrl, const QString &signatureUrl)
void setVerifier(VerifyFunction &&verifyFunction)
void inProgressChanged(bool inProgress)
void setNetworkAccessManager(QNetworkAccessManager *nm)
bool isInProgress() const
qsizetype VersionSuffixIndex
#define INSTANTIATE_UI_FILE_BASED_OPTION_PAGE(SomeClass)
Instantiates a class declared with BEGIN_DECLARE_UI_FILE_BASED_OPTION_PAGE in a convenient way.
bool considerSeparateSignature
UpdateHandlerPrivate(const QString &executableName, const QString &signatureExtension)
std::optional< UpdateHandler::CheckInterval > checkInterval
bool hasCheckedOnceSinceStartup
The CheckInterval struct specifies whether automatic checks for updates are enabled and of often they...
#define QT_UTILITIES_EXE_REGEX
#define QT_UTILITIES_VERSION_SUFFIX