| OLD | NEW |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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 CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ | 5 #ifndef CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ |
| 6 #define CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ | 6 #define CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ |
| 7 #pragma once | 7 #pragma once |
| 8 | 8 |
| 9 #include <string> | 9 #include <string> |
| 10 | 10 |
| 11 #include "base/file_path.h" | 11 #include "base/file_path.h" |
| 12 #include "base/values.h" |
| 12 | 13 |
| 13 class Extension; | 14 class Extension; |
| 14 class ExtensionService; | 15 class ExtensionService; |
| 15 | 16 |
| 16 namespace extensions { | 17 namespace extensions { |
| 17 | 18 |
| 18 // For registering, loading, and unloading component extensions. | 19 // For registering, loading, and unloading component extensions. |
| 19 class ComponentLoader { | 20 class ComponentLoader { |
| 20 public: | 21 public: |
| 21 explicit ComponentLoader(ExtensionService* extension_service); | 22 explicit ComponentLoader(ExtensionService* extension_service); |
| 22 virtual ~ComponentLoader(); | 23 virtual ~ComponentLoader(); |
| 23 | 24 |
| 24 // Loads any registered component extensions. | 25 // Loads any registered component extensions. |
| 25 void LoadAll(); | 26 void LoadAll(); |
| 26 | 27 |
| 27 // Loads and registers a component extension. If ExtensionService has been | 28 // Loads and registers a component extension. If ExtensionService has been |
| 28 // initialized, the extension is loaded; otherwise, the load is deferred | 29 // initialized, the extension is loaded; otherwise, the load is deferred |
| 29 // until LoadAll is called. | 30 // until LoadAll is called. |
| 30 const Extension* Add(const std::string& manifest, | 31 const Extension* Add(const std::string& manifest, |
| 31 const FilePath& root_directory); | 32 const FilePath& root_directory, |
| 33 DictionaryValue* manifest_overrides); |
| 34 |
| 35 const Extension* Add(const std::string& manifest, |
| 36 const FilePath& root_directory) { |
| 37 return Add(manifest, root_directory, NULL); |
| 38 } |
| 32 | 39 |
| 33 // Unloads a component extension and removes it from the list of component | 40 // Unloads a component extension and removes it from the list of component |
| 34 // extensions to be loaded. | 41 // extensions to be loaded. |
| 35 void Remove(const std::string& manifest_str); | 42 void Remove(const std::string& manifest_str); |
| 36 | 43 |
| 37 // Adds the default component extensions. | 44 // Adds the default component extensions. |
| 38 // | 45 // |
| 39 // Component extension manifests must contain a 'key' property with a unique | 46 // Component extension manifests must contain a 'key' property with a unique |
| 40 // public key, serialized in base64. You can create a suitable value with the | 47 // public key, serialized in base64. You can create a suitable value with the |
| 41 // following commands on a unixy system: | 48 // following commands on a unixy system: |
| 42 // | 49 // |
| 43 // ssh-keygen -t rsa -b 1024 -N '' -f /tmp/key.pem | 50 // ssh-keygen -t rsa -b 1024 -N '' -f /tmp/key.pem |
| 44 // openssl rsa -pubout -outform DER < /tmp/key.pem 2>/dev/null | base64 -w 0 | 51 // openssl rsa -pubout -outform DER < /tmp/key.pem 2>/dev/null | base64 -w 0 |
| 45 void AddDefaultComponentExtensions(); | 52 void AddDefaultComponentExtensions(); |
| 46 | 53 |
| 47 private: | 54 private: |
| 48 // Information about a registered component extension. | 55 // Information about a registered component extension. |
| 49 struct ComponentExtensionInfo { | 56 struct ComponentExtensionInfo { |
| 50 ComponentExtensionInfo(const std::string& manifest, | 57 ComponentExtensionInfo(const std::string& manifest, |
| 51 const FilePath& root_directory) | 58 const FilePath& root_directory, |
| 59 DictionaryValue* manifest_overrides) |
| 52 : manifest(manifest), | 60 : manifest(manifest), |
| 53 root_directory(root_directory) { | 61 root_directory(root_directory), |
| 62 manifest_overrides(manifest_overrides) { |
| 54 } | 63 } |
| 55 | 64 |
| 56 bool Equals(const ComponentExtensionInfo& other) const; | 65 bool Equals(const ComponentExtensionInfo& other) const; |
| 57 | 66 |
| 58 // The extension's manifest. This is required for component extensions so | 67 // The extension's manifest. This is required for component extensions so |
| 59 // that ExtensionService doesn't need to go to disk to load them. | 68 // that ExtensionService doesn't need to go to disk to load them. |
| 60 std::string manifest; | 69 std::string manifest; |
| 61 | 70 |
| 62 // Directory where the extension is stored. | 71 // Directory where the extension is stored. |
| 63 FilePath root_directory; | 72 FilePath root_directory; |
| 73 |
| 74 // If non-NULL, contains values that should be used to override the values |
| 75 // specified in the manifest. |
| 76 DictionaryValue* manifest_overrides; |
| 64 }; | 77 }; |
| 65 | 78 |
| 66 // Loads a registered component extension. | 79 // Loads a registered component extension. |
| 67 const Extension* Load(const ComponentExtensionInfo& info); | 80 const Extension* Load(const ComponentExtensionInfo& info); |
| 68 | 81 |
| 69 // Registers an extension to be loaded as a component extension. | 82 // Registers an extension to be loaded as a component extension. |
| 70 void Register(const ComponentExtensionInfo& info) { | 83 void Register(const ComponentExtensionInfo& info) { |
| 71 component_extensions_.push_back(info); | 84 component_extensions_.push_back(info); |
| 72 } | 85 } |
| 73 | 86 |
| 74 // List of registered component extensions (see Extension::Location). | 87 // List of registered component extensions (see Extension::Location). |
| 75 typedef std::vector<ComponentExtensionInfo> RegisteredComponentExtensions; | 88 typedef std::vector<ComponentExtensionInfo> RegisteredComponentExtensions; |
| 76 RegisteredComponentExtensions component_extensions_; | 89 RegisteredComponentExtensions component_extensions_; |
| 77 | 90 |
| 78 ExtensionService* extension_service_; | 91 ExtensionService* extension_service_; |
| 79 }; | 92 }; |
| 80 | 93 |
| 81 } // namespace extensions | 94 } // namespace extensions |
| 82 | 95 |
| 83 #endif // CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ | 96 #endif // CHROME_BROWSER_EXTENSIONS_COMPONENT_LOADER_H_ |
| OLD | NEW |