Pulling user experiment code from BrowserDistribution to a new class.

chrome/installer/util/user_experiment.h

+// Copyright 2013 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 files declares a class that contains methods and data to conduct
+// for user expeirments.
+
+#ifndef CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_
+#define CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_
+
+#include "base/string16.h"
+#include "chrome/installer/util/util_constants.h"
+
+class BrowserDistribution;
+class Version;
+
+namespace base {
+class FilePath;
+}
+
+namespace installer {
+
+class Product;
+
+class UserExperiment {

[grt (UTC plus 2), 2013/02/22 16:47:55]

use a namespace (e.g., "user_experiment") to hold a collection of non-member
functions rather than a class of only static methods.

[huangs, 2013/02/22 20:32:37]

Done.

+ public:
+
+  // 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.

[grt (UTC plus 2), 2013/02/22 16:47:55]

nit: trailing comma

[huangs, 2013/02/22 20:32:37]

Done.

+  };
+
+  // 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 ExperimentDetails {
+    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.
+  };
+
+  UserExperiment();
+
+  // Creates 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.
+  static bool CreateExperimentDetails(ExperimentDetails* 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.
+  static void LaunchUserExperiment(const base::FilePath& setup_path,
+                                   InstallStatus status,
+                                   const Version& version,
+                                   const Product& product,
+                                   bool system_level);
+
+  // The user has qualified for the inactive user toast experiment and this
+  // function just performs it.
+  static void InactiveUserToastExperiment(
+      BrowserDistribution* dist,
+      int flavor,
+      const string16& experiment_group,
+      const Product& installation,
+      const base::FilePath& application_path);
+
+};
+
+}  // namespace installer
+
+#endif  // CHROME_INSTALLER_UTIL_USER_EXPERIMENT_H_