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