/* * Copyright (C) by Klaas Freitag * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * for more details. */ #ifndef OCUPDATER_H #define OCUPDATER_H #include #include #include #include #include "updater/updateinfo.h" #include "updater/updater.h" class QNetworkAccessManager; class QNetworkReply; namespace OCC { /** * @brief Schedule update checks every couple of hours if the client runs. * @ingroup gui * * This class schedules regular update checks. It also checks the config * if update checks are wanted at all. * * To reflect that all platforms have their own update scheme, a little * complex class design was set up: * * For Windows and Linux, the updaters are inherited from OCUpdater, while * the MacOSX SparkleUpdater directly uses the class Updater. On windows, * NSISUpdater starts the update if a new version of the client is available. * On MacOSX, the sparkle framework handles the installation of the new * version. On Linux, the update capabilities of the underlying linux distro * are relied on, and thus the PassiveUpdateNotifier just shows a notification * if there is a new version once at every start of the application. * * Simple class diagram of the updater: * * +---------------------------+ * +-----+ UpdaterScheduler +-----+ * | +------------+--------------+ | * v v v * +------------+ +---------------------+ +----------------+ * |NSISUpdater | |PassiveUpdateNotifier| | SparkleUpdater | * +-+----------+ +---+-----------------+ +-----+----------+ * | | | * | v +------------------+ * | +---------------+ v * +-->| OCUpdater +------+ * +--------+------+ | * | Updater | * +-------------+ */ class UpdaterScheduler : public QObject { Q_OBJECT public: UpdaterScheduler(QObject *parent); signals: void updaterAnnouncement(const QString &title, const QString &msg); void requestRestart(); private slots: void slotTimerFired(); private: QTimer _updateCheckTimer; /** Timer for the regular update check. */ }; /** * @brief Class that uses an ownCloud proprietary XML format to fetch update information * @ingroup gui */ class OCUpdater : public Updater { Q_OBJECT public: enum DownloadState { Unknown = 0, CheckingServer, UpToDate, Downloading, DownloadComplete, DownloadFailed, DownloadTimedOut, UpdateOnlyAvailableThroughSystem }; explicit OCUpdater(const QUrl &url); bool performUpdate(); void checkForUpdate() override; QString statusString() const; int downloadState() const; void setDownloadState(DownloadState state); signals: void downloadStateChanged(); void newUpdateAvailable(const QString &header, const QString &message); void requestRestart(); public slots: void slotStartInstaller(); protected slots: void backgroundCheckForUpdate() override; private slots: void slotOpenUpdateUrl(); void slotVersionInfoArrived(); void slotTimedOut(); protected: virtual void versionInfoArrived(const UpdateInfo &info) = 0; bool updateSucceeded() const; QNetworkAccessManager *qnam() const { return _accessManager; } UpdateInfo updateInfo() const { return _updateInfo; } private: QUrl _updateUrl; int _state; QNetworkAccessManager *_accessManager; QTimer *_timeoutWatchdog; /** Timer to guard the timeout of an individual network request */ UpdateInfo _updateInfo; }; /** * @brief Windows Updater Using NSIS * @ingroup gui */ class NSISUpdater : public OCUpdater { Q_OBJECT public: enum UpdateState { NoUpdate = 0, UpdateAvailable, UpdateFailed }; explicit NSISUpdater(const QUrl &url); bool handleStartup() override; private slots: void slotSetSeenVersion(); void slotDownloadFinished(); void slotWriteFile(); private: NSISUpdater::UpdateState updateStateOnStart(); void showDialog(const UpdateInfo &info); void versionInfoArrived(const UpdateInfo &info) override; QScopedPointer _file; QString _targetFile; bool _showFallbackMessage; }; /** * @brief Updater that only implements notification for use in settings * * The implementation does not show popups * * @ingroup gui */ class PassiveUpdateNotifier : public OCUpdater { Q_OBJECT public: explicit PassiveUpdateNotifier(const QUrl &url); bool handleStartup() override { return false; } void backgroundCheckForUpdate() override; private: void versionInfoArrived(const UpdateInfo &info) override; QByteArray _runningAppVersion; }; } #endif // OC_UPDATER