chrome/browser/upgrade_detector_impl.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_UPGRADE_DETECTOR_IMPL_H_
   6 #define CHROME_BROWSER_UPGRADE_DETECTOR_IMPL_H_
   7
   8 #include "base/memory/weak_ptr.h"
   9 #include "base/timer/timer.h"
  10 #include "base/version.h"
  11 #include "chrome/browser/upgrade_detector.h"
  12 #include "components/variations/service/variations_service.h"
  13
  14 namespace base {
  15 template <typename T> struct DefaultSingletonTraits;
  16 }
  17
  18 class UpgradeDetectorImpl : public UpgradeDetector,
  19                             public variations::VariationsService::Observer {
  20  public:
  21   ~UpgradeDetectorImpl() override;
  22
  23   // Returns the currently installed Chrome version, which may be newer than the
  24   // one currently running. Not supported on Android, iOS or ChromeOS. Must be
  25   // run on a thread where I/O operations are allowed (e.g. FILE thread).
  26   static base::Version GetCurrentlyInstalledVersion();
  27
  28   // Returns the singleton instance.
  29   static UpgradeDetectorImpl* GetInstance();
  30
  31  protected:
  32   UpgradeDetectorImpl();
  33
  34   // variations::VariationsService::Observer:
  35   void OnExperimentChangesDetected(Severity severity) override;
  36
  37   // Trigger an "on upgrade" notification based on the specified |time_passed|
  38   // interval. Exposed as protected for testing.
  39   void NotifyOnUpgradeWithTimePassed(base::TimeDelta time_passed);
  40
  41  private:
  42   friend struct base::DefaultSingletonTraits<UpgradeDetectorImpl>;
  43
  44   // Start the timer that will call |CheckForUpgrade()|.
  45   void StartTimerForUpgradeCheck();
  46
  47   // Launches a task on the file thread to check if we have the latest version.
  48   void CheckForUpgrade();
  49
  50   // Starts the upgrade notification timer that will check periodically whether
  51   // enough time has elapsed to update the severity (which maps to visual
  52   // badging) of the notification.
  53   void StartUpgradeNotificationTimer();
  54
  55   // Sends out a notification and starts a one shot timer to wait until
  56   // notifying the user.
  57   void UpgradeDetected(UpgradeAvailable upgrade_available);
  58
  59   // Returns true after calling UpgradeDetected if current install is outdated.
  60   bool DetectOutdatedInstall();
  61
  62   // The function that sends out a notification (after a certain time has
  63   // elapsed) that lets the rest of the UI know we should start notifying the
  64   // user that a new version is available.
  65   void NotifyOnUpgrade();
  66
  67   // Called on the FILE thread to detect an upgrade. Calls back UpgradeDetected
  68   // on the UI thread if so. Although it looks weird, this needs to be a static
  69   // method receiving a WeakPtr<> to this object so that we can interrupt
  70   // the UpgradeDetected callback before it runs. Having this method non-static
  71   // and using |this| directly wouldn't be thread safe. And keeping it as a
  72   // non-class function would prevent it from calling UpgradeDetected.
  73   static void DetectUpgradeTask(
  74       base::WeakPtr<UpgradeDetectorImpl> upgrade_detector);
  75
  76   // We periodically check to see if Chrome has been upgraded.
  77   base::RepeatingTimer<UpgradeDetectorImpl> detect_upgrade_timer_;
  78
  79   // After we detect an upgrade we start a recurring timer to see if enough time
  80   // has passed and we should start notifying the user.
  81   base::RepeatingTimer<UpgradeDetectorImpl> upgrade_notification_timer_;
  82
  83   // True if this build is a dev or canary channel build.
  84   bool is_unstable_channel_;
  85
  86   // True if auto update is turned on.
  87   bool is_auto_update_enabled_;
  88
  89   // When the upgrade was detected - either a software update or a variations
  90   // update, whichever happened first.
  91   base::TimeTicks upgrade_detected_time_;
  92
  93   // The date the binaries were built.
  94   base::Time build_date_;
  95
  96   // We use this factory to create callback tasks for UpgradeDetected. We pass
  97   // the task to the actual upgrade detection code, which is in
  98   // DetectUpgradeTask.
  99   base::WeakPtrFactory<UpgradeDetectorImpl> weak_factory_;
 100
 101   DISALLOW_COPY_AND_ASSIGN(UpgradeDetectorImpl);
 102 };
 103
 104
 105 #endif  // CHROME_BROWSER_UPGRADE_DETECTOR_IMPL_H_