Home | History | Annotate | Download | only in util
      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
      3 // found in the LICENSE file.
      4 
      5 #include "chrome/installer/util/util_constants.h"
      6 
      7 namespace installer {
      8 
      9 namespace switches {
     10 
     11 // Whether to set Chrome to launch at computer startup.
     12 const char kAutoLaunchChrome[] = "auto-launch-chrome";
     13 
     14 // Install Chrome.
     15 // Currently this is only required when used in combination with kMultiInstall.
     16 const char kChrome[] = "chrome";
     17 
     18 // Install Chrome App Host. This is now interpreted as kChromeAppLauncher.
     19 // TODO(huangs): Remove by M27.
     20 const char kChromeAppHostDeprecated[] = "app-host";
     21 
     22 // Install Chrome App Launcher, which subsumes Chrome App Host, i.e.,
     23 // App Launcher install converts App Host to App Launcher, and all subsequent
     24 // App Host updates/uninstalls become App Launcher updates/uninstalls.
     25 const char kChromeAppLauncher[] = "app-launcher";
     26 
     27 // Install Chrome Frame.
     28 const char kChromeFrame[] = "chrome-frame";
     29 
     30 // Run the installer for Chrome SxS.
     31 const char kChromeSxS[] = "chrome-sxs";
     32 
     33 // Create shortcuts for this user to point to a system-level install (which
     34 // must already be installed on the machine). The shortcuts created will
     35 // match the preferences of the already present system-level install as such
     36 // this option is not compatible with any other installer options.
     37 const char kConfigureUserSettings[] = "configure-user-settings";
     38 
     39 // The version number of an update containing critical fixes, for which an
     40 // in-use Chrome should be restarted ASAP.
     41 const char kCriticalUpdateVersion[] = "critical-update-version";
     42 
     43 // Delete user profile data. This param is useful only when specified with
     44 // kUninstall, otherwise it is silently ignored.
     45 const char kDeleteProfile[] = "delete-profile";
     46 
     47 // Disable logging
     48 const char kDisableLogging[] = "disable-logging";
     49 
     50 // Prevent installer from launching Chrome after a successful first install.
     51 const char kDoNotLaunchChrome[] = "do-not-launch-chrome";
     52 
     53 // Prevents installer from writing the Google Update key that causes Google
     54 // Update to launch Chrome after a first install.
     55 const char kDoNotRegisterForUpdateLaunch[] =
     56     "do-not-register-for-update-launch";
     57 
     58 // By default we remove all shared (between users) files, registry entries etc
     59 // during uninstall. If this option is specified together with kUninstall option
     60 // we do not clean up shared entries otherwise this option is ignored.
     61 const char kDoNotRemoveSharedItems[] = "do-not-remove-shared-items";
     62 
     63 // Enable logging at the error level. This is the default behavior.
     64 const char kEnableLogging[] = "enable-logging";
     65 
     66 // Ensures that Google Update is present at the current level of installation.
     67 const char kEnsureGoogleUpdatePresent[] = "ensure-google-update-present";
     68 
     69 // Same as kConfigureUserSettings above; except the checks to know whether
     70 // first run already occured are bypassed and shortcuts are created either way
     71 // (kConfigureUserSettings also needs to be on the command-line for this to have
     72 // any effect).
     73 const char kForceConfigureUserSettings[] = "force-configure-user-settings";
     74 
     75 // If present, setup will uninstall chrome without asking for any
     76 // confirmation from user.
     77 const char kForceUninstall[] = "force-uninstall";
     78 
     79 // Specify the path to the compressed Chrome archive for install. If not
     80 // specified, chrome.packed.7z or chrome.7z in the same directory as setup.exe
     81 // is used (the packed file is preferred; see kUncompressedArchive to force use
     82 // of an uncompressed archive).
     83 const char kInstallArchive[] = "install-archive";
     84 
     85 // Specify the file path of Chrome master preference file.
     86 const char kInstallerData[] = "installerdata";
     87 
     88 // If present, specify file path to write logging info.
     89 const char kLogFile[] = "log-file";
     90 
     91 // Register Chrome as default browser on the system. Usually this will require
     92 // that setup is running as admin. If running as admin we try to register
     93 // as default browser at system level, if running as non-admin we try to
     94 // register as default browser only for the current user.
     95 const char kMakeChromeDefault[] = "make-chrome-default";
     96 
     97 // Tells installer to expect to be run as a subsidiary to an MSI.
     98 const char kMsi[] = "msi";
     99 
    100 // Tells installer to install multiple products specified on the command line.
    101 // (e.g. Chrome Frame, Chrome)
    102 const char kMultiInstall[] = "multi-install";
    103 
    104 // Useful only when used with --update-setup-exe, otherwise ignored. It
    105 // specifies the full path where updated setup.exe will be stored.
    106 const char kNewSetupExe[] = "new-setup-exe";
    107 
    108 // Notify the installer that the OS has been upgraded.
    109 const char kOnOsUpgrade[] = "on-os-upgrade";
    110 
    111 // Determines whether or not EULA has been accepted at some point. Returns via
    112 // exit code: 0 if EULA not accepted, 1 if EULA accepted, and E_FAIL on error.
    113 const char kQueryEULAAcceptance[] = "query-eula-acceptance";
    114 
    115 // Requests that setup attempt to reenable autoupdates for Chrome.
    116 const char kReenableAutoupdates[] = "reenable-autoupdates";
    117 
    118 // Register Chrome as a valid browser on the current system. This option
    119 // requires that setup.exe is running as admin. If this option is specified,
    120 // options kInstallArchive and kUninstall are ignored.
    121 const char kRegisterChromeBrowser[] = "register-chrome-browser";
    122 
    123 // Used by the installer to forward the registration suffix of the
    124 // (un)installation in progress when launching an elevated setup.exe to finish
    125 // registration work.
    126 const char kRegisterChromeBrowserSuffix[] = "register-chrome-browser-suffix";
    127 
    128 // Specify the path to the dev build of chrome.exe the user wants to install
    129 // (register and install Start menu shortcut for) on the system. This will
    130 // always result in a user-level install and will make this install default
    131 // browser.
    132 const char kRegisterDevChrome[] = "register-dev-chrome";
    133 
    134 // Switch to allow an extra URL protocol to be registered. This option is used
    135 // in conjunction with kRegisterChromeBrowser to specify an extra protocol
    136 // in addition to the standard set of protocols.
    137 const char kRegisterURLProtocol[] = "register-url-protocol";
    138 
    139 // Renames chrome.exe to old_chrome.exe and renames new_chrome.exe to chrome.exe
    140 // to support in-use updates. Also deletes opv key.
    141 const char kRenameChromeExe[] = "rename-chrome-exe";
    142 
    143 // Removes Chrome registration from current machine. Requires admin rights.
    144 const char kRemoveChromeRegistration[] = "remove-chrome-registration";
    145 
    146 // When we try to relaunch setup.exe as admin on Vista, we append this command
    147 // line flag so that we try the launch only once.
    148 const char kRunAsAdmin[] = "run-as-admin";
    149 
    150 // Combined with --uninstall, signals to setup.exe that this uninstall was
    151 // triggered by a self-destructing Chrome.
    152 const char kSelfDestruct[] = "self-destruct";
    153 
    154 // Install Chrome to system wise location. The default is per user install.
    155 const char kSystemLevel[] = "system-level";
    156 
    157 // Signals to setup.exe that it should trigger the active setup command.
    158 const char kTriggerActiveSetup[] = "trigger-active-setup";
    159 
    160 // If present, setup will uninstall chrome.
    161 const char kUninstall[] = "uninstall";
    162 
    163 // Also see --new-setup-exe. This command line option specifies a diff patch
    164 // that setup.exe will apply to itself and store the resulting binary in the
    165 // path given by --new-setup-exe.
    166 const char kUpdateSetupExe[] = "update-setup-exe";
    167 
    168 // Use the given uncompressed chrome.7z archive as the source of files to
    169 // install.
    170 const char kUncompressedArchive[] = "uncompressed-archive";
    171 
    172 // Enable verbose logging (info level).
    173 const char kVerboseLogging[] = "verbose-logging";
    174 
    175 // Show the embedded EULA dialog.
    176 const char kShowEula[] = "show-eula";
    177 
    178 // Show the embedded EULA dialog, relaunch metro Chrome on acceptance.
    179 const char kShowEulaForMetro[] = "show-eula-for-metro";
    180 
    181 // Perform the inactive user toast experiment.
    182 const char kInactiveUserToast[] = "inactive-user-toast";
    183 
    184 // User toast experiment switch from system context to user context.
    185 const char kSystemLevelToast[] = "system-level-toast";
    186 
    187 // The group this experiment belongs to.
    188 const char kExperimentGroup[] = "experiment-group";
    189 
    190 // A handle value of the key to write the results of the toast experiment
    191 // to. See DuplicateGoogleUpdateSystemClientKey for details.
    192 const char kToastResultsKey[] = "toast-results-key";
    193 
    194 // Applies a binary patch to a file. The input, patch, and the output file are
    195 // specified as command line arguments following the --patch switch.
    196 // Ex: --patch=courgette --input_file='input' --patch_file='patch'
    197 //        --output_file='output'
    198 const char kPatch[] = "patch";
    199 const char kInputFile[] = "input-file";
    200 const char kPatchFile[] = "patch-file";
    201 const char kOutputFile[] = "output-file";
    202 
    203 }  // namespace switches
    204 
    205 // The Active Setup executable will be an identical copy of setup.exe; this is
    206 // necessary because Windows' installer detection heuristics (which include
    207 // things like process name being "setup.exe") will otherwise force elevation
    208 // for non-admin users when setup.exe is launched. This is mitigated by adding
    209 // requestedExecutionLevel="asInvoker" to setup.exe's manifest on Vista+, but
    210 // there is no such manifest entry on Windows XP (which results in
    211 // crbug.com/166473).
    212 // TODO(gab): Rename setup.exe itself altogether and use the same binary for
    213 // Active Setup.
    214 const wchar_t kActiveSetupExe[] = L"chrmstp.exe";
    215 const wchar_t kAppLauncherGuid[] = L"{FDA71E6F-AC4C-4a00-8B70-9958A68906BF}";
    216 const wchar_t kChromeAppHostExe[] = L"app_host.exe";
    217 const wchar_t kChromeDll[] = L"chrome.dll";
    218 const wchar_t kChromeChildDll[] = L"chrome_child.dll";
    219 const wchar_t kChromeExe[] = L"chrome.exe";
    220 const wchar_t kChromeFrameDll[] = L"npchrome_frame.dll";
    221 const wchar_t kChromeFrameHelperDll[] = L"chrome_frame_helper.dll";
    222 const wchar_t kChromeFrameHelperExe[] = L"chrome_frame_helper.exe";
    223 const wchar_t kChromeFrameHelperWndClass[] = L"ChromeFrameHelperWindowClass";
    224 const wchar_t kChromeLauncherExe[] = L"chrome_launcher.exe";
    225 const wchar_t kChromeMetroDll[] = L"metro_driver.dll";
    226 const wchar_t kChromeNewExe[] = L"new_chrome.exe";
    227 const wchar_t kChromeOldExe[] = L"old_chrome.exe";
    228 const wchar_t kCmdOnOsUpgrade[] = L"on-os-upgrade";
    229 const wchar_t kCmdQueryEULAAcceptance[] = L"query-eula-acceptance";
    230 const wchar_t kCmdQuickEnableApplicationHost[] =
    231     L"quick-enable-application-host";
    232 const wchar_t kCmdQuickEnableCf[] = L"quick-enable-cf";
    233 const wchar_t kDelegateExecuteExe[] = L"delegate_execute.exe";
    234 const wchar_t kEULASentinelFile[] = L"EULA Accepted";
    235 const wchar_t kGoogleChromeInstallSubDir1[] = L"Google";
    236 const wchar_t kGoogleChromeInstallSubDir2[] = L"Chrome";
    237 const wchar_t kInstallBinaryDir[] = L"Application";
    238 const wchar_t kInstallerDir[] = L"Installer";
    239 const wchar_t kInstallTempDir[] = L"Temp";
    240 const wchar_t kLnkExt[] = L".lnk";
    241 const wchar_t kNaClExe[] = L"nacl64.exe";
    242 const wchar_t kSetupExe[] = L"setup.exe";
    243 const wchar_t kSxSSuffix[] = L" SxS";
    244 const wchar_t kUninstallStringField[] = L"UninstallString";
    245 const wchar_t kUninstallArgumentsField[] = L"UninstallArguments";
    246 const wchar_t kUninstallDisplayNameField[] = L"DisplayName";
    247 const char kUninstallMetricsName[] = "uninstall_metrics";
    248 const wchar_t kUninstallInstallationDate[] = L"installation_date";
    249 const wchar_t kInstallerError[] = L"InstallerError";
    250 const wchar_t kInstallerExtraCode1[] = L"InstallerExtraCode1";
    251 const wchar_t kInstallerResult[] = L"InstallerResult";
    252 const wchar_t kInstallerResultUIString[] = L"InstallerResultUIString";
    253 const wchar_t kInstallerSuccessLaunchCmdLine[] =
    254     L"InstallerSuccessLaunchCmdLine";
    255 
    256 const wchar_t kOptionMultiInstall[] = L"multi-install";
    257 
    258 // Chrome channel display names.
    259 const wchar_t kChromeChannelUnknown[] = L"unknown";
    260 const wchar_t kChromeChannelCanary[] = L"canary";
    261 const wchar_t kChromeChannelDev[] = L"dev";
    262 const wchar_t kChromeChannelBeta[] = L"beta";
    263 const wchar_t kChromeChannelStable[] = L"";
    264 const wchar_t kChromeChannelStableExplicit[] = L"stable";
    265 
    266 const size_t kMaxAppModelIdLength = 64U;
    267 
    268 const char kCourgette[] = "courgette";
    269 const char kBsdiff[] = "bsdiff";
    270 
    271 }  // namespace installer
    272