Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CHROME_BROWSER_ABOUT_FLAGS_H_ | 5 #ifndef CHROME_BROWSER_ABOUT_FLAGS_H_ |
| 6 #define CHROME_BROWSER_ABOUT_FLAGS_H_ | 6 #define CHROME_BROWSER_ABOUT_FLAGS_H_ |
| 7 | 7 |
| 8 #include <map> | 8 #include <map> |
| 9 #include <string> | 9 #include <string> |
| 10 | 10 |
| 11 #include "base/command_line.h" | 11 #include "base/command_line.h" |
| 12 #include "base/string16.h" | 12 #include "base/string16.h" |
| 13 | 13 |
| 14 class PrefService; | 14 class PrefService; |
| 15 | 15 |
| 16 namespace base { | 16 namespace base { |
| 17 class ListValue; | 17 class ListValue; |
| 18 } | 18 } |
| 19 | 19 |
| 20 namespace about_flags { | 20 namespace about_flags { |
| 21 | 21 |
| 22 // Enumeration of OSs. | 22 // Enumeration of OSs. |
| 23 // This is exposed only for testing. | 23 // This is exposed only for testing. |
| 24 enum { kOsMac = 1 << 0, kOsWin = 1 << 1, kOsLinux = 1 << 2 , kOsCrOS = 1 << 3, | 24 enum { kOsMac = 1 << 0, kOsWin = 1 << 1, kOsLinux = 1 << 2 , kOsCrOS = 1 << 3, |
| 25 kOsAndroid = 1 << 4 }; | 25 kOsAndroid = 1 << 4, kOsCrOSOwnerOnly = 1 << 5 }; |
| 26 | 26 |
| 27 // Experiment is used internally by about_flags to describe an experiment (and | 27 // Experiment is used internally by about_flags to describe an experiment (and |
| 28 // for testing). | 28 // for testing). |
| 29 // This is exposed only for testing. | 29 // This is exposed only for testing. |
| 30 struct Experiment { | 30 struct Experiment { |
| 31 enum Type { | 31 enum Type { |
| 32 // An experiment with a single value. This is typically what you want. | 32 // An experiment with a single value. This is typically what you want. |
| 33 SINGLE_VALUE, | 33 SINGLE_VALUE, |
| 34 | 34 |
| 35 // The experiment has multiple values only one of which is ever enabled. | 35 // The experiment has multiple values only one of which is ever enabled. |
| (...skipping 65 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 101 | 101 |
| 102 // Returns the human readable description for the choice at |index|. | 102 // Returns the human readable description for the choice at |index|. |
| 103 string16 DescriptionForChoice(int index) const; | 103 string16 DescriptionForChoice(int index) const; |
| 104 }; | 104 }; |
| 105 | 105 |
| 106 // Reads the Labs |prefs| (called "Labs" for historical reasons) and adds the | 106 // Reads the Labs |prefs| (called "Labs" for historical reasons) and adds the |
| 107 // commandline flags belonging to the active experiments to |command_line|. | 107 // commandline flags belonging to the active experiments to |command_line|. |
| 108 void ConvertFlagsToSwitches(PrefService* prefs, CommandLine* command_line); | 108 void ConvertFlagsToSwitches(PrefService* prefs, CommandLine* command_line); |
| 109 | 109 |
| 110 // Get a list of all available experiments. The caller owns the result. | 110 // Get a list of all available experiments. The caller owns the result. |
| 111 base::ListValue* GetFlagsExperimentsData(PrefService* prefs); | 111 base::ListValue* GetFlagsExperimentsData(PrefService* prefs, bool owner); |
| 112 | 112 |
| 113 // Returns true if one of the experiment flags has been flipped since startup. | 113 // Returns true if one of the experiment flags has been flipped since startup. |
| 114 bool IsRestartNeededToCommitChanges(); | 114 bool IsRestartNeededToCommitChanges(); |
| 115 | 115 |
| 116 // Enables or disables the experiment with id |internal_name|. | 116 // Enables or disables the experiment with id |internal_name|. |
| 117 void SetExperimentEnabled( | 117 void SetExperimentEnabled( |
| 118 PrefService* prefs, const std::string& internal_name, bool enable); | 118 PrefService* prefs, const std::string& internal_name, bool enable); |
| 119 | 119 |
| 120 // Removes all switches that were added to a command line by a previous call to | 120 // Removes all switches that were added to a command line by a previous call to |
| 121 // |ConvertFlagsToSwitches()|. | 121 // |ConvertFlagsToSwitches()|. |
| 122 void RemoveFlagsSwitches( | 122 void RemoveFlagsSwitches( |
| 123 std::map<std::string, CommandLine::StringType>* switch_list); | 123 std::map<std::string, CommandLine::StringType>* switch_list); |
| 124 | 124 |
| 125 // Reset all flags to the default state by clearing all flags. | 125 // Reset all flags to the default state by clearing all flags. |
| 126 void ResetAllFlags(PrefService* prefs); | 126 void ResetAllFlags(PrefService* prefs); |
| 127 | 127 |
| 128 // Returns the value for the current platform. This is one of the values defined | 128 // Returns the value for the current platform. This is one of the values defined |
| 129 // by the OS enum above. | 129 // by the OS enum above. |
|
Nico
2013/04/08 19:24:10
This comment is now no longer true.
pastarmovj
2013/04/09 09:17:49
It still is. I never added a new call to this dire
Nico
2013/04/09 15:38:26
Right, but if the parameter is true this returns "
| |
| 130 // This is exposed only for testing. | 130 // This is exposed only for testing. |
| 131 int GetCurrentPlatform(); | 131 int GetCurrentPlatform(bool owner); |
| 132 | 132 |
| 133 // Sends UMA stats about experimental flag usage. This should be called once per | 133 // Sends UMA stats about experimental flag usage. This should be called once per |
| 134 // startup. | 134 // startup. |
| 135 void RecordUMAStatistics(const PrefService* prefs); | 135 void RecordUMAStatistics(const PrefService* prefs); |
| 136 | 136 |
| 137 namespace testing { | 137 namespace testing { |
| 138 | 138 |
| 139 // Clears internal global state, for unit tests. | 139 // Clears internal global state, for unit tests. |
| 140 void ClearState(); | 140 void ClearState(); |
| 141 | 141 |
| 142 // Sets the list of experiments. Pass in NULL to use the default set. This does | 142 // Sets the list of experiments. Pass in NULL to use the default set. This does |
| 143 // NOT take ownership of the supplied Experiments. | 143 // NOT take ownership of the supplied Experiments. |
| 144 void SetExperiments(const Experiment* e, size_t count); | 144 void SetExperiments(const Experiment* e, size_t count); |
| 145 | 145 |
| 146 // Returns the current set of experiments. | 146 // Returns the current set of experiments. |
| 147 const Experiment* GetExperiments(size_t* count); | 147 const Experiment* GetExperiments(size_t* count); |
| 148 | 148 |
| 149 // Separator used for multi values. Multi values are represented in prefs as | 149 // Separator used for multi values. Multi values are represented in prefs as |
| 150 // name-of-experiment + kMultiSeparator + selected_index. | 150 // name-of-experiment + kMultiSeparator + selected_index. |
| 151 extern const char kMultiSeparator[]; | 151 extern const char kMultiSeparator[]; |
| 152 | 152 |
| 153 } // namespace testing | 153 } // namespace testing |
| 154 | 154 |
| 155 } // namespace about_flags | 155 } // namespace about_flags |
| 156 | 156 |
| 157 #endif // CHROME_BROWSER_ABOUT_FLAGS_H_ | 157 #endif // CHROME_BROWSER_ABOUT_FLAGS_H_ |
| OLD | NEW |