Allow component installers to specify a map of installer attributes.

components/update_client/update_client.h

 // Copyright 2015 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 COMPONENTS_UPDATE_CLIENT_UPDATE_CLIENT_H_
 #define COMPONENTS_UPDATE_CLIENT_UPDATE_CLIENT_H_
 
 #include <stdint.h>
 
+#include <map>
 #include <memory>
 #include <string>
 #include <vector>
 
 #include "base/callback_forward.h"
 #include "base/memory/ref_counted.h"
 #include "base/version.h"
 
 // The UpdateClient class is a facade with a simple interface. The interface
 // exposes a few APIs to install a CRX or update a group of CRXs.
@@ skipping 155 matching lines @@
   // be uninstalled from disk. Returns true if uninstallation is supported,
   // and false otherwise.
   virtual bool Uninstall() = 0;
 
  protected:
   friend class base::RefCountedThreadSafe<CrxInstaller>;
 
   virtual ~CrxInstaller() {}
 };
 
+// A dictionary of installer-specific, arbitrary name-value pairs, which
+// may be used in the update checks requests.
+using InstallerAttributes = std::map<std::string, std::string>;
+
 // TODO(sorin): this structure will be refactored soon.
 struct CrxComponent {
   CrxComponent();
   CrxComponent(const CrxComponent& other);
   ~CrxComponent();
 
   // SHA256 hash of the CRX's public key.
   std::vector<uint8_t> pk_hash;
   scoped_refptr<CrxInstaller> installer;
 
   // The current version if the CRX is updated. Otherwise, "0" or "0.0" if
   // the CRX is installed.
   Version version;
 
   std::string fingerprint;  // Optional.
   std::string name;         // Optional.
-  std::string ap;           // Optional. Must match ^[-+_=a-zA-Z0-9]{0,256}$
+
+  // Optional.
+  // Valid values for the name part of an attribute match
+  // ^[-_a-zA-Z0-9]{1,256}$ and valid values the value part of an attribute
+  // match ^[-.,;+_=a-zA-Z0-9]{0,256}$ .
+  InstallerAttributes installer_attributes;
 
   // Specifies that the CRX can be background-downloaded in some cases.
   // The default for this value is |true|.
   bool allows_background_download;
 
   // Specifies that the update checks and pings associated with this component
   // require confidentiality. The default for this value is |true|. As a side
   // note, the confidentiality of the downloads is enforced by the server,
   // which only returns secure download URLs in this case.
   bool requires_network_encryption;
@@ skipping 120 matching lines @@
 scoped_refptr<UpdateClient> UpdateClientFactory(
     const scoped_refptr<Configurator>& config);
 
 // This must be called prior to the construction of any Configurator that
 // contains a PrefService.
 void RegisterPrefs(PrefRegistrySimple* registry);
 
 }  // namespace update_client
 
 #endif  // COMPONENTS_UPDATE_CLIENT_UPDATE_CLIENT_H_