install_worker.h revision 5d1f7b1de12d16ceb2c938c56701a3e8bfa558f7
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// This file contains the declarations of the installer functions that build 6// the WorkItemList used to install the application. 7 8#ifndef CHROME_INSTALLER_SETUP_INSTALL_WORKER_H_ 9#define CHROME_INSTALLER_SETUP_INSTALL_WORKER_H_ 10 11#include <windows.h> 12 13#include <vector> 14 15class BrowserDistribution; 16class CommandLine; 17class WorkItemList; 18 19namespace base { 20class FilePath; 21class Version; 22} 23 24namespace installer { 25 26class InstallationState; 27class InstallerState; 28class Product; 29 30// This method adds work items to create (or update) Chrome uninstall entry in 31// either the Control Panel->Add/Remove Programs list or in the Omaha client 32// state key if running under an MSI installer. 33void AddUninstallShortcutWorkItems(const InstallerState& installer_state, 34 const base::FilePath& setup_path, 35 const base::Version& new_version, 36 const Product& product, 37 WorkItemList* install_list); 38 39// Creates Version key for a product (if not already present) and sets the new 40// product version as the last step. If |add_language_identifier| is true, the 41// "lang" value is also set according to the currently selected translation. 42void AddVersionKeyWorkItems(HKEY root, 43 BrowserDistribution* dist, 44 const base::Version& new_version, 45 bool add_language_identifier, 46 WorkItemList* list); 47 48// Helper function for AddGoogleUpdateWorkItems that mirrors oeminstall. 49void AddOemInstallWorkItems(const InstallationState& original_state, 50 const InstallerState& installer_state, 51 WorkItemList* install_list); 52 53// Helper function for AddGoogleUpdateWorkItems that mirrors eulaaccepted. 54void AddEulaAcceptedWorkItems(const InstallationState& original_state, 55 const InstallerState& installer_state, 56 WorkItemList* install_list); 57 58// Adds work items that make registry adjustments for Google Update; namely, 59// copy brand, oeminstall, and eulaaccepted values; and move a usagestats value. 60void AddGoogleUpdateWorkItems(const InstallationState& original_state, 61 const InstallerState& installer_state, 62 WorkItemList* install_list); 63 64// Adds work items that make registry adjustments for stats and crash 65// collection. When a product is installed, Google Update may write a 66// "usagestats" value to Chrome or Chrome Frame's ClientState key. In the 67// multi-install case, both products will consult/modify stats for the binaries' 68// app guid. Consequently, during install and update we will move a 69// product-specific value into the binaries' ClientState key. 70void AddUsageStatsWorkItems(const InstallationState& original_state, 71 const InstallerState& installer_state, 72 WorkItemList* install_list); 73 74// After a successful copying of all the files, this function is called to 75// do a few post install tasks: 76// - Handle the case of in-use-update by updating "opv" (old version) key or 77// deleting it if not required. 78// - Register any new dlls and unregister old dlls. 79// - If this is an MSI install, ensures that the MSI marker is set, and sets 80// it if not. 81// If these operations are successful, the function returns true, otherwise 82// false. 83// |current_version| can be NULL to indicate no Chrome is currently installed. 84bool AppendPostInstallTasks(const InstallerState& installer_state, 85 const base::FilePath& setup_path, 86 const base::Version* current_version, 87 const base::Version& new_version, 88 const base::FilePath& temp_path, 89 WorkItemList* post_install_task_list); 90 91// Builds the complete WorkItemList used to build the set of installation steps 92// needed to lay down one or more installed products. 93// 94// setup_path: Path to the executable (setup.exe) as it will be copied 95// to Chrome install folder after install is complete 96// archive_path: Path to the archive (chrome.7z) as it will be copied 97// to Chrome install folder after install is complete 98// src_path: the path that contains a complete and unpacked Chrome package 99// to be installed. 100// temp_path: the path of working directory used during installation. This path 101// does not need to exist. 102// |current_version| can be NULL to indicate no Chrome is currently installed. 103void AddInstallWorkItems(const InstallationState& original_state, 104 const InstallerState& installer_state, 105 const base::FilePath& setup_path, 106 const base::FilePath& archive_path, 107 const base::FilePath& src_path, 108 const base::FilePath& temp_path, 109 const base::Version* current_version, 110 const base::Version& new_version, 111 WorkItemList* install_list); 112 113// Appends registration or unregistration work items to |work_item_list| for the 114// COM DLLs whose file names are given in |dll_files| and which reside in the 115// path |dll_folder|. 116// |system_level| specifies whether to call the system or user level DLL 117// registration entry points. 118// |do_register| says whether to register or unregister. 119// |may_fail| states whether this is best effort or not. If |may_fail| is true 120// then |work_item_list| will still succeed if the registration fails and 121// no registration rollback will be performed. 122void AddRegisterComDllWorkItems(const base::FilePath& dll_folder, 123 const std::vector<base::FilePath>& dll_files, 124 bool system_level, 125 bool do_register, 126 bool ignore_failures, 127 WorkItemList* work_item_list); 128 129void AddSetMsiMarkerWorkItem(const InstallerState& installer_state, 130 BrowserDistribution* dist, 131 bool set, 132 WorkItemList* work_item_list); 133 134// Called for either installation or uninstallation. This method adds or 135// removes COM registration for a product's DelegateExecute verb handler. 136// If |new_version| is empty, the registrations will point to 137// delegate_execute.exe directly in |target_path|. 138void AddDelegateExecuteWorkItems(const InstallerState& installer_state, 139 const base::FilePath& target_path, 140 const base::Version& new_version, 141 const Product& product, 142 WorkItemList* list); 143 144// Adds Active Setup registration for sytem-level setup to be called by Windows 145// on user-login post-install/update. 146// This method should be called for installation only. 147// |product|: The product being installed. This method is a no-op if this is 148// anything other than system-level Chrome/Chromium. 149void AddActiveSetupWorkItems(const InstallerState& installer_state, 150 const base::FilePath& setup_path, 151 const base::Version& new_version, 152 const Product& product, 153 WorkItemList* list); 154 155// Unregisters the "opv" version of ChromeLauncher from IE's low rights 156// elevation policy. 157void AddDeleteOldIELowRightsPolicyWorkItems( 158 const InstallerState& installer_state, 159 WorkItemList* install_list); 160 161// Utility method currently shared between install.cc and install_worker.cc 162void AppendUninstallCommandLineFlags(const InstallerState& installer_state, 163 const Product& product, 164 CommandLine* uninstall_cmd); 165 166// Refreshes the elevation policy on platforms where it is supported. 167void RefreshElevationPolicy(); 168 169// Adds work items to add or remove the "on-os-upgrade" command to |product|'s 170// version key on the basis of the current operation (represented in 171// |installer_state|). |new_version| is the version of the product(s) 172// currently being installed -- can be empty on uninstall. 173void AddOsUpgradeWorkItems(const InstallerState& installer_state, 174 const base::FilePath& setup_path, 175 const base::Version& new_version, 176 const Product& product, 177 WorkItemList* install_list); 178 179// Adds work items to add or remove the "query-eula-acceptance" command to 180// |product|'s version key on the basis of the current operation (represented 181// in |installer_state|). |new_version| is the version of the product(s) 182// currently being installed -- can be empty on uninstall. 183void AddQueryEULAAcceptanceWorkItems(const InstallerState& installer_state, 184 const base::FilePath& setup_path, 185 const base::Version& new_version, 186 const Product& product, 187 WorkItemList* work_item_list); 188 189// Adds work items to remove "quick-enable-cf" from the multi-installer 190// binaries' version key. 191void AddQuickEnableChromeFrameWorkItems(const InstallerState& installer_state, 192 WorkItemList* work_item_list); 193 194} // namespace installer 195 196#endif // CHROME_INSTALLER_SETUP_INSTALL_WORKER_H_ 197