1 // Copyright 2014 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_EXTENSIONS_PENDING_EXTENSION_INFO_H_ 6 #define CHROME_BROWSER_EXTENSIONS_PENDING_EXTENSION_INFO_H_ 7 8 #include <string> 9 10 #include "base/gtest_prod_util.h" 11 #include "base/version.h" 12 #include "extensions/common/manifest.h" 13 #include "url/gurl.h" 14 15 FORWARD_DECLARE_TEST(ExtensionServiceTest, AddPendingExtensionFromSync); 16 17 namespace extensions { 18 class Extension; 19 20 // A pending extension is an extension that hasn't been installed yet 21 // and is intended to be installed in the next auto-update cycle. The 22 // update URL of a pending extension may be blank, in which case a 23 // default one is assumed. 24 // TODO(skerner): Make this class an implementation detail of 25 // PendingExtensionManager, and remove all other users. 26 class PendingExtensionInfo { 27 public: 28 typedef bool (*ShouldAllowInstallPredicate)(const Extension*); 29 30 PendingExtensionInfo(const std::string& id, 31 const std::string& install_parameter, 32 const GURL& update_url, 33 const Version& version, 34 ShouldAllowInstallPredicate should_allow_install, 35 bool is_from_sync, 36 bool install_silently, 37 Manifest::Location install_source, 38 int creation_flags, 39 bool mark_acknowledged, 40 bool remote_install); 41 42 // Required for STL container membership. Should not be used directly. 43 PendingExtensionInfo(); 44 45 ~PendingExtensionInfo(); 46 47 // Consider two PendingExtensionInfos equal if their ids are equal. 48 bool operator==(const PendingExtensionInfo& rhs) const; 49 id()50 const std::string& id() const { return id_; } update_url()51 const GURL& update_url() const { return update_url_; } version()52 const Version& version() const { return version_; } install_parameter()53 const std::string& install_parameter() const { return install_parameter_; } 54 55 // ShouldAllowInstall() returns the result of running constructor argument 56 // |should_allow_install| on an extension. After an extension is unpacked, 57 // this function is run. If it returns true, the extension is installed. 58 // If not, the extension is discarded. This allows creators of 59 // PendingExtensionInfo objects to ensure that extensions meet some criteria 60 // that can only be tested once the extension is unpacked. ShouldAllowInstall(const Extension * extension)61 bool ShouldAllowInstall(const Extension* extension) const { 62 return should_allow_install_(extension); 63 } is_from_sync()64 bool is_from_sync() const { return is_from_sync_; } install_silently()65 bool install_silently() const { return install_silently_; } install_source()66 Manifest::Location install_source() const { return install_source_; } creation_flags()67 int creation_flags() const { return creation_flags_; } mark_acknowledged()68 bool mark_acknowledged() const { return mark_acknowledged_; } remote_install()69 bool remote_install() const { return remote_install_; } 70 71 // Returns -1, 0 or 1 if |this| has lower, equal or higher precedence than 72 // |other|, respectively. "Equal" precedence means that the version and the 73 // install source match. "Higher" precedence means that the version is newer, 74 // or the version matches but the install source has higher priority. 75 // It is only valid to invoke this when the ids match. 76 int CompareTo(const PendingExtensionInfo& other) const; 77 78 private: 79 std::string id_; 80 81 GURL update_url_; 82 Version version_; 83 std::string install_parameter_; 84 85 // When the extension is about to be installed, this function is 86 // called. If this function returns true, the install proceeds. If 87 // this function returns false, the install is aborted. 88 ShouldAllowInstallPredicate should_allow_install_; 89 90 bool is_from_sync_; // This update check was initiated from sync. 91 bool install_silently_; 92 Manifest::Location install_source_; 93 int creation_flags_; 94 bool mark_acknowledged_; 95 bool remote_install_; 96 97 FRIEND_TEST_ALL_PREFIXES(::ExtensionServiceTest, AddPendingExtensionFromSync); 98 }; 99 100 } // namespace extensions 101 102 #endif // CHROME_BROWSER_EXTENSIONS_PENDING_EXTENSION_INFO_H_ 103