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
|
// Copyright 2013 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_EXTENSIONS_INSTALL_OBSERVER_H_
#define CHROME_BROWSER_EXTENSIONS_INSTALL_OBSERVER_H_
#include <optional>
#include <string>
#include "extensions/buildflags/buildflags.h"
#include "extensions/common/extension_id.h"
#include "ui/gfx/image/image_skia.h"
static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));
namespace base {
class FilePath;
}
namespace content {
class BrowserContext;
}
namespace extensions {
class Extension;
// An InstallObserver observes extension installation events coming from an InstallTracker.
// Since extension installs are scoped to a single Profile (represented here as a
// BrowserContext), InstallTrackers are as well. Instances of InstallObserver are passed the
// appropriate BrowserContext so that a single InstallObserver can observe multiple
// InstallTrackers.
class InstallObserver {
public:
struct ExtensionInstallParams {
ExtensionInstallParams(
std::string extension_id,
std::string extension_name,
gfx::ImageSkia installing_icon,
bool is_app,
bool is_platform_app);
std::string extension_id;
std::string extension_name;
gfx::ImageSkia installing_icon;
bool is_app;
bool is_platform_app;
};
// Called at the beginning of the complete installation process, i.e., this
// is called before the extension download begins.
virtual void OnBeginExtensionInstall(content::BrowserContext* context,
const ExtensionInstallParams& params) {}
// Called when the Extension begins the download process. This typically
// happens right after OnBeginExtensionInstall(), unless the extension has
// already been downloaded.
virtual void OnBeginExtensionDownload(content::BrowserContext* context,
const std::string& extension_id) {}
// Called whenever the extension download is updated.
// Note: Some extensions have multiple modules, so the percent included here
// is a simple calculation of:
// (finished_files * 100 + current_file_progress) / (total files * 100).
virtual void OnDownloadProgress(content::BrowserContext* context,
const std::string& extension_id,
int percent_downloaded) {}
// Called when the necessary downloads have completed, and the crx
// installation is due to start.
virtual void OnBeginCrxInstall(content::BrowserContext* context,
const std::string& extension_id) {}
// Called when installation of a crx has completed (either successfully or
// not). `source_file` is the source of the install. If the installation
// failed `extension` will be null but `extension_id` may be valid (it will
// have the ID we expected the extension to have).
virtual void OnFinishCrxInstall(content::BrowserContext* context,
const base::FilePath& source_file,
const std::string& extension_id,
const Extension* extension,
bool success) {}
// Called when the app list is reordered. If `extension_id` is set, it
// indicates the extension ID that was re-ordered.
virtual void OnAppsReordered(content::BrowserContext* context,
const std::optional<ExtensionId>& extension_id) {
}
// Notifies observers that the observed object is going away.
virtual void OnShutdown() {}
protected:
virtual ~InstallObserver() = default;
};
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_INSTALL_OBSERVER_H_
|
