1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UI_WEBUI_HELP_VERSION_UPDATER_H_
#define CHROME_BROWSER_UI_WEBUI_HELP_VERSION_UPDATER_H_
#include <memory>
#include <string>
#include "base/functional/callback.h"
#include "build/build_config.h"
#if BUILDFLAG(IS_CHROMEOS)
#include <optional>
#include "chromeos/ash/components/dbus/update_engine/update_engine_client.h"
#include "third_party/cros_system_api/dbus/update_engine/dbus-constants.h"
#endif // BUILDFLAG(IS_CHROMEOS)
namespace content {
class WebContents;
}
// Interface implemented to expose per-platform updating functionality.
class VersionUpdater {
public:
// Update process state machine.
enum Status {
CHECKING,
NEED_PERMISSION_TO_UPDATE,
UPDATING,
NEARLY_UPDATED,
UPDATED,
FAILED,
FAILED_OFFLINE,
FAILED_CONNECTION_TYPE_DISALLOWED,
FAILED_HTTP,
FAILED_DOWNLOAD,
DISABLED,
DISABLED_BY_ADMIN,
UPDATE_TO_ROLLBACK_VERSION_DISALLOWED,
DEFERRED
};
// Promotion state (Mac-only).
enum PromotionState {
PROMOTE_HIDDEN,
PROMOTE_ENABLED,
PROMOTE_DISABLED,
PROMOTED,
};
// TODO(jhawkins): Use a delegate interface instead of multiple callback
// types.
#if BUILDFLAG(IS_CHROMEOS)
typedef base::OnceCallback<void(const std::string&)> ChannelCallback;
using EolInfoCallback =
base::OnceCallback<void(ash::UpdateEngineClient::EolInfo eol_info)>;
using IsFeatureEnabledCallback =
base::OnceCallback<void(std::optional<bool>)>;
#endif
// Used to update the client of status changes.
// |status| is the current state of the update.
// |progress| should only be non-zero for the UPDATING state.
// |rollback| indicates whether the update is actually a rollback, which
// requires wiping the device upon reboot.
// |powerwash| indicates whether the device will be wiped on reboot.
// |version| is the version of the available update and should be empty string
// when update is not available.
// |update_size| is the size of the available update in bytes and should be 0
// when update is not available.
// |message| is a message explaining a failure.
typedef base::RepeatingCallback<void(Status status,
int progress,
bool rollback,
bool powerwash,
const std::string& version,
int64_t update_size,
const std::u16string& message)>
StatusCallback;
// Used to show or hide the promote UI elements. Mac-only.
typedef base::RepeatingCallback<void(PromotionState)> PromoteCallback;
virtual ~VersionUpdater() = default;
// Sub-classes must implement this method to create the respective
// specialization. |web_contents| may be null, in which case any required UX
// (e.g., UAC to elevate on Windows) may not be associated with any existing
// browser windows.
static std::unique_ptr<VersionUpdater> Create(
content::WebContents* web_contents);
// Begins the update process by checking for update availability.
// |status_callback| is called for each status update. |promote_callback|
// (which is only used on the Mac) can be used to show or hide the promote UI
// elements.
virtual void CheckForUpdate(StatusCallback status_callback,
PromoteCallback promote_callback) = 0;
#if BUILDFLAG(IS_MAC)
// Make updates available for all users.
virtual void PromoteUpdater() = 0;
#endif
#if BUILDFLAG(IS_CHROMEOS)
virtual void SetChannel(const std::string& channel,
bool is_powerwash_allowed) = 0;
virtual void GetChannel(bool get_current_channel,
ChannelCallback callback) = 0;
// Get the End of Life (Auto Update Expiration) Date.
virtual void GetEolInfo(EolInfoCallback callback) = 0;
virtual void ToggleFeature(const std::string& feature, bool enable) = 0;
virtual void IsFeatureEnabled(const std::string& feature,
IsFeatureEnabledCallback callback) = 0;
virtual bool IsManagedAutoUpdateEnabled() = 0;
// Sets a one time permission on a certain update in Update Engine.
// - update_version: the Chrome OS version we want to update to.
// - update_size: the size of that Chrome OS version in bytes.
// These two parameters are a failsafe to prevent downloading an update that
// the user didn't agree to. They should be set using the version and size we
// received from update engine when it broadcasts NEED_PERMISSION_TO_UPDATE.
// They are used by update engine to double-check with update server in case
// there's a new update available or a delta update becomes a full update with
// a larger size.
virtual void SetUpdateOverCellularOneTimePermission(
StatusCallback callback,
const std::string& update_version,
int64_t update_size) = 0;
// If an update is downloaded but deferred, apply the deferred update.
virtual void ApplyDeferredUpdateAdvanced() = 0;
#endif
};
#endif // CHROME_BROWSER_UI_WEBUI_HELP_VERSION_UPDATER_H_
|
