OLD | NEW |
---|---|
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ | 5 #ifndef COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ |
6 #define COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ | 6 #define COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ |
7 | 7 |
8 #include <stdint.h> | 8 #include <stdint.h> |
9 | 9 |
10 #include <memory> | 10 #include <memory> |
11 #include <string> | 11 #include <string> |
12 #include <vector> | 12 #include <vector> |
13 | 13 |
14 #include "base/callback_forward.h" | 14 #include "base/callback_forward.h" |
15 #include "base/files/file_path.h" | |
15 #include "base/macros.h" | 16 #include "base/macros.h" |
16 #include "base/memory/ref_counted.h" | 17 #include "base/memory/ref_counted.h" |
17 #include "base/threading/thread_checker.h" | 18 #include "base/threading/thread_checker.h" |
18 #include "base/values.h" | 19 #include "base/values.h" |
19 #include "base/version.h" | 20 #include "base/version.h" |
20 #include "components/update_client/update_client.h" | 21 #include "components/update_client/update_client.h" |
21 | 22 |
22 namespace base { | 23 namespace base { |
23 class FilePath; | |
24 class SequencedTaskRunner; | 24 class SequencedTaskRunner; |
25 class SingleThreadTaskRunner; | 25 class SingleThreadTaskRunner; |
26 } // namespace base | 26 } // namespace base |
27 | 27 |
28 namespace component_updater { | 28 namespace component_updater { |
29 | 29 |
30 class ComponentUpdateService; | 30 class ComponentUpdateService; |
31 | 31 |
32 // Components should use a DefaultComponentInstaller by defining a class that | 32 // Components should use a DefaultComponentInstaller by defining a class that |
33 // implements the members of ComponentInstallerTraits, and then registering a | 33 // implements the members of ComponentInstallerTraits, and then registering a |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
69 // notified of a successful install, and is meant to support follow-on work | 69 // notified of a successful install, and is meant to support follow-on work |
70 // such as updating paths elsewhere in Chrome. Called on the UI thread. | 70 // such as updating paths elsewhere in Chrome. Called on the UI thread. |
71 // |version| is the version of the component. | 71 // |version| is the version of the component. |
72 // |install_dir| is the path to the install directory for this version. | 72 // |install_dir| is the path to the install directory for this version. |
73 // |manifest| is the manifest for this version of the component. | 73 // |manifest| is the manifest for this version of the component. |
74 virtual void ComponentReady( | 74 virtual void ComponentReady( |
75 const base::Version& version, | 75 const base::Version& version, |
76 const base::FilePath& install_dir, | 76 const base::FilePath& install_dir, |
77 std::unique_ptr<base::DictionaryValue> manifest) = 0; | 77 std::unique_ptr<base::DictionaryValue> manifest) = 0; |
78 | 78 |
79 // Returns the directory that the installer will place versioned installs of | 79 // Returns a filesystem-safe name that will be used as the directory name for |
Sorin Jianu
2016/05/03 21:51:24
filesystem-safe is redundant now, since the return
waffles
2016/05/03 22:14:05
Done.
| |
80 // the component into. | 80 // the component's contents. |
81 virtual base::FilePath GetBaseDirectory() const = 0; | 81 virtual base::FilePath GetRelativeInstallDir() const = 0; |
82 | 82 |
83 // Returns the component's SHA2 hash as raw bytes. | 83 // Returns the component's SHA2 hash as raw bytes. |
84 virtual void GetHash(std::vector<uint8_t>* hash) const = 0; | 84 virtual void GetHash(std::vector<uint8_t>* hash) const = 0; |
85 | 85 |
86 // Returns the human-readable name of the component. | 86 // Returns the human-readable name of the component. |
87 virtual std::string GetName() const = 0; | 87 virtual std::string GetName() const = 0; |
88 | 88 |
89 // Returns the additional parameters to be used in the update checks for | 89 // Returns the additional parameters to be used in the update checks for |
90 // this component. A compatible server may use this attribute to negotiate | 90 // this component. A compatible server may use this attribute to negotiate |
91 // special update rules when issuing an update response. | 91 // special update rules when issuing an update response. |
(...skipping 13 matching lines...) Expand all Loading... | |
105 // The passed |callback| will be called once the initial check for installed | 105 // The passed |callback| will be called once the initial check for installed |
106 // versions is done and the component has been registered. | 106 // versions is done and the component has been registered. |
107 void Register(ComponentUpdateService* cus, const base::Closure& callback); | 107 void Register(ComponentUpdateService* cus, const base::Closure& callback); |
108 | 108 |
109 // Overridden from ComponentInstaller: | 109 // Overridden from ComponentInstaller: |
110 void OnUpdateError(int error) override; | 110 void OnUpdateError(int error) override; |
111 bool Install(const base::DictionaryValue& manifest, | 111 bool Install(const base::DictionaryValue& manifest, |
112 const base::FilePath& unpack_path) override; | 112 const base::FilePath& unpack_path) override; |
113 bool GetInstalledFile(const std::string& file, | 113 bool GetInstalledFile(const std::string& file, |
114 base::FilePath* installed_file) override; | 114 base::FilePath* installed_file) override; |
115 // Only user-level component installations can be uninstalled. | |
115 bool Uninstall() override; | 116 bool Uninstall() override; |
116 | 117 |
117 private: | 118 private: |
118 ~DefaultComponentInstaller() override; | 119 ~DefaultComponentInstaller() override; |
119 | 120 |
120 base::FilePath GetInstallDirectory(); | 121 bool LoadSystemInstallation(); |
xhwang
2016/05/03 22:49:42
nit: document what it does and what the return val
waffles
2016/05/10 18:15:53
Done.
| |
121 bool InstallHelper(const base::DictionaryValue& manifest, | 122 bool InstallHelper(const base::DictionaryValue& manifest, |
122 const base::FilePath& unpack_path, | 123 const base::FilePath& unpack_path, |
123 const base::FilePath& install_path); | 124 const base::FilePath& install_path); |
124 void StartRegistration(ComponentUpdateService* cus); | 125 void StartRegistration(ComponentUpdateService* cus); |
125 void FinishRegistration(ComponentUpdateService* cus, | 126 void FinishRegistration(ComponentUpdateService* cus, |
126 const base::Closure& callback); | 127 const base::Closure& callback); |
127 void ComponentReady(std::unique_ptr<base::DictionaryValue> manifest); | 128 void ComponentReady(std::unique_ptr<base::DictionaryValue> manifest); |
128 void UninstallOnTaskRunner(); | 129 void UninstallOnTaskRunner(); |
129 | 130 |
131 base::FilePath current_install_dir_; | |
130 base::Version current_version_; | 132 base::Version current_version_; |
131 std::string current_fingerprint_; | 133 std::string current_fingerprint_; |
132 std::unique_ptr<base::DictionaryValue> current_manifest_; | 134 std::unique_ptr<base::DictionaryValue> current_manifest_; |
133 std::unique_ptr<ComponentInstallerTraits> installer_traits_; | 135 std::unique_ptr<ComponentInstallerTraits> installer_traits_; |
134 scoped_refptr<base::SequencedTaskRunner> task_runner_; | 136 scoped_refptr<base::SequencedTaskRunner> task_runner_; |
135 | 137 |
136 // Used to post responses back to the main thread. Initialized on the main | 138 // Used to post responses back to the main thread. Initialized on the main |
137 // loop but accessed from the task runner. | 139 // loop but accessed from the task runner. |
138 scoped_refptr<base::SingleThreadTaskRunner> main_task_runner_; | 140 scoped_refptr<base::SingleThreadTaskRunner> main_task_runner_; |
139 | 141 |
140 base::ThreadChecker thread_checker_; | 142 base::ThreadChecker thread_checker_; |
141 | 143 |
142 DISALLOW_COPY_AND_ASSIGN(DefaultComponentInstaller); | 144 DISALLOW_COPY_AND_ASSIGN(DefaultComponentInstaller); |
143 }; | 145 }; |
144 | 146 |
145 } // namespace component_updater | 147 } // namespace component_updater |
146 | 148 |
147 #endif // COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ | 149 #endif // COMPONENTS_COMPONENT_UPDATER_DEFAULT_COMPONENT_INSTALLER_H_ |
OLD | NEW |