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
|
// 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.
#ifndef EXTENSIONS_COMMON_FEATURE_SWITCH_H_
#define EXTENSIONS_COMMON_FEATURE_SWITCH_H_
#include <string>
#include <vector>
#include "base/macros.h"
namespace base {
class CommandLine;
}
namespace extensions {
// A switch that can turn a feature on or off. Typically controlled via
// command-line switches but can be overridden, e.g., for testing.
// Can also integrate with Finch's field trials.
// A note about priority:
// 1. If an override is present, the override state will be used.
// 2. If there is no switch name, the default value will be used. This is
// because certain features are specifically designed *not* to be able to
// be turned off via command-line, so we can't consult it (or, by extension,
// the finch config).
// 3. If there is a switch name, and the switch is present in the command line,
// the command line value will be used.
// 4. If there are field trials associated with the feature, and the machine
// is in the "Enabled" group for all field trials, then the feature is
// enabled. If the machine is in the "Disabled" group for any field trials,
// the feature is disabled.
// 5. Otherwise, the default value is used.
class FeatureSwitch {
public:
static FeatureSwitch* easy_off_store_install();
static FeatureSwitch* force_dev_mode_highlighting();
static FeatureSwitch* prompt_for_external_extensions();
static FeatureSwitch* error_console();
static FeatureSwitch* enable_override_bookmarks_ui();
static FeatureSwitch* extension_action_redesign();
static FeatureSwitch* scripts_require_action();
static FeatureSwitch* embedded_extension_options();
static FeatureSwitch* trace_app_source();
static FeatureSwitch* media_router();
static FeatureSwitch* media_router_with_cast_extension();
enum DefaultValue {
DEFAULT_ENABLED,
DEFAULT_DISABLED
};
enum OverrideValue {
OVERRIDE_NONE,
OVERRIDE_ENABLED,
OVERRIDE_DISABLED
};
// A temporary override for the switch value.
class ScopedOverride {
public:
ScopedOverride(FeatureSwitch* feature, bool override_value);
~ScopedOverride();
private:
FeatureSwitch* feature_;
FeatureSwitch::OverrideValue previous_value_;
DISALLOW_COPY_AND_ASSIGN(ScopedOverride);
};
// |switch_name| can be null, in which case the feature is controlled solely
// by the default and override values.
FeatureSwitch(const char* switch_name,
DefaultValue default_value);
FeatureSwitch(const char* switch_name,
const char* field_trial_name,
DefaultValue default_value);
FeatureSwitch(const char* switch_name,
const std::vector<std::string>& required_field_trials,
DefaultValue default_value);
FeatureSwitch(const base::CommandLine* command_line,
const char* switch_name,
DefaultValue default_value);
FeatureSwitch(const base::CommandLine* command_line,
const char* switch_name,
const std::vector<std::string>& required_field_trials,
DefaultValue default_value);
~FeatureSwitch();
// Consider using ScopedOverride instead.
void SetOverrideValue(OverrideValue value);
OverrideValue GetOverrideValue() const;
bool IsEnabled() const;
private:
std::string GetLegacyEnableFlag() const;
std::string GetLegacyDisableFlag() const;
const base::CommandLine* command_line_;
const char* switch_name_;
std::vector<std::string> required_field_trials_;
bool default_value_;
OverrideValue override_value_;
DISALLOW_COPY_AND_ASSIGN(FeatureSwitch);
};
} // namespace extensions
#endif // EXTENSIONS_COMMON_FEATURE_SWITCH_H_
|
