blob: 83f49e2e69577db926094dda3f5f9715e5ef5403 [file] [log] [blame]
// Copyright 2016 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.
// This file declares constants that describe specifics of a Chromium-based
// browser's branding and modes of installation.
//
// A browser's brand comprises all identifying markings that distinguish it from
// a browser produced by another party. Chromium has remnants of both the
// Chromium and Google Chrome brands.
//
// Each brand defines one primary install mode for the browser. A brand may
// additionally define one or more secondary install modes (e.g., Google
// Chrome's SxS mode for the canary channel). Install modes are described by
// compile-time instantiations of the `InstallConstants` struct in a brand's
// `kInstallModes` array. Index 0 of this array always describes the primary
// install mode. All other entries describe secondary modes, which are
// distinguished by an install suffix (e.g., " SxS") that appears in file and
// registry paths.
#ifndef CHROME_INSTALL_STATIC_INSTALL_MODES_H_
#define CHROME_INSTALL_STATIC_INSTALL_MODES_H_
#include <string>
#include "chrome/install_static/install_details.h"
// Include the brand-specific values. Each of these must define:
// - enum InstallConstantIndex: named indices of the brand's kInstallModes
// array.
// - NUM_INSTALL_MODES: the total numer of modes (i.e., the numer of items in
// kInstallModes.
// - kUseGoogleUpdateIntegration: true or false indicating whether or not the
// brand uses Chrome's integration with Google Update. Google Chrome does,
// while Chromium does not.
#if defined(GOOGLE_CHROME_BUILD)
#include "chrome/install_static/google_chrome_install_modes.h"
#else
#include "chrome/install_static/chromium_install_modes.h"
#endif
namespace install_static {
// The brand-specific company name to be included as a component of the install
// and user data directory paths. May be empty if no such dir is to be used.
extern const wchar_t kCompanyPathName[];
// The brand-specific product name to be included as a component of the install
// and user data directory paths.
extern const wchar_t kProductPathName[];
// The length, in characters, of kProductPathName not including the terminator.
extern const size_t kProductPathNameLength;
// The GUID with which the brand's multi-install binaries are registered with
// Google Update. Must be empty if the brand does not integrate with Google
// Update.
extern const wchar_t kBinariesAppGuid[];
// The name of the registry key in which data for the brand's multi-install
// binaries are stored. Must be empty if the brand integrates with Google
// Update.
extern const wchar_t kBinariesPathName[];
// A brand's collection of install modes.
extern const InstallConstants kInstallModes[];
// The following convenience functions behave conditionally on whether or not
// the brand uses Chrome's integration with Google Update. For brands that do
// not (e.g., Chromium), they return something like "Software\Chromium" or
// "Software\Chromium Binaries". Otherwise, for brands that do integrate with
// Google Update, they return something like
// "Software\Google\Update\ClientState{Medium}\<guid>" where "<guid>" is either
// |mode|'s appguid or the brand's kBinariesAppGuid.
std::wstring GetClientStateKeyPath(const wchar_t* app_guid);
std::wstring GetBinariesClientStateKeyPath();
std::wstring GetClientStateMediumKeyPath(const wchar_t* app_guid);
std::wstring GetBinariesClientStateMediumKeyPath();
} // namespace install_static
#endif // CHROME_INSTALL_STATIC_INSTALL_MODES_H_