1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192 |
- // Copyright 2014 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_UTILS_H_
- #define COMPONENTS_UPDATE_CLIENT_UTILS_H_
- #include <string>
- #include <utility>
- #include <vector>
- #include "base/callback_forward.h"
- #include "base/memory/ref_counted.h"
- #include "components/update_client/update_client.h"
- class GURL;
- namespace base {
- class FilePath;
- class Value;
- }
- namespace update_client {
- class Component;
- struct CrxComponent;
- // Defines a name-value pair that represents an installer attribute.
- // Installer attributes are component-specific metadata, which may be serialized
- // in an update check request.
- using InstallerAttribute = std::pair<std::string, std::string>;
- // Returns true if the |component| contains a valid differential update url.
- bool HasDiffUpdate(const Component& component);
- // Returns true if the |status_code| represents a server error 5xx.
- bool IsHttpServerError(int status_code);
- // Deletes the file and its directory, if the directory is empty. If the
- // parent directory is not empty, the function ignores deleting the directory.
- // Returns true if the file and the empty directory are deleted.
- bool DeleteFileAndEmptyParentDirectory(const base::FilePath& filepath);
- // Returns the component id of the |component|. The component id is either the
- // app_id, if the member is set, or a string value derived from the public
- // key hash with a format similar with the format of an extension id.
- std::string GetCrxComponentID(const CrxComponent& component);
- // Returns a CRX id from a public key hash.
- std::string GetCrxIdFromPublicKeyHash(const std::vector<uint8_t>& pk_hash);
- // Returns true if the actual SHA-256 hash of the |filepath| matches the
- // |expected_hash|.
- bool VerifyFileHash256(const base::FilePath& filepath,
- const std::string& expected_hash);
- // Returns true if the |brand| parameter matches ^[a-zA-Z]{4}?$ .
- bool IsValidBrand(const std::string& brand);
- // Returns true if the name part of the |attr| parameter matches
- // ^[-_a-zA-Z0-9]{1,256}$ and the value part of the |attr| parameter
- // matches ^[-.,;+_=$a-zA-Z0-9]{0,256}$ .
- bool IsValidInstallerAttribute(const InstallerAttribute& attr);
- // Removes the unsecure urls in the |urls| parameter.
- void RemoveUnsecureUrls(std::vector<GURL>* urls);
- // Adapter function for the old definitions of CrxInstaller::Install until the
- // component installer code is migrated to use a Result instead of bool.
- CrxInstaller::Result InstallFunctionWrapper(
- base::OnceCallback<bool()> callback);
- // Deserializes the CRX manifest. The top level must be a dictionary.
- // Returns a base::Value object of type dictionary on success, or another type
- // on failure.
- base::Value ReadManifest(const base::FilePath& unpack_path);
- // Converts a custom, specific installer error (and optionally extended error)
- // to an installer result.
- template <typename T>
- CrxInstaller::Result ToInstallerResult(const T& error, int extended_error = 0) {
- static_assert(std::is_enum<T>::value,
- "Use an enum class to define custom installer errors");
- return CrxInstaller::Result(
- static_cast<int>(update_client::InstallError::CUSTOM_ERROR_BASE) +
- static_cast<int>(error),
- extended_error);
- }
- } // namespace update_client
- #endif // COMPONENTS_UPDATE_CLIENT_UTILS_H_
|