src/chrome/browser/chromeos/policy/app_pack_updater.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_CHROMEOS_POLICY_APP_PACK_UPDATER_H_
   6 #define CHROME_BROWSER_CHROMEOS_POLICY_APP_PACK_UPDATER_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/callback.h"
  12 #include "base/compiler_specific.h"
  13 #include "base/files/file_path.h"
  14 #include "base/memory/scoped_ptr.h"
  15 #include "base/memory/weak_ptr.h"
  16 #include "chrome/browser/chromeos/extensions/external_cache.h"
  17 #include "chrome/browser/chromeos/settings/cros_settings.h"
  18
  19 namespace extensions {
  20 class ExternalLoader;
  21 }
  22
  23 namespace net {
  24 class URLRequestContextGetter;
  25 }
  26
  27 namespace policy {
  28
  29 class AppPackExternalLoader;
  30 class EnterpriseInstallAttributes;
  31
  32 // The AppPackUpdater manages a set of extensions that are configured via a
  33 // device policy to be locally cached and installed into the Demo user account
  34 // at login time.
  35 class AppPackUpdater : public chromeos::ExternalCache::Delegate {
  36  public:
  37   // Callback to listen for updates to the screensaver extension's path.
  38   typedef base::Callback<void(const base::FilePath&)> ScreenSaverUpdateCallback;
  39
  40   // The |request_context| is used for the update checks.
  41   AppPackUpdater(net::URLRequestContextGetter* request_context,
  42                  EnterpriseInstallAttributes* install_attributes);
  43   virtual ~AppPackUpdater();
  44
  45   // Returns true if the ExternalLoader for the app pack has already been
  46   // created.
  47   bool created_external_loader() const { return created_extension_loader_; }
  48
  49   // Creates an extensions::ExternalLoader that will load the crx files
  50   // downloaded by the AppPackUpdater. This can be called at most once, and the
  51   // caller owns the returned value.
  52   extensions::ExternalLoader* CreateExternalLoader();
  53
  54   // |callback| will be invoked whenever the screen saver extension's path
  55   // changes. It will be invoked "soon" after this call if a valid path already
  56   // exists. Subsequent calls will override the previous |callback|. A null
  57   // |callback| can be used to remove a previous callback.
  58   void SetScreenSaverUpdateCallback(const ScreenSaverUpdateCallback& callback);
  59
  60   // If a user of one of the AppPack's extensions detects that the extension
  61   // is damaged then this method can be used to remove it from the cache and
  62   // retry to download it after a restart.
  63   void OnDamagedFileDetected(const base::FilePath& path);
  64
  65  private:
  66   // Implementation of ExternalCache::Delegate:
  67   virtual void OnExtensionListsUpdated(
  68       const base::DictionaryValue* prefs) OVERRIDE;
  69
  70   // Called when the app pack device setting changes.
  71   void AppPackChanged();
  72
  73   // Loads the current policy and schedules a cache update.
  74   void LoadPolicy();
  75
  76   // Notifies the |extension_loader_| that the cache has been updated, providing
  77   // it with an updated list of app-pack extensions.
  78   void UpdateExtensionLoader();
  79
  80   // Sets |screen_saver_path_| and invokes |screen_saver_update_callback_| if
  81   // appropriate.
  82   void SetScreenSaverPath(const base::FilePath& path);
  83
  84   base::WeakPtrFactory<AppPackUpdater> weak_ptr_factory_;
  85
  86   // The extension ID and path of the CRX file of the screen saver extension,
  87   // if it is configured by the policy. Otherwise these fields are empty.
  88   std::string screen_saver_id_;
  89   base::FilePath screen_saver_path_;
  90
  91   // Callback to invoke whenever the screen saver's extension path changes.
  92   // Can be null.
  93   ScreenSaverUpdateCallback screen_saver_update_callback_;
  94
  95   // The extension loader wires the AppPackUpdater to the extensions system, and
  96   // makes it install the currently cached extensions.
  97   bool created_extension_loader_;
  98   base::WeakPtr<AppPackExternalLoader> extension_loader_;
  99
 100   // For checking the device mode.
 101   EnterpriseInstallAttributes* install_attributes_;
 102
 103   // Extension cache.
 104   chromeos::ExternalCache external_cache_;
 105
 106   scoped_ptr<chromeos::CrosSettings::ObserverSubscription>
 107       app_pack_subscription_;
 108
 109   DISALLOW_COPY_AND_ASSIGN(AppPackUpdater);
 110 };
 111
 112 }  // namespace policy
 113
 114 #endif  // CHROME_BROWSER_CHROMEOS_POLICY_APP_PACK_UPDATER_H_