1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
// Copyright (c) 2012 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 a class that contains various method related to branding.
#ifndef CHROME_INSTALLER_UTIL_BROWSER_DISTRIBUTION_H_
#define CHROME_INSTALLER_UTIL_BROWSER_DISTRIBUTION_H_
#include <string>
#include "base/basictypes.h"
#include "base/file_path.h"
#include "base/string16.h"
#include "base/version.h"
#include "chrome/installer/util/util_constants.h"
#if defined(OS_WIN)
#include <windows.h> // NOLINT
#endif
namespace installer {
class Product;
}
class BrowserDistribution {
public:
enum Type {
CHROME_BROWSER,
CHROME_FRAME,
CHROME_BINARIES,
CHROME_APP_HOST,
NUM_TYPES
};
// Flags to control what to show in the UserExperiment dialog.
enum ToastUIflags {
kUninstall = 1, // Uninstall radio button.
kDontBugMeAsButton = 2, // Don't bug me is a button, not a radio button.
kWhyLink = 4, // Has the 'why I am seeing this' link.
kMakeDefault = 8 // Has the 'make it default' checkbox.
};
// A struct for communicating what a UserExperiment contains. In these
// experiments we show toasts to the user if they are inactive for a certain
// amount of time.
struct UserExperiment {
string16 prefix; // The experiment code prefix for this experiment,
// also known as the 'TV' part in 'TV80'.
int flavor; // The flavor index for this experiment.
int heading; // The heading resource ID to use for this experiment.
int flags; // See ToastUIFlags above.
int control_group; // Size of the control group (in percentages). Control
// group is the group that qualifies for the
// experiment but does not participate.
};
virtual ~BrowserDistribution() {}
static BrowserDistribution* GetDistribution();
static BrowserDistribution* GetSpecificDistribution(Type type);
Type GetType() const { return type_; }
virtual void DoPostUninstallOperations(const Version& version,
const FilePath& local_data_path,
const string16& distribution_data);
virtual string16 GetAppGuid();
// Returns the unsuffixed application name of this program.
// This is the base of the name registered with Default Programs on Windows.
// IMPORTANT: This should only be called by the installer which needs to make
// decisions on the suffixing of the upcoming install, not by external callers
// at run-time.
virtual string16 GetBaseAppName();
// Returns the localized name of the program.
virtual string16 GetAppShortCutName();
virtual string16 GetAlternateApplicationName();
// Returns the unsuffixed appid of this program.
// The AppUserModelId is a property of Windows programs.
// IMPORTANT: This should only be called by ShellUtil::GetAppId as the appid
// should be suffixed in all scenarios.
virtual string16 GetBaseAppId();
virtual string16 GetInstallSubDir();
virtual string16 GetPublisherName();
virtual string16 GetAppDescription();
virtual string16 GetLongAppDescription();
virtual std::string GetSafeBrowsingName();
virtual string16 GetStateKey();
virtual string16 GetStateMediumKey();
virtual string16 GetStatsServerURL();
virtual std::string GetNetworkStatsServer() const;
virtual std::string GetHttpPipeliningTestServer() const;
#if defined(OS_WIN)
virtual string16 GetDistributionData(HKEY root_key);
#endif
virtual string16 GetUninstallLinkName();
virtual string16 GetUninstallRegPath();
virtual string16 GetVersionKey();
virtual bool CanSetAsDefault();
virtual bool CanCreateDesktopShortcuts();
// Returns the executable filename (not path) that contains the product icon.
virtual string16 GetIconFilename();
// Returns the index of the icon for the product, inside the file specified by
// GetIconFilename().
virtual int GetIconIndex();
virtual bool GetChromeChannel(string16* channel);
// Returns true if the distribution includes a DelegateExecute verb handler,
// and provides the CommandExecuteImpl class UUID if |handler_class_uuid| is
// non-NULL.
virtual bool GetCommandExecuteImplClsid(string16* handler_class_uuid);
virtual void UpdateInstallStatus(bool system_install,
installer::ArchiveType archive_type,
installer::InstallStatus install_status);
// Gets the experiment details for a given language-brand combo. If |flavor|
// is -1, then a flavor will be selected at random. |experiment| is the struct
// you want to write the experiment information to. Returns false if no
// experiment details could be gathered.
virtual bool GetExperimentDetails(UserExperiment* experiment, int flavor);
// After an install or upgrade the user might qualify to participate in an
// experiment. This function determines if the user qualifies and if so it
// sets the wheels in motion or in simple cases does the experiment itself.
virtual void LaunchUserExperiment(const FilePath& setup_path,
installer::InstallStatus status,
const Version& version,
const installer::Product& product,
bool system_level);
// The user has qualified for the inactive user toast experiment and this
// function just performs it.
virtual void InactiveUserToastExperiment(int flavor,
const string16& experiment_group,
const installer::Product& installation,
const FilePath& application_path);
protected:
explicit BrowserDistribution(Type type);
template<class DistributionClass>
static BrowserDistribution* GetOrCreateBrowserDistribution(
BrowserDistribution** dist);
const Type type_;
private:
BrowserDistribution();
DISALLOW_COPY_AND_ASSIGN(BrowserDistribution);
};
#endif // CHROME_INSTALLER_UTIL_BROWSER_DISTRIBUTION_H_
|
