blob: 23542e9b358c8dde04299f8ee9895b40c832996c [file] [log] [blame]
[email protected]c333e792012-01-06 16:57:391// Copyright (c) 2012 The Chromium Authors. All rights reserved.
[email protected]6014d672008-12-05 00:38:252// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
[email protected]eaa7dd182010-12-14 11:09:005#ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_SERVICE_H_
6#define CHROME_BROWSER_EXTENSIONS_EXTENSION_SERVICE_H_
[email protected]6014d672008-12-05 00:38:257
[email protected]c51225632011-11-11 21:40:378#include <list>
[email protected]da50530a2009-06-15 17:43:019#include <map>
[email protected]31bb5ee62012-09-12 22:58:4010#include <set>
[email protected]b0beaa662009-02-26 00:04:1511#include <string>
[email protected]6014d672008-12-05 00:38:2512#include <vector>
13
[email protected]e0785902011-05-19 23:34:1714#include "base/compiler_specific.h"
[email protected]6014d672008-12-05 00:38:2515#include "base/file_path.h"
[email protected]a918f872010-06-01 14:30:5116#include "base/gtest_prod_util.h"
[email protected]3b63f8f42011-03-28 01:54:1517#include "base/memory/ref_counted.h"
[email protected]14908b72011-04-20 06:54:3618#include "base/memory/weak_ptr.h"
[email protected]03b9b4e2012-10-22 20:01:5219#include "base/prefs/public/pref_change_registrar.h"
[email protected]65187152012-06-02 13:14:1420#include "base/string16.h"
[email protected]178f8512012-02-09 01:49:3621#include "chrome/browser/extensions/app_shortcut_manager.h"
[email protected]5db9ada2012-04-11 13:48:2022#include "chrome/browser/extensions/app_sync_bundle.h"
[email protected]b671760b2010-07-15 21:13:4723#include "chrome/browser/extensions/extension_icon_manager.h"
[email protected]c38831a12011-10-28 12:44:4924#include "chrome/browser/extensions/extension_prefs.h"
[email protected]c6e4a3412009-06-24 15:45:2925#include "chrome/browser/extensions/extension_process_manager.h"
[email protected]5db9ada2012-04-11 13:48:2026#include "chrome/browser/extensions/extension_sync_bundle.h"
[email protected]e0360f2c2009-12-07 22:34:3127#include "chrome/browser/extensions/extension_toolbar_model.h"
[email protected]d13950e2009-12-04 01:43:0228#include "chrome/browser/extensions/extensions_quota_service.h"
[email protected]5df038b2012-07-16 19:03:2729#include "chrome/browser/extensions/external_provider_interface.h"
[email protected]5aeeae12012-07-05 19:13:1130#include "chrome/browser/extensions/menu_manager.h"
[email protected]b2907fd2011-03-25 16:43:3731#include "chrome/browser/extensions/pending_extension_manager.h"
[email protected]6f371442011-11-09 06:45:4632#include "chrome/browser/extensions/process_map.h"
[email protected]3bdba0d2011-08-23 07:17:3033#include "chrome/common/extensions/extension.h"
[email protected]814a7bf0f2011-08-13 05:30:5934#include "chrome/common/extensions/extension_constants.h"
[email protected]84df8332011-12-06 18:22:4635#include "chrome/common/extensions/extension_set.h"
[email protected]6c2381d2011-10-19 02:52:5336#include "content/public/browser/notification_observer.h"
37#include "content/public/browser/notification_registrar.h"
[email protected]36b643212012-09-07 12:53:0038#include "sync/api/string_ordinal.h"
[email protected]895a1e52012-05-15 02:50:1239#include "sync/api/sync_change.h"
40#include "sync/api/syncable_service.h"
[email protected]6014d672008-12-05 00:38:2541
[email protected]23d5f172011-10-25 05:49:5342class BookmarkExtensionEventRouter;
[email protected]dc9a74f72012-08-17 18:07:2143class CommandLine;
[email protected]89226982012-07-16 20:09:1844class ExtensionErrorUI;
[email protected]f825df22011-06-28 17:36:1045class ExtensionManagementEventRouter;
[email protected]3bdba0d2011-08-23 07:17:3046class ExtensionSyncData;
[email protected]e0360f2c2009-12-07 22:34:3147class ExtensionToolbarModel;
[email protected]d8c8f25f2011-11-02 18:18:0148class HistoryExtensionEventRouter;
[email protected]69f1be82009-04-16 22:27:2149class GURL;
[email protected]81e63782009-02-27 19:35:0950class Profile;
[email protected]aa142702010-03-26 01:26:3351class Version;
52
[email protected]7f8f24f2012-11-15 19:40:1453namespace base {
54class SequencedTaskRunner;
55}
56
[email protected]771a6182011-10-05 16:32:5257namespace chromeos {
58class ExtensionInputMethodEventRouter;
[email protected]d8c8f25f2011-11-02 18:18:0159}
60
[email protected]9c70e0d92012-07-16 08:39:4461namespace extensions {
[email protected]8d92e0382012-08-01 18:06:5262class AppNotificationManager;
[email protected]5db9ada2012-04-11 13:48:2063class AppSyncData;
[email protected]5a38dfd2012-07-23 23:22:1064class BrowserEventRouter;
[email protected]d8c8f25f2011-11-02 18:18:0165class ComponentLoader;
[email protected]e2d720aa2012-05-17 00:11:3566class ContentSettingsStore;
[email protected]bf3d9df2012-07-24 23:20:2767class CrxInstaller;
[email protected]1c321ee2012-05-21 03:02:3468class Extension;
[email protected]c77f2352012-08-08 22:07:5869class ExtensionActionStorageManager;
[email protected]92ba7b012012-05-16 03:36:1770class ExtensionCookiesEventRouter;
[email protected]163ed192012-07-24 19:31:0771class ExtensionManagedModeEventRouter;
[email protected]5db9ada2012-04-11 13:48:2072class ExtensionSyncData;
[email protected]bd306722012-07-11 20:43:5973class ExtensionSystem;
[email protected]42a08162012-03-16 18:09:1174class ExtensionUpdater;
[email protected]31bb5ee62012-09-12 22:58:4075class FontSettingsEventRouter;
76class MediaGalleriesPrivateEventRouter;
[email protected]3f213ad2012-07-26 23:39:4177class PendingExtensionManager;
[email protected]135e4782012-09-19 20:36:5278class PreferenceEventRouter;
[email protected]31bb5ee62012-09-12 22:58:4079class PushMessagingEventRouter;
[email protected]cccdf0aa2011-11-11 03:43:3880class SettingsFrontend;
[email protected]017ecde92012-04-04 09:11:2681class WebNavigationEventRouter;
[email protected]163ed192012-07-24 19:31:0782class WindowEventRouter;
83}
84
85namespace syncer {
[email protected]163ed192012-07-24 19:31:0786class SyncErrorFactory;
[email protected]d8c8f25f2011-11-02 18:18:0187}
[email protected]771a6182011-10-05 16:32:5288
[email protected]d1ca0ed12009-07-01 18:24:3289// This is an interface class to encapsulate the dependencies that
[email protected]2859946f2011-04-04 18:18:0690// various classes have on ExtensionService. This allows easy mocking.
[email protected]65f173552012-06-28 22:43:5891class ExtensionServiceInterface : public syncer::SyncableService {
[email protected]d1ca0ed12009-07-01 18:24:3292 public:
[email protected]b05fb9ff2011-04-23 00:07:5693 // A function that returns true if the given extension should be
94 // included and false if it should be filtered out. Identical to
95 // PendingExtensionInfo::ShouldAllowInstallPredicate.
[email protected]1c321ee2012-05-21 03:02:3496 typedef bool (*ExtensionFilter)(const extensions::Extension&);
[email protected]b05fb9ff2011-04-23 00:07:5697
[email protected]2859946f2011-04-04 18:18:0698 virtual ~ExtensionServiceInterface() {}
[email protected]84df8332011-12-06 18:22:4699 virtual const ExtensionSet* extensions() const = 0;
[email protected]c38fd352012-03-28 04:06:12100 virtual const ExtensionSet* disabled_extensions() const = 0;
[email protected]3f213ad2012-07-26 23:39:41101 virtual extensions::PendingExtensionManager* pending_extension_manager() = 0;
[email protected]420a0ec2011-06-01 01:07:03102
103 // Install an update. Return true if the install can be started.
104 // Set out_crx_installer to the installer if one was started.
105 virtual bool UpdateExtension(
106 const std::string& id,
107 const FilePath& path,
108 const GURL& download_url,
[email protected]bf3d9df2012-07-24 23:20:27109 extensions::CrxInstaller** out_crx_installer) = 0;
[email protected]1c321ee2012-05-21 03:02:34110 virtual const extensions::Extension* GetExtensionById(const std::string& id,
[email protected]b2907fd2011-03-25 16:43:37111 bool include_disabled) const = 0;
[email protected]1c321ee2012-05-21 03:02:34112 virtual const extensions::Extension* GetInstalledExtension(
[email protected]8001df22011-04-28 19:59:47113 const std::string& id) const = 0;
[email protected]2859946f2011-04-04 18:18:06114
[email protected]c3cfb012011-04-06 22:07:35115 virtual bool IsExtensionEnabled(const std::string& extension_id) const = 0;
116 virtual bool IsExternalExtensionUninstalled(
117 const std::string& extension_id) const = 0;
[email protected]2859946f2011-04-04 18:18:06118
[email protected]6b75ec32009-08-14 06:37:18119 virtual void UpdateExtensionBlacklist(
120 const std::vector<std::string>& blacklist) = 0;
[email protected]4ee07c62012-08-21 12:40:42121 virtual void CheckManagementPolicy() = 0;
[email protected]5ef47ec2010-01-28 05:58:05122
[email protected]31206602011-04-13 23:07:32123 // Safe to call multiple times in a row.
124 //
[email protected]90310d92011-04-17 07:35:04125 // TODO(akalin): Remove this method (and others) once we refactor
126 // themes sync to not use it directly.
[email protected]31206602011-04-13 23:07:32127 virtual void CheckForUpdatesSoon() = 0;
[email protected]25ae0152011-11-18 14:40:02128
[email protected]1c321ee2012-05-21 03:02:34129 virtual void AddExtension(const extensions::Extension* extension) = 0;
[email protected]25ae0152011-11-18 14:40:02130
131 virtual void UnloadExtension(
132 const std::string& extension_id,
133 extension_misc::UnloadedExtensionReason reason) = 0;
134
[email protected]1c321ee2012-05-21 03:02:34135 virtual void SyncExtensionChangeIfNeeded(
136 const extensions::Extension& extension) = 0;
[email protected]fb82dcd2012-03-21 14:15:46137
[email protected]25ae0152011-11-18 14:40:02138 virtual bool is_ready() = 0;
[email protected]7f8f24f2012-11-15 19:40:14139
140 // Returns task runner for crx installation file I/O operations.
141 virtual base::SequencedTaskRunner* GetFileTaskRunner() = 0;
[email protected]d1ca0ed12009-07-01 18:24:32142};
[email protected]fbcc40302009-06-12 20:45:45143
[email protected]4f313d52009-05-21 00:42:29144// Manages installed and running Chromium extensions.
[email protected]eaa7dd182010-12-14 11:09:00145class ExtensionService
[email protected]14908b72011-04-20 06:54:36146 : public ExtensionServiceInterface,
[email protected]5df038b2012-07-16 19:03:27147 public extensions::ExternalProviderInterface::VisitorInterface,
[email protected]90bb38d2012-11-14 18:36:03148 public content::NotificationObserver {
[email protected]4f313d52009-05-21 00:42:29149 public:
[email protected]a9b00ac2009-06-25 21:03:23150 // The name of the directory inside the profile where extensions are
151 // installed to.
[email protected]31bb5ee62012-09-12 22:58:40152 static const char kInstallDirectoryName[];
[email protected]a9b00ac2009-06-25 21:03:23153
[email protected]93fd78f42009-07-10 16:43:17154 // If auto-updates are turned on, default to running every 5 hours.
155 static const int kDefaultUpdateFrequencySeconds = 60 * 60 * 5;
156
[email protected]15d5b472011-11-24 04:17:24157 // The name of the directory inside the profile where per-app local settings
[email protected]b7f853e282011-08-10 09:24:20158 // are stored.
[email protected]31bb5ee62012-09-12 22:58:40159 static const char kLocalAppSettingsDirectoryName[];
[email protected]27cc7332011-11-01 01:56:43160
[email protected]15d5b472011-11-24 04:17:24161 // The name of the directory inside the profile where per-extension local
162 // settings are stored.
[email protected]31bb5ee62012-09-12 22:58:40163 static const char kLocalExtensionSettingsDirectoryName[];
[email protected]15d5b472011-11-24 04:17:24164
165 // The name of the directory inside the profile where per-app synced settings
[email protected]27cc7332011-11-01 01:56:43166 // are stored.
[email protected]31bb5ee62012-09-12 22:58:40167 static const char kSyncAppSettingsDirectoryName[];
[email protected]15d5b472011-11-24 04:17:24168
169 // The name of the directory inside the profile where per-extension synced
170 // settings are stored.
[email protected]31bb5ee62012-09-12 22:58:40171 static const char kSyncExtensionSettingsDirectoryName[];
[email protected]b7f853e282011-08-10 09:24:20172
[email protected]90e800c2012-06-12 23:11:00173 // The name of the database inside the profile where chrome-internal
174 // extension state resides.
[email protected]31bb5ee62012-09-12 22:58:40175 static const char kStateStoreName[];
[email protected]90e800c2012-06-12 23:11:00176
[email protected]d9696672011-03-15 22:45:09177 // Returns the Extension of hosted or packaged apps, NULL otherwise.
[email protected]dc9a74f72012-08-17 18:07:21178 const extensions::Extension* GetInstalledApp(const GURL& url) const;
[email protected]d9696672011-03-15 22:45:09179
[email protected]ffb204f22010-12-05 23:20:27180 // Returns whether the URL is from either a hosted or packaged app.
[email protected]dc9a74f72012-08-17 18:07:21181 bool IsInstalledApp(const GURL& url) const;
[email protected]ffb204f22010-12-05 23:20:27182
[email protected]404fb002012-10-02 21:06:17183 // If the renderer is hosting an installed app with isolated storage,
184 // returns it, otherwise returns NULL.
185 const extensions::Extension* GetIsolatedAppForRenderer(
[email protected]dc9a74f72012-08-17 18:07:21186 int renderer_child_id) const;
[email protected]da5683db2011-04-23 17:12:21187
[email protected]6aeac8342010-10-01 20:21:18188 // Attempts to uninstall an extension from a given ExtensionService. Returns
189 // true iff the target extension exists.
[email protected]eaa7dd182010-12-14 11:09:00190 static bool UninstallExtensionHelper(ExtensionService* extensions_service,
[email protected]6aeac8342010-10-01 20:21:18191 const std::string& extension_id);
192
[email protected]73c47932010-12-06 18:13:43193 // Constructor stores pointers to |profile| and |extension_prefs| but
194 // ownership remains at caller.
[email protected]eaa7dd182010-12-14 11:09:00195 ExtensionService(Profile* profile,
[email protected]a29a517a2011-01-21 21:11:12196 const CommandLine* command_line,
197 const FilePath& install_directory,
[email protected]45759612012-07-10 17:21:23198 extensions::ExtensionPrefs* extension_prefs,
[email protected]0436b102011-04-15 18:30:03199 bool autoupdate_enabled,
200 bool extensions_enabled);
[email protected]6014d672008-12-05 00:38:25201
[email protected]14908b72011-04-20 06:54:36202 virtual ~ExtensionService();
203
[email protected]6014d672008-12-05 00:38:25204 // Gets the list of currently installed extensions.
[email protected]84df8332011-12-06 18:22:46205 virtual const ExtensionSet* extensions() const OVERRIDE;
[email protected]c38fd352012-03-28 04:06:12206 virtual const ExtensionSet* disabled_extensions() const OVERRIDE;
[email protected]84df8332011-12-06 18:22:46207 const ExtensionSet* terminated_extensions() const;
[email protected]6014d672008-12-05 00:38:25208
[email protected]215a7be2012-10-22 19:53:42209 // Returns a set of all installed, disabled, and terminated extensions and
[email protected]7f4308d2012-01-18 07:43:01210 // transfers ownership to caller.
211 const ExtensionSet* GenerateInstalledExtensionsSet() const;
212
[email protected]215a7be2012-10-22 19:53:42213 // Returns a set of all extensions disabled by the sideload wipeout
214 // initiative.
215 const ExtensionSet* GetWipedOutExtensions() const;
216
[email protected]b2907fd2011-03-25 16:43:37217 // Gets the object managing the set of pending extensions.
[email protected]3f213ad2012-07-26 23:39:41218 virtual extensions::PendingExtensionManager*
219 pending_extension_manager() OVERRIDE;
[email protected]aa142702010-03-26 01:26:33220
[email protected]ec5b50d2010-10-09 16:35:18221 const FilePath& install_directory() const { return install_directory_; }
222
[email protected]6f371442011-11-09 06:45:46223 extensions::ProcessMap* process_map() { return &process_map_; }
224
[email protected]db7331a2010-02-25 22:10:50225 // Whether this extension can run in an incognito window.
[email protected]c3cfb012011-04-06 22:07:35226 virtual bool IsIncognitoEnabled(const std::string& extension_id) const;
227 virtual void SetIsIncognitoEnabled(const std::string& extension_id,
228 bool enabled);
[email protected]5ef47ec2010-01-28 05:58:05229
[email protected]b2689a902011-12-01 00:41:09230 // When app notification setup is done, we call this to save the developer's
231 // oauth client id which we'll need at uninstall time to revoke the oauth
232 // permission grant for sending notifications.
[email protected]aa7599d2011-10-28 07:24:32233 virtual void SetAppNotificationSetupDone(const std::string& extension_id,
[email protected]b2689a902011-12-01 00:41:09234 const std::string& oauth_client_id);
[email protected]aa7599d2011-10-28 07:24:32235
236 virtual void SetAppNotificationDisabled(const std::string& extension_id,
237 bool value);
238
[email protected]168389f2011-12-20 17:12:48239 // Updates the app launcher value for the moved extension so that it is now
240 // located after the given predecessor and before the successor. This will
241 // trigger a sync if needed. Empty strings are used to indicate no successor
242 // or predecessor.
243 void OnExtensionMoved(const std::string& moved_extension_id,
244 const std::string& predecessor_extension_id,
245 const std::string& successor_extension_id);
246
[email protected]2a8f24e2010-11-03 21:37:05247 // Returns true if the given extension can see events and data from another
248 // sub-profile (incognito to original profile, or vice versa).
[email protected]dc9a74f72012-08-17 18:07:21249 bool CanCrossIncognito(const extensions::Extension* extension) const;
[email protected]2a8f24e2010-11-03 21:37:05250
[email protected]5ef7b002011-05-12 23:16:20251 // Returns true if the given extension can be loaded in incognito.
[email protected]1c321ee2012-05-21 03:02:34252 bool CanLoadInIncognito(const extensions::Extension* extension) const;
[email protected]5ef7b002011-05-12 23:16:20253
[email protected]05c82182010-06-24 17:49:08254 // Whether this extension can inject scripts into pages with file URLs.
[email protected]dc9a74f72012-08-17 18:07:21255 bool AllowFileAccess(const extensions::Extension* extension) const;
[email protected]3aff9ad2011-04-01 20:26:48256 // Will reload the extension since this permission is applied at loading time
257 // only.
[email protected]1c321ee2012-05-21 03:02:34258 void SetAllowFileAccess(const extensions::Extension* extension, bool allow);
[email protected]05c82182010-06-24 17:49:08259
[email protected]720ad1312012-02-27 23:07:36260 // Whether the persistent background page, if any, is ready. We don't load
261 // other components until then. If there is no background page, or if it is
262 // non-persistent (lazy), we consider it to be ready.
[email protected]dc9a74f72012-08-17 18:07:21263 bool IsBackgroundPageReady(const extensions::Extension* extension) const;
[email protected]1c321ee2012-05-21 03:02:34264 void SetBackgroundPageReady(const extensions::Extension* extension);
[email protected]d7e9a862010-11-03 21:57:49265
266 // Getter and setter for the flag that specifies whether the extension is
267 // being upgraded.
[email protected]dc9a74f72012-08-17 18:07:21268 bool IsBeingUpgraded(const extensions::Extension* extension) const;
[email protected]1c321ee2012-05-21 03:02:34269 void SetBeingUpgraded(const extensions::Extension* extension, bool value);
[email protected]d7e9a862010-11-03 21:57:49270
[email protected]39a5b532011-10-22 01:47:07271 // Getter and setter for the flag that specifies if the extension has used
272 // the webrequest API.
273 // TODO(mpcomplete): remove. http://crbug.com/100411
[email protected]dc9a74f72012-08-17 18:07:21274 bool HasUsedWebRequest(const extensions::Extension* extension) const;
[email protected]1c321ee2012-05-21 03:02:34275 void SetHasUsedWebRequest(const extensions::Extension* extension, bool value);
[email protected]39a5b532011-10-22 01:47:07276
[email protected]6014d672008-12-05 00:38:25277 // Initialize and start all installed extensions.
[email protected]9f1087e2009-06-15 17:29:32278 void Init();
[email protected]6014d672008-12-05 00:38:25279
[email protected]cf593af2011-12-30 05:44:39280 // To delay some initialization until after import has finished, register
281 // for the notification.
282 // TODO(yoz): remove InitEventRoutersAterImport.
[email protected]d91268022011-08-26 13:17:37283 void InitEventRoutersAfterImport();
[email protected]cf593af2011-12-30 05:44:39284 void RegisterForImportFinished();
285
286 // Complete some initialization after being notified that import has finished.
287 void InitAfterImport();
[email protected]d91268022011-08-26 13:17:37288
[email protected]c5ae74ab2010-04-15 18:14:37289 // Start up the extension event routers.
290 void InitEventRouters();
291
[email protected]037228a2012-10-05 01:36:16292 // Called when the ProfileSyncService for the associated Profile is
293 // going to be destroyed. This is guaranteed to be called exactly
294 // once before Shutdown() is called.
295 //
296 // TODO(akalin): Remove this once http://crbug.com/153827 is fixed.
297 void OnProfileSyncServiceShutdown();
298
[email protected]47b896562012-08-22 23:55:15299 // Called when the associated Profile is going to be destroyed.
300 void Shutdown();
301
[email protected]8001df22011-04-28 19:59:47302 // Look up an extension by ID. Does not include terminated
303 // extensions.
[email protected]1c321ee2012-05-21 03:02:34304 virtual const extensions::Extension* GetExtensionById(
[email protected]b05fb9ff2011-04-23 00:07:56305 const std::string& id, bool include_disabled) const OVERRIDE;
[email protected]0c6da502009-08-14 22:32:39306
[email protected]8001df22011-04-28 19:59:47307 // Looks up a terminated (crashed) extension by ID.
[email protected]1c321ee2012-05-21 03:02:34308 const extensions::Extension*
309 GetTerminatedExtension(const std::string& id) const;
[email protected]8001df22011-04-28 19:59:47310
311 // Looks up an extension by ID, regardless of whether it's enabled,
312 // disabled, or terminated.
[email protected]1c321ee2012-05-21 03:02:34313 virtual const extensions::Extension* GetInstalledExtension(
[email protected]8001df22011-04-28 19:59:47314 const std::string& id) const OVERRIDE;
[email protected]0dfe05c2011-02-23 23:03:36315
[email protected]e957fe52009-06-23 16:51:05316 // Updates a currently-installed extension with the contents from
[email protected]7577a5c52009-07-30 06:21:58317 // |extension_path|.
[email protected]2a464a92009-08-01 17:58:35318 // TODO(aa): This method can be removed. ExtensionUpdater could use
319 // CrxInstaller directly instead.
[email protected]420a0ec2011-06-01 01:07:03320 virtual bool UpdateExtension(
321 const std::string& id,
322 const FilePath& extension_path,
323 const GURL& download_url,
[email protected]bf3d9df2012-07-24 23:20:27324 extensions::CrxInstaller** out_crx_installer) OVERRIDE;
[email protected]e957fe52009-06-23 16:51:05325
[email protected]9cddd4702009-07-27 22:09:40326 // Reloads the specified extension.
327 void ReloadExtension(const std::string& extension_id);
328
[email protected]32b36c62012-10-24 05:37:41329 // Restarts the specified extension.
330 void RestartExtension(const std::string& extension_id);
331
[email protected]631cf822009-05-15 07:01:25332 // Uninstalls the specified extension. Callers should only call this method
[email protected]17c4f3c2009-07-04 16:36:25333 // with extensions that exist. |external_uninstall| is a magical parameter
334 // that is only used to send information to ExtensionPrefs, which external
335 // callers should never set to true.
[email protected]a12c706e2011-12-01 00:58:08336 //
337 // We pass the |extension_id| by value to avoid having it deleted from under
338 // us incase someone calls it with Extension::id() or another string that we
339 // are going to delete in this function.
340 //
[email protected]17c4f3c2009-07-04 16:36:25341 // TODO(aa): Remove |external_uninstall| -- this information should be passed
342 // to ExtensionPrefs some other way.
[email protected]a12c706e2011-12-01 00:58:08343 virtual bool UninstallExtension(std::string extension_id,
[email protected]d6ebc9792011-04-07 18:18:33344 bool external_uninstall,
[email protected]65187152012-06-02 13:14:14345 string16* error);
[email protected]631cf822009-05-15 07:01:25346
[email protected]b05fb9ff2011-04-23 00:07:56347 virtual bool IsExtensionEnabled(
348 const std::string& extension_id) const OVERRIDE;
[email protected]c3cfb012011-04-06 22:07:35349 virtual bool IsExternalExtensionUninstalled(
[email protected]b05fb9ff2011-04-23 00:07:56350 const std::string& extension_id) const OVERRIDE;
[email protected]c3cfb012011-04-06 22:07:35351
[email protected]06f92562011-04-29 19:27:31352 // Enables the extension. If the extension is already enabled, does
353 // nothing.
[email protected]2859946f2011-04-04 18:18:06354 virtual void EnableExtension(const std::string& extension_id);
[email protected]06f92562011-04-29 19:27:31355
356 // Disables the extension. If the extension is already disabled, or
357 // cannot be disabled, does nothing.
[email protected]44d62b62012-04-11 00:06:03358 virtual void DisableExtension(const std::string& extension_id,
[email protected]1c321ee2012-05-21 03:02:34359 extensions::Extension::DisableReason disable_reason);
[email protected]0c6da502009-08-14 22:32:39360
[email protected]8d888c12010-11-30 00:00:25361 // Updates the |extension|'s granted permissions lists to include all
[email protected]8d888c12010-11-30 00:00:25362 // permissions in the |extension|'s manifest and re-enables the
363 // extension.
[email protected]1c321ee2012-05-21 03:02:34364 void GrantPermissionsAndEnableExtension(
[email protected]b70a2d92012-06-28 19:51:21365 const extensions::Extension* extension,
366 bool record_oauth2_grant);
[email protected]8d888c12010-11-30 00:00:25367
[email protected]be083862012-09-01 03:53:45368 // Updates the |extension|'s granted permissions lists to include all
369 // permissions in the |extensions|'s manifest.
370 void GrantPermissions(
371 const extensions::Extension* extension,
372 bool record_oauth2_grant);
373
[email protected]9f1087e2009-06-15 17:29:32374 // Check for updates (or potentially new extensions from external providers)
[email protected]93fd78f42009-07-10 16:43:17375 void CheckForExternalUpdates();
[email protected]9f1087e2009-06-15 17:29:32376
377 // Unload the specified extension.
[email protected]25ae0152011-11-18 14:40:02378 virtual void UnloadExtension(
379 const std::string& extension_id,
[email protected]1cc91fe2011-11-21 14:48:43380 extension_misc::UnloadedExtensionReason reason) OVERRIDE;
[email protected]9f1087e2009-06-15 17:29:32381
[email protected]57f71b92009-09-11 19:31:38382 // Unload all extensions. This is currently only called on shutdown, and
383 // does not send notifications.
[email protected]9f1087e2009-06-15 17:29:32384 void UnloadAllExtensions();
385
386 // Called only by testing.
387 void ReloadExtensions();
388
389 // Scan the extension directory and clean up the cruft.
390 void GarbageCollectExtensions();
391
[email protected]fb82dcd2012-03-21 14:15:46392 // Notifies Sync (if needed) of a newly-installed extension or a change to
393 // an existing extension.
[email protected]1c321ee2012-05-21 03:02:34394 virtual void SyncExtensionChangeIfNeeded(
395 const extensions::Extension& extension) OVERRIDE;
[email protected]fb82dcd2012-03-21 14:15:46396
[email protected]583d45c12010-08-31 02:48:12397 // Returns true if |url| should get extension api bindings and be permitted
398 // to make api calls. Note that this is independent of what extension
399 // permissions the given extension has been granted.
400 bool ExtensionBindingsAllowed(const GURL& url);
401
[email protected]4d007b312012-10-17 03:00:48402 // Returns true if a normal browser window should avoid showing |url| in a
403 // tab. In this case, |url| is also rewritten to an error URL.
404 bool ShouldBlockUrlInBrowserTab(GURL* url);
405
[email protected]b671760b2010-07-15 21:13:47406 // Returns the icon to display in the omnibox for the given extension.
[email protected]e8476c992012-08-20 20:27:59407 gfx::Image GetOmniboxIcon(const std::string& extension_id);
[email protected]b671760b2010-07-15 21:13:47408
[email protected]29d0d4ac2010-09-08 21:10:31409 // Returns the icon to display in the omnibox popup window for the given
410 // extension.
[email protected]e8476c992012-08-20 20:27:59411 gfx::Image GetOmniboxPopupIcon(const std::string& extension_id);
[email protected]29d0d4ac2010-09-08 21:10:31412
[email protected]c6d474f82009-12-16 21:11:06413 // Called when the initial extensions load has completed.
414 virtual void OnLoadedInstalledExtensions();
[email protected]7577a5c52009-07-30 06:21:58415
[email protected]49cd1572011-02-08 21:38:45416 // Adds |extension| to this ExtensionService and notifies observers than an
417 // extension has been loaded. Called by the backend after an extension has
418 // been loaded from a file and installed.
[email protected]1c321ee2012-05-21 03:02:34419 virtual void AddExtension(const extensions::Extension* extension) OVERRIDE;
[email protected]7577a5c52009-07-30 06:21:58420
421 // Called by the backend when an extension has been installed.
[email protected]8266d662011-07-12 21:53:26422 void OnExtensionInstalled(
[email protected]1c321ee2012-05-21 03:02:34423 const extensions::Extension* extension,
[email protected]98270432012-09-11 20:51:24424 const syncer::StringOrdinal& page_ordinal,
[email protected]0db124b02012-11-07 04:55:05425 bool has_requirement_errors,
426 bool wait_for_idle);
427
428 // Finishes installation of an update for an extension with the specified id,
429 // when installation of that extension was previously delayed because the
430 // extension was in use.
431 void FinishInstallation(const std::string& extension_id);
432
433 // Similar to FinishInstallation, but first checks if there still is an update
434 // pending for the extension, and makes sure the extension is still idle.
435 void MaybeFinishInstallation(const std::string& extension_id);
[email protected]7577a5c52009-07-30 06:21:58436
[email protected]902fd7b2011-07-27 18:42:31437 // Initializes the |extension|'s active permission set and disables the
438 // extension if the privilege level has increased (e.g., due to an upgrade).
[email protected]1c321ee2012-05-21 03:02:34439 void InitializePermissions(const extensions::Extension* extension);
[email protected]8d888c12010-11-30 00:00:25440
[email protected]215a7be2012-10-22 19:53:42441 // Check to see if this extension needs to be disabled, as per the sideload
442 // wipeout initiative.
443 void MaybeWipeout(const extensions::Extension* extension);
444
[email protected]6b75ec32009-08-14 06:37:18445 // Go through each extensions in pref, unload blacklisted extensions
446 // and update the blacklist state in pref.
447 virtual void UpdateExtensionBlacklist(
[email protected]8266d662011-07-12 21:53:26448 const std::vector<std::string>& blacklist) OVERRIDE;
[email protected]6b75ec32009-08-14 06:37:18449
[email protected]4ee07c62012-08-21 12:40:42450 // Go through each extension and unload those that are not allowed to run by
451 // management policy providers (ie. network admin and Google-managed
452 // blacklist).
453 virtual void CheckManagementPolicy() OVERRIDE;
[email protected]aa96d3a2010-08-21 08:45:25454
[email protected]b05fb9ff2011-04-23 00:07:56455 virtual void CheckForUpdatesSoon() OVERRIDE;
[email protected]c3cfb012011-04-06 22:07:35456
[email protected]65f173552012-06-28 22:43:58457 // syncer::SyncableService implementation.
458 virtual syncer::SyncError MergeDataAndStartSyncing(
[email protected]a4a147652012-07-03 23:41:32459 syncer::ModelType type,
[email protected]65f173552012-06-28 22:43:58460 const syncer::SyncDataList& initial_sync_data,
461 scoped_ptr<syncer::SyncChangeProcessor> sync_processor,
462 scoped_ptr<syncer::SyncErrorFactory> sync_error_factory) OVERRIDE;
[email protected]a4a147652012-07-03 23:41:32463 virtual void StopSyncing(syncer::ModelType type) OVERRIDE;
[email protected]65f173552012-06-28 22:43:58464 virtual syncer::SyncDataList GetAllSyncData(
[email protected]a4a147652012-07-03 23:41:32465 syncer::ModelType type) const OVERRIDE;
[email protected]65f173552012-06-28 22:43:58466 virtual syncer::SyncError ProcessSyncChanges(
[email protected]3bdba0d2011-08-23 07:17:30467 const tracked_objects::Location& from_here,
[email protected]65f173552012-06-28 22:43:58468 const syncer::SyncChangeList& change_list) OVERRIDE;
[email protected]90310d92011-04-17 07:35:04469
[email protected]5db9ada2012-04-11 13:48:20470 // Gets the sync data for the given extension, assuming that the extension is
471 // syncable.
472 extensions::ExtensionSyncData GetExtensionSyncData(
[email protected]1c321ee2012-05-21 03:02:34473 const extensions::Extension& extension) const;
[email protected]5db9ada2012-04-11 13:48:20474
475 // Gets the sync data for the given app, assuming that the app is
476 // syncable.
[email protected]1c321ee2012-05-21 03:02:34477 extensions::AppSyncData GetAppSyncData(
478 const extensions::Extension& extension) const;
[email protected]5db9ada2012-04-11 13:48:20479
480 // Gets the ExtensionSyncData for all extensions.
481 std::vector<extensions::ExtensionSyncData> GetExtensionSyncDataList() const;
482
483 // Gets the AppSyncData for all extensions.
484 std::vector<extensions::AppSyncData> GetAppSyncDataList() const;
485
486 // Applies the change specified passed in by either ExtensionSyncData or
487 // AppSyncData to the current system.
488 // Returns false if the changes were not completely applied and were added
489 // to the pending list to be tried again.
490 bool ProcessExtensionSyncData(
491 const extensions::ExtensionSyncData& extension_sync_data);
492 bool ProcessAppSyncData(const extensions::AppSyncData& app_sync_data);
493
494
[email protected]7577a5c52009-07-30 06:21:58495 void set_extensions_enabled(bool enabled) { extensions_enabled_ = enabled; }
[email protected]abe7a8942009-06-23 05:14:29496 bool extensions_enabled() { return extensions_enabled_; }
497
[email protected]0e34d7892009-06-05 19:17:40498 void set_show_extensions_prompts(bool enabled) {
499 show_extensions_prompts_ = enabled;
[email protected]e2eb43112009-05-29 21:19:54500 }
501
[email protected]0e34d7892009-06-05 19:17:40502 bool show_extensions_prompts() {
503 return show_extensions_prompts_;
[email protected]e2eb43112009-05-29 21:19:54504 }
505
[email protected]c3cfb012011-04-06 22:07:35506 Profile* profile();
[email protected]24e7a9d2009-11-04 11:11:34507
[email protected]c3cfb012011-04-06 22:07:35508 // TODO(skerner): Change to const ExtensionPrefs& extension_prefs() const,
509 // ExtensionPrefs* mutable_extension_prefs().
[email protected]45759612012-07-10 17:21:23510 extensions::ExtensionPrefs* extension_prefs();
[email protected]e81dba32009-06-19 20:19:13511
[email protected]0d9a2202011-11-09 13:48:41512 extensions::SettingsFrontend* settings_frontend();
[email protected]b7f853e282011-08-10 09:24:20513
[email protected]e2d720aa2012-05-17 00:11:35514 extensions::ContentSettingsStore* GetContentSettingsStore();
[email protected]b790b072011-05-20 09:46:44515
[email protected]3ecda252010-11-18 19:50:55516 // Whether the extension service is ready.
[email protected]25ae0152011-11-18 14:40:02517 virtual bool is_ready() OVERRIDE;
[email protected]3ecda252010-11-18 19:50:55518
[email protected]7f8f24f2012-11-15 19:40:14519 virtual base::SequencedTaskRunner* GetFileTaskRunner() OVERRIDE;
520
[email protected]d8c8f25f2011-11-02 18:18:01521 extensions::ComponentLoader* component_loader() {
522 return component_loader_.get();
523 }
524
[email protected]1fab8452009-09-03 02:23:39525 // Note that this may return NULL if autoupdate is not turned on.
[email protected]42a08162012-03-16 18:09:11526 extensions::ExtensionUpdater* updater();
[email protected]1fab8452009-09-03 02:23:39527
[email protected]e0360f2c2009-12-07 22:34:31528 ExtensionToolbarModel* toolbar_model() { return &toolbar_model_; }
529
[email protected]d13950e2009-12-04 01:43:02530 ExtensionsQuotaService* quota_service() { return &quota_service_; }
531
[email protected]5aeeae12012-07-05 19:13:11532 extensions::MenuManager* menu_manager() { return &menu_manager_; }
[email protected]2e3b5202010-03-23 06:52:41533
[email protected]8d92e0382012-08-01 18:06:52534 extensions::AppNotificationManager* app_notification_manager() {
[email protected]af9db5f2011-10-05 05:13:15535 return app_notification_manager_.get();
[email protected]c1d05aa2011-06-28 02:07:30536 }
537
[email protected]5a38dfd2012-07-23 23:22:10538 extensions::BrowserEventRouter* browser_event_router() {
[email protected]97d2f1d2011-01-15 00:41:08539 return browser_event_router_.get();
540 }
541
[email protected]163ed192012-07-24 19:31:07542 extensions::WindowEventRouter* window_event_router() {
543 return window_event_router_.get();
544 }
545
[email protected]cab208eb02012-10-18 22:15:23546#if defined(OS_CHROMEOS)
[email protected]771a6182011-10-05 16:32:52547 chromeos::ExtensionInputMethodEventRouter* input_method_event_router() {
548 return input_method_event_router_.get();
549 }
[email protected]b16fc2e2011-07-21 21:32:58550#endif
551
[email protected]5ebd6a62012-08-01 23:54:39552 extensions::PushMessagingEventRouter* push_messaging_event_router() {
553 return push_messaging_event_router_.get();
554 }
555
[email protected]d11c8e92009-10-20 23:26:40556 // Notify the frontend that there was an error loading an extension.
[email protected]d8c8f25f2011-11-02 18:18:01557 // This method is public because UnpackedInstaller and InstalledLoader
558 // can post to here.
559 // TODO(aa): Remove this. It doesn't do enough to be worth the dependency
560 // of these classes on ExtensionService.
[email protected]d11c8e92009-10-20 23:26:40561 void ReportExtensionLoadError(const FilePath& extension_path,
562 const std::string& error,
[email protected]d11c8e92009-10-20 23:26:40563 bool be_noisy);
564
[email protected]406027c02010-09-27 08:03:18565 // ExtensionHost of background page calls this method right after its render
566 // view has been created.
[email protected]3a1dc572012-07-31 22:25:13567 void DidCreateRenderViewForBackgroundPage(extensions::ExtensionHost* host);
[email protected]406027c02010-09-27 08:03:18568
[email protected]8e4560b62011-01-14 10:09:14569 // For the extension in |version_path| with |id|, check to see if it's an
570 // externally managed extension. If so, uninstall it.
571 void CheckExternalUninstall(const std::string& id);
572
[email protected]7f8f24f2012-11-15 19:40:14573 // Changes sequenced task runner for crx installation tasks to |task_runner|.
574 void SetFileTaskRunnerForTesting(base::SequencedTaskRunner* task_runner);
575
[email protected]5df038b2012-07-16 19:03:27576 // Clear all ExternalProviders.
[email protected]8e4560b62011-01-14 10:09:14577 void ClearProvidersForTesting();
578
[email protected]5df038b2012-07-16 19:03:27579 // Adds an ExternalProviderInterface for the service to use during testing.
580 // Takes ownership of |test_provider|.
581 void AddProviderForTesting(
582 extensions::ExternalProviderInterface* test_provider);
[email protected]8e4560b62011-01-14 10:09:14583
[email protected]5df038b2012-07-16 19:03:27584 // ExternalProvider::Visitor implementation.
[email protected]1c321ee2012-05-21 03:02:34585 virtual bool OnExternalExtensionFileFound(
586 const std::string& id,
587 const Version* version,
588 const FilePath& path,
589 extensions::Extension::Location location,
590 int creation_flags,
591 bool mark_acknowledged) OVERRIDE;
[email protected]8e4560b62011-01-14 10:09:14592
[email protected]1c321ee2012-05-21 03:02:34593 virtual bool OnExternalExtensionUpdateUrlFound(
594 const std::string& id,
595 const GURL& update_url,
596 extensions::Extension::Location location) OVERRIDE;
[email protected]8e4560b62011-01-14 10:09:14597
[email protected]50067e52011-10-20 23:17:07598 virtual void OnExternalProviderReady(
[email protected]5df038b2012-07-16 19:03:27599 const extensions::ExternalProviderInterface* provider) OVERRIDE;
[email protected]50067e52011-10-20 23:17:07600
[email protected]94fde232012-04-27 10:22:30601 // Returns true when all the external extension providers are ready.
602 bool AreAllExternalProvidersReady() const;
603
[email protected]50067e52011-10-20 23:17:07604 void OnAllExternalProvidersReady();
[email protected]8e4560b62011-01-14 10:09:14605
[email protected]62433d32011-10-12 22:33:12606 // Once all external providers are done, generates any needed alerts about
[email protected]e5af875f2011-10-10 21:09:14607 // extensions.
608 void IdentifyAlertableExtensions();
609
[email protected]89226982012-07-16 20:09:18610 // Given an ExtensionErrorUI alert, populates it with any extensions that
[email protected]07c9f2f42012-02-29 18:45:22611 // need alerting. Returns true if the alert should be displayed at all.
612 //
[email protected]89226982012-07-16 20:09:18613 // This method takes the extension_error_ui argument rather than using
[email protected]07c9f2f42012-02-29 18:45:22614 // the member variable to make it easier to test the method in isolation.
[email protected]89226982012-07-16 20:09:18615 bool PopulateExtensionErrorUI(ExtensionErrorUI* extension_error_ui);
[email protected]07c9f2f42012-02-29 18:45:22616
[email protected]612a1cb12012-10-17 13:18:03617 // Checks if there are any new external extensions to notify the user about.
618 void UpdateExternalExtensionAlert();
[email protected]e5af875f2011-10-10 21:09:14619
[email protected]47fc70c2011-12-06 07:29:51620 // Given a (presumably just-installed) extension id, mark that extension as
621 // acknowledged.
622 void AcknowledgeExternalExtension(const std::string& id);
623
[email protected]d96eb512012-11-01 23:44:08624 // Returns true if this extension is an external one that has yet to be
625 // marked as acknowledged.
626 bool IsUnacknowledgedExternalExtension(
627 const extensions::Extension* extension);
628
[email protected]62433d32011-10-12 22:33:12629 // Opens the Extensions page because the user wants to get more details
630 // about the alerts.
[email protected]89226982012-07-16 20:09:18631 void HandleExtensionAlertDetails();
[email protected]62433d32011-10-12 22:33:12632
[email protected]a9aa5932012-01-25 08:27:40633 // Called when the extension alert is closed.
634 void HandleExtensionAlertClosed();
[email protected]e5af875f2011-10-10 21:09:14635
[email protected]612a1cb12012-10-17 13:18:03636 // Marks alertable extensions as acknowledged, after the user presses the
637 // accept button.
638 void HandleExtensionAlertAccept();
639
[email protected]6c2381d2011-10-19 02:52:53640 // content::NotificationObserver
[email protected]432115822011-07-10 15:52:27641 virtual void Observe(int type,
[email protected]6c2381d2011-10-19 02:52:53642 const content::NotificationSource& source,
643 const content::NotificationDetails& details) OVERRIDE;
[email protected]4814b512009-11-07 00:12:29644
[email protected]ec5b50d2010-10-09 16:35:18645 // Whether there are any apps installed. Component apps are not included.
646 bool HasApps() const;
647
648 // Gets the set of loaded app ids. Component apps are not included.
[email protected]1c321ee2012-05-21 03:02:34649 extensions::ExtensionIdSet GetAppIds() const;
[email protected]377011d2010-07-20 04:18:50650
[email protected]fe2dd7742011-04-19 22:52:49651 // Record a histogram using the PermissionMessage enum values for each
652 // permission in |e|.
653 // NOTE: If this is ever called with high frequency, the implementation may
654 // need to be made more efficient.
655 static void RecordPermissionMessagesHistogram(
[email protected]1c321ee2012-05-21 03:02:34656 const extensions::Extension* e, const char* histogram);
[email protected]fe2dd7742011-04-19 22:52:49657
[email protected]65992d52012-09-19 23:05:31658 // Open a dev tools window for the background page for the given extension,
659 // starting the background page first if necesary.
660 void InspectBackgroundPage(const extensions::Extension* extension);
661
[email protected]fa2416f2011-05-03 08:41:20662#if defined(UNIT_TEST)
[email protected]1c321ee2012-05-21 03:02:34663 void TrackTerminatedExtensionForTest(const extensions::Extension* extension) {
[email protected]fa2416f2011-05-03 08:41:20664 TrackTerminatedExtension(extension);
665 }
666#endif
667
[email protected]b1912d592012-08-17 22:29:38668 extensions::AppShortcutManager* app_shortcut_manager() {
669 return &app_shortcut_manager_;
670 }
[email protected]178f8512012-02-09 01:49:36671
[email protected]65f173552012-06-28 22:43:58672 // Specialization of syncer::SyncableService::AsWeakPtr.
[email protected]77e4dc0882012-06-20 18:53:50673 base::WeakPtr<ExtensionService> AsWeakPtr() { return base::AsWeakPtr(this); }
674
[email protected]3c4abc82012-10-22 22:25:54675 bool browser_terminating() const { return browser_terminating_; }
676
677 // For testing.
678 void set_browser_terminating_for_test(bool value) {
679 browser_terminating_ = value;
680 }
681
[email protected]fc332ae2012-11-14 20:17:33682 // By default ExtensionService will wait with installing an updated extension
683 // until the extension is idle. Tests might not like this behavior, so you can
684 // disable it with this method.
685 void set_install_updates_when_idle_for_test(bool value) {
686 install_updates_when_idle_ = value;
687 }
688
[email protected]14908b72011-04-20 06:54:36689 private:
[email protected]d7e9a862010-11-03 21:57:49690 // Contains Extension data that can change during the life of the process,
691 // but does not persist across restarts.
692 struct ExtensionRuntimeData {
693 // True if the background page is ready.
694 bool background_page_ready;
695
696 // True while the extension is being upgraded.
697 bool being_upgraded;
698
[email protected]39a5b532011-10-22 01:47:07699 // True if the extension has used the webRequest API.
700 bool has_used_webrequest;
701
[email protected]d7e9a862010-11-03 21:57:49702 ExtensionRuntimeData();
703 ~ExtensionRuntimeData();
704 };
705 typedef std::map<std::string, ExtensionRuntimeData> ExtensionRuntimeDataMap;
706
[email protected]cebc3dc2011-04-18 17:15:00707 struct NaClModuleInfo {
708 NaClModuleInfo();
709 ~NaClModuleInfo();
710
711 GURL url;
712 std::string mime_type;
713 };
714 typedef std::list<NaClModuleInfo> NaClModuleInfoList;
715
[email protected]5db9ada2012-04-11 13:48:20716 // Return true if the sync type of |extension| matches |type|.
[email protected]1c321ee2012-05-21 03:02:34717 bool IsCorrectSyncType(const extensions::Extension& extension,
[email protected]a4a147652012-07-03 23:41:32718 syncer::ModelType type)
[email protected]3bdba0d2011-08-23 07:17:30719 const;
720
[email protected]90bb38d2012-11-14 18:36:03721 void OnExtensionInstallPrefChanged();
722
[email protected]5db9ada2012-04-11 13:48:20723 // Handles setting the extension specific values in |extension_sync_data| to
724 // the current system.
725 // Returns false if the changes were not completely applied and need to be
726 // tried again later.
727 bool ProcessExtensionSyncDataHelper(
728 const extensions::ExtensionSyncData& extension_sync_data,
[email protected]a4a147652012-07-03 23:41:32729 syncer::ModelType type);
[email protected]3bdba0d2011-08-23 07:17:30730
[email protected]81f0d162012-08-15 04:21:47731 enum IncludeFlag {
732 INCLUDE_NONE = 0,
733 INCLUDE_ENABLED = 1 << 0,
734 INCLUDE_DISABLED = 1 << 1,
735 INCLUDE_TERMINATED = 1 << 2
736 };
737
[email protected]32b36c62012-10-24 05:37:41738 // Events to be fired after an extension is reloaded.
739 enum PostReloadEvents {
740 EVENT_NONE = 0,
741 EVENT_LAUNCHED = 1 << 0,
742 EVENT_RESTARTED = 1 << 1,
743 };
744
[email protected]0c6da502009-08-14 22:32:39745 // Look up an extension by ID, optionally including either or both of enabled
746 // and disabled extensions.
[email protected]1c321ee2012-05-21 03:02:34747 const extensions::Extension* GetExtensionByIdInternal(
748 const std::string& id,
[email protected]81f0d162012-08-15 04:21:47749 int include_mask) const;
[email protected]0c6da502009-08-14 22:32:39750
[email protected]fa2416f2011-05-03 08:41:20751 // Adds the given extension to the list of terminated extensions if
752 // it is not already there and unloads it.
[email protected]1c321ee2012-05-21 03:02:34753 void TrackTerminatedExtension(const extensions::Extension* extension);
[email protected]fa2416f2011-05-03 08:41:20754
755 // Removes the extension with the given id from the list of
756 // terminated extensions if it is there.
[email protected]bb7f40952011-01-13 00:21:20757 void UntrackTerminatedExtension(const std::string& id);
758
[email protected]62d30f42009-10-01 22:36:06759 // Handles sending notification that |extension| was loaded.
[email protected]1c321ee2012-05-21 03:02:34760 void NotifyExtensionLoaded(const extensions::Extension* extension);
[email protected]62d30f42009-10-01 22:36:06761
762 // Handles sending notification that |extension| was unloaded.
[email protected]1c321ee2012-05-21 03:02:34763 void NotifyExtensionUnloaded(const extensions::Extension* extension,
[email protected]814a7bf0f2011-08-13 05:30:59764 extension_misc::UnloadedExtensionReason reason);
[email protected]62d30f42009-10-01 22:36:06765
[email protected]32b36c62012-10-24 05:37:41766 // Reloads |extension_id| and then dispatches to it the PostReloadEvents
767 // indicated by |events|.
768 void ReloadExtensionWithEvents(const std::string& extension_id,
769 int events);
770
771 // Returns true if the app with id |extension_id| has any shell windows open.
772 bool HasShellWindows(const std::string& extension_id);
773
[email protected]aab98a52009-12-02 03:22:35774 // Helper that updates the active extension list used for crash reporting.
775 void UpdateActiveExtensionsInCrashReporter();
776
[email protected]cebc3dc2011-04-18 17:15:00777 // We implement some Pepper plug-ins using NaCl to take advantage of NaCl's
778 // strong sandbox. Typically, these NaCl modules are stored in extensions
779 // and registered here. Not all NaCl modules need to register for a MIME
780 // type, just the ones that are responsible for rendering a particular MIME
781 // type, like application/pdf. Note: We only register NaCl modules in the
782 // browser process.
783 void RegisterNaClModule(const GURL& url, const std::string& mime_type);
784 void UnregisterNaClModule(const GURL& url);
785
[email protected]ed0ba002011-05-26 16:55:13786 // Call UpdatePluginListWithNaClModules() after registering or unregistering
787 // a NaCl module to see those changes reflected in the PluginList.
788 void UpdatePluginListWithNaClModules();
789
[email protected]cebc3dc2011-04-18 17:15:00790 NaClModuleInfoList::iterator FindNaClModule(const GURL& url);
791
[email protected]32b36c62012-10-24 05:37:41792 // Performs tasks requested to occur after |extension| loads.
793 void DoPostLoadTasks(const extensions::Extension* extension);
794
[email protected]6cafe35a2012-08-27 22:40:50795 // Launches the platform app associated with |extension_host|.
796 static void LaunchApplication(extensions::ExtensionHost* extension_host);
797
[email protected]32b36c62012-10-24 05:37:41798 // Dispatches a restart event to the platform app associated with
799 // |extension_host|.
800 static void RestartApplication(extensions::ExtensionHost* extension_host);
801
[email protected]65992d52012-09-19 23:05:31802 // Helper to inspect an ExtensionHost after it has been loaded.
803 void InspectExtensionHost(extensions::ExtensionHost* host);
804
[email protected]612a1cb12012-10-17 13:18:03805 // Helper to determine whether we should initially enable an installed
806 // (or upgraded) extension.
807 bool ShouldEnableOnInstall(const extensions::Extension* extension);
808
[email protected]0db124b02012-11-07 04:55:05809 // Helper to determine if an extension is idle, and it should be safe
810 // to update the extension.
811 bool IsExtensionIdle(const std::string& extension_id) const;
812
[email protected]31d8f5f22012-04-02 15:22:08813 // The normal profile associated with this ExtensionService.
[email protected]6ef635e42009-07-26 06:16:12814 Profile* profile_;
815
[email protected]31d8f5f22012-04-02 15:22:08816 // The ExtensionSystem for the profile above.
[email protected]bd306722012-07-11 20:43:59817 extensions::ExtensionSystem* system_;
[email protected]31d8f5f22012-04-02 15:22:08818
[email protected]73c47932010-12-06 18:13:43819 // Preferences for the owning profile (weak reference).
[email protected]45759612012-07-10 17:21:23820 extensions::ExtensionPrefs* extension_prefs_;
[email protected]894bb502009-05-21 22:39:57821
[email protected]adfc5462011-09-21 19:07:13822 // Settings for the owning profile.
[email protected]cccdf0aa2011-11-11 03:43:38823 scoped_ptr<extensions::SettingsFrontend> settings_frontend_;
[email protected]b7f853e282011-08-10 09:24:20824
[email protected]6014d672008-12-05 00:38:25825 // The current list of installed extensions.
[email protected]84df8332011-12-06 18:22:46826 ExtensionSet extensions_;
[email protected]6014d672008-12-05 00:38:25827
[email protected]0c6da502009-08-14 22:32:39828 // The list of installed extensions that have been disabled.
[email protected]84df8332011-12-06 18:22:46829 ExtensionSet disabled_extensions_;
[email protected]0c6da502009-08-14 22:32:39830
[email protected]bb7f40952011-01-13 00:21:20831 // The list of installed extensions that have been terminated.
[email protected]84df8332011-12-06 18:22:46832 ExtensionSet terminated_extensions_;
[email protected]bb7f40952011-01-13 00:21:20833
[email protected]0db124b02012-11-07 04:55:05834 // The list of extension updates that are waiting to be installed.
835 ExtensionSet pending_extension_updates_;
836
[email protected]b2907fd2011-03-25 16:43:37837 // Hold the set of pending extensions.
[email protected]3f213ad2012-07-26 23:39:41838 extensions::PendingExtensionManager pending_extension_manager_;
[email protected]aa142702010-03-26 01:26:33839
[email protected]d7e9a862010-11-03 21:57:49840 // The map of extension IDs to their runtime data.
841 ExtensionRuntimeDataMap extension_runtime_data_;
842
[email protected]6014d672008-12-05 00:38:25843 // The full path to the directory where extensions are installed.
844 FilePath install_directory_;
845
[email protected]e2eb43112009-05-29 21:19:54846 // Whether or not extensions are enabled.
847 bool extensions_enabled_;
848
[email protected]0e34d7892009-06-05 19:17:40849 // Whether to notify users when they attempt to install an extension.
850 bool show_extensions_prompts_;
[email protected]e2eb43112009-05-29 21:19:54851
[email protected]fc332ae2012-11-14 20:17:33852 // Whether to delay installing of extension updates until the extension is
853 // idle.
854 bool install_updates_when_idle_;
855
[email protected]d13950e2009-12-04 01:43:02856 // Used by dispatchers to limit API quota for individual extensions.
857 ExtensionsQuotaService quota_service_;
858
[email protected]432115822011-07-10 15:52:27859 // Record that Init() has been called, and chrome::EXTENSIONS_READY
[email protected]fa6a9102010-11-22 15:38:50860 // has fired.
[email protected]3ecda252010-11-18 19:50:55861 bool ready_;
[email protected]e81dba32009-06-19 20:19:13862
[email protected]93fd78f42009-07-10 16:43:17863 // Our extension updater, if updates are turned on.
[email protected]42a08162012-03-16 18:09:11864 scoped_ptr<extensions::ExtensionUpdater> updater_;
[email protected]93fd78f42009-07-10 16:43:17865
[email protected]e0360f2c2009-12-07 22:34:31866 // The model that tracks extensions with BrowserAction buttons.
867 ExtensionToolbarModel toolbar_model_;
868
[email protected]1eb175082010-02-10 09:26:16869 // Map unloaded extensions' ids to their paths. When a temporarily loaded
[email protected]5fb889382011-06-03 00:29:20870 // extension is unloaded, we lose the information about it and don't have
[email protected]1eb175082010-02-10 09:26:16871 // any in the extension preferences file.
872 typedef std::map<std::string, FilePath> UnloadedExtensionPathMap;
873 UnloadedExtensionPathMap unloaded_extension_paths_;
874
[email protected]f17dbd42010-08-16 23:21:10875 // Map disabled extensions' ids to their paths. When a temporarily loaded
876 // extension is disabled before it is reloaded, keep track of the path so that
877 // it can be re-enabled upon a successful load.
878 typedef std::map<std::string, FilePath> DisabledExtensionPathMap;
879 DisabledExtensionPathMap disabled_extension_paths_;
880
[email protected]4814b512009-11-07 00:12:29881 // Map of inspector cookies that are detached, waiting for an extension to be
882 // reloaded.
883 typedef std::map<std::string, int> OrphanedDevTools;
884 OrphanedDevTools orphaned_dev_tools_;
885
[email protected]32b36c62012-10-24 05:37:41886 // Maps extension ids to a bitmask that indicates which events should be
887 // dispatched to the extension when it is loaded.
888 std::map<std::string, int> on_load_events_;
[email protected]6cafe35a2012-08-27 22:40:50889
[email protected]6c2381d2011-10-19 02:52:53890 content::NotificationRegistrar registrar_;
[email protected]2fb7dc982010-09-29 12:24:28891 PrefChangeRegistrar pref_change_registrar_;
[email protected]4814b512009-11-07 00:12:29892
[email protected]d8c8f25f2011-11-02 18:18:01893 // Keeps track of loading and unloading component extensions.
894 scoped_ptr<extensions::ComponentLoader> component_loader_;
895
[email protected]2e3b5202010-03-23 06:52:41896 // Keeps track of menu items added by extensions.
[email protected]5aeeae12012-07-05 19:13:11897 extensions::MenuManager menu_manager_;
[email protected]2e3b5202010-03-23 06:52:41898
[email protected]c1d05aa2011-06-28 02:07:30899 // Keeps track of app notifications.
[email protected]8d92e0382012-08-01 18:06:52900 scoped_refptr<extensions::AppNotificationManager> app_notification_manager_;
[email protected]c1d05aa2011-06-28 02:07:30901
[email protected]b671760b2010-07-15 21:13:47902 // Keeps track of favicon-sized omnibox icons for extensions.
903 ExtensionIconManager omnibox_icon_manager_;
[email protected]29d0d4ac2010-09-08 21:10:31904 ExtensionIconManager omnibox_popup_icon_manager_;
[email protected]b671760b2010-07-15 21:13:47905
[email protected]b3d62312b12010-10-14 21:10:18906 // Flag to make sure event routers are only initialized once.
907 bool event_routers_initialized_;
908
[email protected]c4dc5cc2012-11-09 08:48:39909 // TODO(yoz): None of these should be owned by ExtensionService.
910 // crbug.com/159265
[email protected]d2e6bd62011-10-24 20:29:07911 scoped_ptr<HistoryExtensionEventRouter> history_event_router_;
[email protected]f825df22011-06-28 17:36:10912
[email protected]5a38dfd2012-07-23 23:22:10913 scoped_ptr<extensions::BrowserEventRouter> browser_event_router_;
[email protected]da55b8d2011-05-26 00:09:49914
[email protected]163ed192012-07-24 19:31:07915 scoped_ptr<extensions::WindowEventRouter> window_event_router_;
916
[email protected]135e4782012-09-19 20:36:52917 scoped_ptr<extensions::PreferenceEventRouter> preference_event_router_;
[email protected]118de7892011-03-16 13:31:40918
[email protected]23d5f172011-10-25 05:49:53919 scoped_ptr<BookmarkExtensionEventRouter> bookmark_event_router_;
[email protected]f825df22011-06-28 17:36:10920
[email protected]92ba7b012012-05-16 03:36:17921 scoped_ptr<extensions::ExtensionCookiesEventRouter> cookies_event_router_;
[email protected]f825df22011-06-28 17:36:10922
923 scoped_ptr<ExtensionManagementEventRouter> management_event_router_;
924
[email protected]31bb5ee62012-09-12 22:58:40925 scoped_ptr<extensions::MediaGalleriesPrivateEventRouter>
926 media_galleries_private_event_router_;
927
[email protected]5ebd6a62012-08-01 23:54:39928 scoped_ptr<extensions::PushMessagingEventRouter>
929 push_messaging_event_router_;
930
[email protected]017ecde92012-04-04 09:11:26931 scoped_ptr<extensions::WebNavigationEventRouter> web_navigation_event_router_;
[email protected]f825df22011-06-28 17:36:10932
[email protected]91aa8a32012-08-07 10:35:33933 scoped_ptr<extensions::FontSettingsEventRouter> font_settings_event_router_;
[email protected]bdd34452012-04-16 15:58:40934
[email protected]9c70e0d92012-07-16 08:39:44935 scoped_ptr<extensions::ExtensionManagedModeEventRouter>
936 managed_mode_event_router_;
[email protected]8a4cf842012-05-16 13:35:30937
[email protected]b16fc2e2011-07-21 21:32:58938#if defined(OS_CHROMEOS)
[email protected]771a6182011-10-05 16:32:52939 scoped_ptr<chromeos::ExtensionInputMethodEventRouter>
940 input_method_event_router_;
[email protected]b16fc2e2011-07-21 21:32:58941#endif
942
[email protected]8e4560b62011-01-14 10:09:14943 // A collection of external extension providers. Each provider reads
944 // a source of external extension information. Examples include the
945 // windows registry and external_extensions.json.
[email protected]5df038b2012-07-16 19:03:27946 extensions::ProviderCollection external_extension_providers_;
[email protected]8e4560b62011-01-14 10:09:14947
948 // Set to true by OnExternalExtensionUpdateUrlFound() when an external
[email protected]94fde232012-04-27 10:22:30949 // extension URL is found, and by CheckForUpdatesSoon() when an update check
950 // has to wait for the external providers. Used in
951 // OnAllExternalProvidersReady() to determine if an update check is needed to
952 // install pending extensions.
953 bool update_once_all_providers_are_ready_;
[email protected]8e4560b62011-01-14 10:09:14954
[email protected]3c4abc82012-10-22 22:25:54955 // Set when the browser is terminating. Prevents us from installing or
956 // updating additional extensions and allows in-progress installations to
957 // decide to abort.
958 bool browser_terminating_;
959
[email protected]cebc3dc2011-04-18 17:15:00960 NaClModuleInfoList nacl_module_list_;
961
[email protected]5db9ada2012-04-11 13:48:20962 extensions::AppSyncBundle app_sync_bundle_;
963 extensions::ExtensionSyncBundle extension_sync_bundle_;
[email protected]3bdba0d2011-08-23 07:17:30964
[email protected]6f371442011-11-09 06:45:46965 extensions::ProcessMap process_map_;
966
[email protected]b1912d592012-08-17 22:29:38967 extensions::AppShortcutManager app_shortcut_manager_;
[email protected]9de83282011-12-12 11:06:37968
[email protected]89226982012-07-16 20:09:18969 scoped_ptr<ExtensionErrorUI> extension_error_ui_;
[email protected]7f8f24f2012-11-15 19:40:14970 // Sequenced task runner for extension related file operations.
971 scoped_refptr<base::SequencedTaskRunner> file_task_runner_;
[email protected]a9aa5932012-01-25 08:27:40972
[email protected]9ce11d22012-08-08 23:20:13973#if defined(ENABLE_EXTENSIONS)
[email protected]c77f2352012-08-08 22:07:58974 scoped_ptr<extensions::ExtensionActionStorageManager>
975 extension_action_storage_manager_;
[email protected]9ce11d22012-08-08 23:20:13976#endif
[email protected]c77f2352012-08-08 22:07:58977
[email protected]eaa7dd182010-12-14 11:09:00978 FRIEND_TEST_ALL_PREFIXES(ExtensionServiceTest,
[email protected]c2c263c2010-08-13 21:59:48979 InstallAppsWithUnlimtedStorage);
[email protected]eaa7dd182010-12-14 11:09:00980 FRIEND_TEST_ALL_PREFIXES(ExtensionServiceTest,
[email protected]654512b2010-09-01 02:09:42981 InstallAppsAndCheckStorageProtection);
[email protected]eaa7dd182010-12-14 11:09:00982 DISALLOW_COPY_AND_ASSIGN(ExtensionService);
[email protected]6014d672008-12-05 00:38:25983};
984
[email protected]eaa7dd182010-12-14 11:09:00985#endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_SERVICE_H_