Pull CrxInstaller out of ExtensionsService.

chrome/browser/extensions/crx_installer.h

+// Copyright (c) 2009 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_CRX_INSTALLER_H_
+#define CHROME_BROWSER_EXTENSIONS_CRX_INSTALLER_H_
+
+#include <string>
+
+#include "base/file_path.h"
+#include "base/message_loop.h"
+#include "base/ref_counted.h"
+#include "chrome/browser/extensions/extensions_service.h"
+#include "chrome/browser/extensions/sandboxed_extension_unpacker.h"
+#include "chrome/common/extensions/extension.h"
+
+// This class installs a crx file into a profile.
+//
+// Installing a CRX is a multi-step process, including unpacking the crx,
+// validating it, prompting the user, and installing. Since many of these
+// steps must occur on the file thread, this class contains a copy of all data
+// necessary to do its job. (This also minimizes external dependencies for
+// easier testing).
+//
+//
+// Lifetime management:
+//
+// This class is ref-counted by each call it makes to itself on another thread,
+// and by UtilityProcessHost.
+//
+// Additionally, we hold a reference to our own client so that it lives at least
+// long enough to receive the result of unpacking.
+// 
+//
+// NOTE: This class is rather huge at the moment because it is handling all
+// types of installation (external, autoupdate, and manual). In the future,
+// manual installation will probably pulled out of it.
+//
+// TODO(aa): Pull out the manual installation bits.
+// TODO(aa): Pull out a frontend interface for testing?
+class CrxInstaller : public SandboxedExtensionUnpackerClient {
+ public:
+  CrxInstaller(const FilePath& crx_path,
+               const FilePath& install_directory,
+               Extension::Location install_source,
+               const std::string& expected_id,
+               bool extensions_enabled,
+               bool is_from_gallery,
+               bool show_prompts,
+               bool delete_crx,
+               MessageLoop* file_loop,
+               ExtensionsService* frontend);
+  ~CrxInstaller() {
+    // This is only here for debugging purposes, as a convenient place to set
+    // breakpoints.
+  }
+
+ private:
+  // SandboxedExtensionUnpackerClient
+  virtual void OnUnpackFailure(const std::string& error_message);
+  virtual void OnUnpackSuccess(const FilePath& temp_dir,
+                               const FilePath& extension_dir,
+                               Extension* extension);
+
+  // Confirm with the user that it is OK to install this extension.
+  //
+  // Note that this runs on the file thread. It happens to be OK to do this on
+  // Windows and Mac, and although ugly, we leave it because this is all getting
+  // pulled out soon, anyway.
+  //
+  // TODO(aa): Pull this up, closer to the UI layer.
+  bool ConfirmInstall();
+
+  // Runs on File thread. Install the unpacked extension into the profile and
+  // notify the frontend.
+  void CompleteInstall();
+
+  // Result reporting.
+  void ReportFailureFromFileThread(const std::string& error);
+  void ReportFailureFromUIThread(const std::string& error);
+  void ReportOverinstallFromFileThread();
+  void ReportSuccessFromFileThread();
+
+  // The crx file we're installing.
+  FilePath crx_path_;
+
+  // The directory extensions are installed to.
+  FilePath install_directory_;
+
+  // The location the installation came from (bundled with Chromium, registry,
+  // manual install, etc). This metadata is saved with the installation if
+  // successful.
+  Extension::Location install_source_;
+
+  // For updates and external installs we have an ID we're expecting the
+  // extension to contain.
+  std::string expected_id_;
+
+  // Whether extension installation is set. We can't just check this before
+  // trying to install because themes are special-cased to always be allowed.
+  bool extensions_enabled_;
+
+  // Whether this installation was initiated from the gallery. We trust it more
+  // and have special UI if it was.
+  bool is_from_gallery_;
+
+  // Whether we shoud should show prompts. This is sometimes false for testing
+  // and autoupdate.
+  bool show_prompts_;
+
+  // Whether we're supposed to delete the source crx file on destruction.
+  bool delete_crx_;
+
+  // The message loop to use for file IO.
+  MessageLoop* file_loop_;
+
+  // The message loop the UI is running on.
+  MessageLoop* ui_loop_;
+
+  // The extension we're installing. We own this and either pass it off to
+  // ExtensionsService on success, or delete it on failure.
+  scoped_ptr<Extension> extension_;
+
+  // The temp directory extension resources were unpacked to. We own this and
+  // must delete it when we are done with it.
+  FilePath temp_dir_;
+
+  // The frontend we will report results back to.
+  scoped_refptr<ExtensionsService> frontend_;
+
+  // The root of the unpacked extension directory. This is a subdirectory of
+  // temp_dir_, so we don't have to delete it explicitly.
+  FilePath unpacked_extension_root_;
+
+  // The unpacker we will use to unpack the extension.
+  SandboxedExtensionUnpacker* unpacker_;
+
+  DISALLOW_COPY_AND_ASSIGN(CrxInstaller);
+};
+
+#endif  // CHROME_BROWSER_EXTENSIONS_CRX_INSTALLER_H_