blob: 037438ef70f14d751bdffb00a3bc68bc2a97ab94 (
plain)
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. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_
#define CHROME_BROWSER_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_
#include <string>
#include <vector>
#include "base/compiler_specific.h"
#include "base/memory/scoped_ptr.h"
#include "base/version.h"
#include "chrome/browser/component_updater/component_updater_service.h"
namespace base {
class DictionaryValue;
class FilePath;
} // namespace base
// Components should use a DefaultComponentInstaller by defining a class that
// implements the members of ComponentInstallerTraits, and then registering a
// DefaultComponentInstaller that has been constructed with an instance of that
// class.
class ComponentInstallerTraits {
public:
virtual ~ComponentInstallerTraits() {}
// Verifies that a working installation resides within the directory specified
// by |dir|. |dir| is of the form <base directory>/<version>.
virtual bool VerifyInstallation(const base::FilePath& dir) const = 0;
// Returns true if the component can be automatically updated. Called once
// during component registration from the UI thread.
virtual bool CanAutoUpdate() const = 0;
// OnCustomInstall is called during the installation process. Components that
// require custom installation operations should implement them here.
// Returns false if a custom operation failed, and true otherwise.
// Called only from the FILE thread.
virtual bool OnCustomInstall(const base::DictionaryValue& manifest,
const base::FilePath& install_dir) = 0;
// ComponentReady is called in two cases:
// 1) After an installation is successfully completed.
// 2) During component registration if the component is already installed.
// In both cases the install is verified before this is called. This method
// is guaranteed to be called before any observers of the component are
// notified of a successful install, and is meant to support follow-on work
// such as updating paths elsewhere in Chrome. Called only from the FILE
// thread.
// |version| is the version of the component, while |path| is the path to the
// install directory.
virtual void ComponentReady(const base::Version& version,
const base::FilePath& install_dir) = 0;
// Returns the directory that the installer will place versioned installs of
// the component into.
virtual base::FilePath GetBaseDirectory() const = 0;
// Returns the component's SHA2 hash as raw bytes.
virtual void GetHash(std::vector<uint8>* hash) const = 0;
// Returns the human-readable name of the component.
virtual std::string GetName() const = 0;
};
// A DefaultComponentInstaller is intended to be final, and not derived from.
// Customization must be provided by passing a ComponentInstallerTraits object
// to the constructor.
class DefaultComponentInstaller : public ComponentInstaller {
public:
explicit DefaultComponentInstaller(
scoped_ptr<ComponentInstallerTraits> installer_traits);
// Registers the component for update checks and installs.
void Register(ComponentUpdateService* cus);
// Overridden from ComponentInstaller:
virtual void OnUpdateError(int error) OVERRIDE;
virtual bool Install(const base::DictionaryValue& manifest,
const base::FilePath& unpack_path) OVERRIDE;
virtual bool GetInstalledFile(const std::string& file,
base::FilePath* installed_file) OVERRIDE;
virtual ~DefaultComponentInstaller();
private:
base::FilePath GetInstallDirectory();
void StartRegistration(ComponentUpdateService* cus);
void FinishRegistration(ComponentUpdateService* cus);
base::Version current_version_;
std::string current_fingerprint_;
scoped_ptr<ComponentInstallerTraits> installer_traits_;
DISALLOW_COPY_AND_ASSIGN(DefaultComponentInstaller);
};
#endif // CHROME_BROWSER_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_
|
