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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
// Copyright (c) 2012 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_EXTENSIONS_COMPONENT_LOADER_H_
#define CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_
#include <string>
#include <vector>
#include "base/callback_forward.h"
#include "base/files/file_path.h"
#include "base/gtest_prod_util.h"
#include "base/memory/weak_ptr.h"
#include "base/values.h"
class ExtensionServiceInterface;
class PrefService;
namespace content {
class BrowserContext;
}
namespace extensions {
// For registering, loading, and unloading component extensions.
class ComponentLoader {
public:
ComponentLoader(ExtensionServiceInterface* extension_service,
PrefService* prefs,
PrefService* local_state,
content::BrowserContext* browser_context);
virtual ~ComponentLoader();
size_t registered_extensions_count() const {
return component_extensions_.size();
}
// Creates and loads all registered component extensions.
void LoadAll();
// Registers and possibly loads a component extension. If ExtensionService
// has been initialized, the extension is loaded; otherwise, the load is
// deferred until LoadAll is called. The ID of the added extension is
// returned.
//
// Component extension manifests must contain a "key" property with a unique
// public key, serialized in base64. You can create a suitable value with the
// following commands on a unixy system:
//
// ssh-keygen -t rsa -b 1024 -N '' -f /tmp/key.pem
// openssl rsa -pubout -outform DER < /tmp/key.pem 2>/dev/null | base64 -w 0
std::string Add(const std::string& manifest_contents,
const base::FilePath& root_directory);
// Convenience method for registering a component extension by resource id.
std::string Add(int manifest_resource_id,
const base::FilePath& root_directory);
// Loads a component extension from file system. Replaces previously added
// extension with the same ID.
std::string AddOrReplace(const base::FilePath& path);
// Returns the extension ID of a component extension specified by resource
// id of its manifest file.
std::string GetExtensionID(int manifest_resource_id,
const base::FilePath& root_directory);
// Returns true if an extension with the specified id has been added.
bool Exists(const std::string& id) const;
// Unloads a component extension and removes it from the list of component
// extensions to be loaded.
void Remove(const base::FilePath& root_directory);
void Remove(const std::string& id);
// Call this during test setup to load component extensions that have
// background pages for testing, which could otherwise interfere with tests.
static void EnableBackgroundExtensionsForTesting();
// Adds the default component extensions. If |skip_session_components|
// the loader will skip loading component extensions that weren't supposed to
// be loaded unless we are in signed user session (ChromeOS). For all other
// platforms this |skip_session_components| is expected to be unset.
void AddDefaultComponentExtensions(bool skip_session_components);
// Similar to above but adds the default component extensions for kiosk mode.
void AddDefaultComponentExtensionsForKioskMode(bool skip_session_components);
// Parse the given JSON manifest. Returns NULL if it cannot be parsed, or if
// if the result is not a DictionaryValue.
base::DictionaryValue* ParseManifest(
const std::string& manifest_contents) const;
// Clear the list of registered extensions.
void ClearAllRegistered();
// Reloads a registered component extension.
void Reload(const std::string& extension_id);
#if defined(OS_CHROMEOS)
// Calls |done_cb|, if not a null callback, on success.
// NOTE: |done_cb| is not called if the component loader is shut down
// during loading.
void AddChromeVoxExtension(const base::Closure& done_cb);
std::string AddChromeOsSpeechSynthesisExtension();
#endif
private:
// Information about a registered component extension.
struct ComponentExtensionInfo {
ComponentExtensionInfo(const base::DictionaryValue* manifest,
const base::FilePath& root_directory);
// The parsed contents of the extensions's manifest file.
const base::DictionaryValue* manifest;
// Directory where the extension is stored.
base::FilePath root_directory;
// The component extension's ID.
std::string extension_id;
};
std::string Add(const base::DictionaryValue* parsed_manifest,
const base::FilePath& root_directory);
// Loads a registered component extension.
void Load(const ComponentExtensionInfo& info);
void AddDefaultComponentExtensionsWithBackgroundPages(
bool skip_session_components);
void AddFileManagerExtension();
void AddVideoPlayerExtension();
void AddAudioPlayerExtension();
void AddGalleryExtension();
void AddHangoutServicesExtension();
void AddHotwordHelperExtension();
void AddImageLoaderExtension();
void AddNetworkSpeechSynthesisExtension();
void AddWithNameAndDescription(int manifest_resource_id,
const base::FilePath& root_directory,
int name_string_id,
int description_string_id);
void AddChromeApp();
void AddHotwordAudioVerificationApp();
void AddKeyboardApp();
void AddWebStoreApp();
// Unloads |component| from the memory.
void UnloadComponent(ComponentExtensionInfo* component);
// Enable HTML5 FileSystem for given component extension in Guest mode.
void EnableFileSystemInGuestMode(const std::string& id);
#if defined(OS_CHROMEOS)
// Used as a reply callback when loading the ChromeVox extension.
// Called with a |chromevox_path| and parsed |manifest| and invokes
// |done_cb| after adding the extension.
void AddChromeVoxExtensionWithManifest(
const base::FilePath& chromevox_path,
const base::Closure& done_cb,
scoped_ptr<base::DictionaryValue> manifest);
#endif
PrefService* profile_prefs_;
PrefService* local_state_;
content::BrowserContext* browser_context_;
ExtensionServiceInterface* extension_service_;
// List of registered component extensions (see Manifest::Location).
typedef std::vector<ComponentExtensionInfo> RegisteredComponentExtensions;
RegisteredComponentExtensions component_extensions_;
base::WeakPtrFactory<ComponentLoader> weak_factory_;
FRIEND_TEST_ALL_PREFIXES(TtsApiTest, NetworkSpeechEngine);
FRIEND_TEST_ALL_PREFIXES(TtsApiTest, NoNetworkSpeechEngineWhenOffline);
DISALLOW_COPY_AND_ASSIGN(ComponentLoader);
};
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_
|
