software_update.h

Go to the documentation of this file.

 
#ifndef SOFTWARE_UPDATE_H
#define SOFTWARE_UPDATE_H
 
#include <QObject>
#include <QUrl>
#include <QMutex>
#include <QScopedPointer>
#include <QTimer>
#include <QVersionNumber>
 
class QNetworkAccessManager;
class QNetworkReply;
class SoftwareUpdateBackend;

class ShutdownEvent {
public:
    void accept();

    void reject(const QString &reason = {});

    bool isAccepted() const;

    QString reason() const;
 
private:
    bool accepted_ = false; 
    bool rejected_ = false; 
    QString reason_;        
};

struct AppcastItem {
    QString title;             
    QVersionNumber version;    
    QVersionNumber shortVersion; 
    QUrl downloadUrl;          
    QUrl releaseNotesUrl;      
    QString os;
    qint64 length = 0;         
    QString edSignature;       
};

class SoftwareUpdate : public QObject
{
        Q_OBJECT
public:
    SoftwareUpdate(const SoftwareUpdate &) = delete;

    SoftwareUpdate &operator=(const SoftwareUpdate &) = delete;

    static SoftwareUpdate *instance();

    void init(bool runWithoutSilentCheck = false);

    void cleanup();

    static void performUIUpdate();

    static QString info();

    static bool plattformSupported();
 
/**** Utility functions for manipulating the automatic update check through the UI ****/

void startAutoCheck(int intervalSeconds = 0);

void stopAutoCheck();

bool isAutoCheckEnabled() const;
 
signals:
    void updateAvailable(QString newVersion, QString releaseNotes);

    void updateCheckFailed(const QString &errorString);

    void updateEngaged();

    void appShutdownRequested(ShutdownEvent *shutdownEvent);
 
private:
    static SoftwareUpdate *instance_; 
    static QMutex mutex_;             
    static QMutex updateMutex_;       
 
    QTimer *updateCheckTimer_;                  
    QNetworkAccessManager *networkAccessManager_; 
    QScopedPointer<SoftwareUpdateBackend> backend_; 
    QNetworkReply *pendingReply_ = nullptr;     

    QUrl updateUrl() const;

    QList<AppcastItem> parseAppcast(const QByteArray &data) const;
 
 
private slots:
    void onNetworkReplyFinished(QNetworkReply *reply);

    void checkForUpdates();
 
 
protected:
    explicit SoftwareUpdate(QObject *parent = nullptr);

    ~SoftwareUpdate();
};
 
#endif /* SOFTWARE_UPDATE_H */