blob: 140d399970106622ad01ab140f4dcb3799b0c342 [file] [log] [blame]
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "base/gtest_prod_util.h"
#include "base/macros.h"
#include "base/observer_list.h"
#include "base/time/time.h"
#include "base/timer/timer.h"
#include "chrome/browser/upgrade_observer.h"
#include "components/prefs/pref_change_registrar.h"
#include "ui/base/idle/idle.h"
#include "ui/gfx/image/image.h"
class PrefRegistrySimple;
class UpgradeObserver;
namespace base {
class TickClock;
// UpgradeDetector
// This class is a singleton class that monitors when an upgrade happens in the
// background. We basically ask Omaha what it thinks the latest version is and
// if our version is lower we send out a notification upon:
// a) Detecting an upgrade and...
// b) When we think the user should be notified about the upgrade.
// The latter happens much later, since we don't want to be too annoying.
class UpgradeDetector {
// The Homeland Security Upgrade Advisory System.
// These values are persisted to logs. Entries should not be renumbered and
// numeric values should never be reused.
enum UpgradeNotificationAnnoyanceLevel {
UPGRADE_ANNOYANCE_NONE = 0, // What? Me worry?
// UPGRADE_ANNOYANCE_SEVERE = 4, // Removed in 2018-03 for lack of use.
UPGRADE_ANNOYANCE_CRITICAL = 5, // Red exclamation mark.
// The number of UpgradeNotificationAnnoyanceLevel enum values.
static constexpr int kUpgradeNotificationAnnoyanceLevelCount =
// Returns the singleton implementation instance.
static UpgradeDetector* GetInstance();
virtual ~UpgradeDetector();
// Returns the default delta from upgrade detection until high annoyance is
// reached.
static base::TimeDelta GetDefaultHighAnnoyanceThreshold();
static void RegisterPrefs(PrefRegistrySimple* registry);
// Returns the time at which an available upgrade was detected.
base::TimeTicks upgrade_detected_time() const {
return upgrade_detected_time_;
// Whether the user should be notified about an upgrade.
bool notify_upgrade() const { return notify_upgrade_; }
// Whether the upgrade recommendation is due to Chrome being outdated.
bool is_outdated_install() const {
return upgrade_available_ == UPGRADE_NEEDED_OUTDATED_INSTALL;
// Whether the upgrade recommendation is due to Chrome being outdated AND
// auto-update is turned off.
bool is_outdated_install_no_au() const {
return upgrade_available_ == UPGRADE_NEEDED_OUTDATED_INSTALL_NO_AU;
// Notify this object that the user has acknowledged the critical update so we
// don't need to complain about it for now.
void acknowledge_critical_update() {
critical_update_acknowledged_ = true;
// Whether the user has acknowledged the critical update.
bool critical_update_acknowledged() const {
return critical_update_acknowledged_;
bool is_factory_reset_required() const { return is_factory_reset_required_; }
// Retrieves the right icon based on the degree of severity (see
// UpgradeNotificationAnnoyanceLevel, each level has an an accompanying icon
// to go with it) to display within the app menu.
gfx::Image GetIcon();
UpgradeNotificationAnnoyanceLevel upgrade_notification_stage() const {
return upgrade_notification_stage_;
// Returns the delta between "elevated" and "high" annoyance levels.
virtual base::TimeDelta GetHighAnnoyanceLevelDelta() = 0;
// Returns the tick count at which "high" annoyance level will be (or was)
// reached, or a null tick count if an upgrade has not yet been detected.
virtual base::TimeTicks GetHighAnnoyanceDeadline() = 0;
void AddObserver(UpgradeObserver* observer);
void RemoveObserver(UpgradeObserver* observer);
// Notifies that the current install is outdated. No details are expected.
void NotifyOutdatedInstall();
// Notifies that the current install is outdated and auto-update (AU) is
// disabled. No details are expected.
void NotifyOutdatedInstallNoAutoUpdate();
enum UpgradeAvailable {
// If no update is available and current install is recent enough.
// If a regular update is available.
// If a critical update to Chrome has been installed, such as a zero-day
// fix.
// If no update to Chrome has been installed for more than the recommended
// time.
// If no update to Chrome has been installed for more than the recommended
// time AND auto-update is turned off.
explicit UpgradeDetector(const base::TickClock* tick_clock);
// Returns the notification period specified via the
// RelaunchNotificationPeriod policy setting, or a zero delta if unset or out
// of range.
static base::TimeDelta GetRelaunchNotificationPeriod();
const base::TickClock* tick_clock() { return tick_clock_; }
// Notifies that update is recommended and triggers different actions based
// on the update availability.
void NotifyUpgrade();
// Notifies that update is recommended.
void NotifyUpgradeRecommended();
// Notifies that a critical update has been installed. No details are
// expected.
void NotifyCriticalUpgradeInstalled();
// The function that sends out a notification that lets the rest of the UI
// know we should notify the user that a new update is available to download
// over cellular connection.
void NotifyUpdateOverCellularAvailable();
// Notifies that the user's one time permission on update over cellular
// connection has been granted.
void NotifyUpdateOverCellularOneTimePermissionGranted();
// Triggers a critical update, which starts a timer that checks the machine
// idle state. Protected and virtual so that it could be overridden by tests.
virtual void TriggerCriticalUpdate();
UpgradeAvailable upgrade_available() const { return upgrade_available_; }
void set_upgrade_available(UpgradeAvailable available) {
upgrade_available_ = available;
void set_upgrade_detected_time(base::TimeTicks upgrade_detected_time) {
upgrade_detected_time_ = upgrade_detected_time;
void set_best_effort_experiment_updates_available(bool available) {
best_effort_experiment_updates_available_ = available;
bool critical_experiment_updates_available() const {
return critical_experiment_updates_available_;
void set_critical_experiment_updates_available(bool available) {
critical_experiment_updates_available_ = available;
void set_critical_update_acknowledged(bool acknowledged) {
critical_update_acknowledged_ = acknowledged;
void set_upgrade_notification_stage(UpgradeNotificationAnnoyanceLevel stage) {
upgrade_notification_stage_ = stage;
void set_is_factory_reset_required(bool is_factory_reset_required) {
is_factory_reset_required_ = is_factory_reset_required;
FRIEND_TEST_ALL_PREFIXES(SystemTrayClientTest, UpdateTrayIcon);
friend class UpgradeMetricsProviderTest;
// Handles a change to the browser.relaunch_notification_period Local State
// preference. Subclasses should call NotifyUpgrade if observers are to be
// notified of the change (generally speaking, if an upgrade is available).
virtual void OnRelaunchNotificationPeriodPrefChanged() = 0;
// Initiates an Idle check. See IdleCallback below.
void CheckIdle();
// The callback for the IdleCheck. Tells us whether Chrome has received any
// input events since the specified time.
void IdleCallback(ui::IdleState state);
// A provider of TimeTicks to the detector and its timers.
const base::TickClock* const tick_clock_;
// Observes changes to the browser.relaunch_notification_period Local State
// preference.
PrefChangeRegistrar pref_change_registrar_;
// Whether any software updates are available (experiment updates are tracked
// separately via additional member variables below).
UpgradeAvailable upgrade_available_;
// The time at which an available upgrade was detected.
base::TimeTicks upgrade_detected_time_;
// Whether "best effort" experiment updates are available.
bool best_effort_experiment_updates_available_;
// Whether "critical" experiment updates are available.
bool critical_experiment_updates_available_;
// Whether the user has acknowledged the critical update.
bool critical_update_acknowledged_;
// Whether a factory reset is needed to complete an update.
bool is_factory_reset_required_;
// A timer to check to see if we've been idle for long enough to show the
// critical warning. Should only be set if |upgrade_available_| is
base::RepeatingTimer idle_check_timer_;
// The stage at which the annoyance level for upgrade notifications is at.
UpgradeNotificationAnnoyanceLevel upgrade_notification_stage_;
// Whether we have waited long enough after detecting an upgrade (to see
// is we should start nagging about upgrading).
bool notify_upgrade_;
base::ObserverList<UpgradeObserver> observer_list_;