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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
// Copyright (c) 2006-2008 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 CHROME_BROWSER_FIRST_RUN_H_
#define CHROME_BROWSER_FIRST_RUN_H_
#include "base/basictypes.h"
#include "base/command_line.h"
#include "chrome/browser/browser_process_impl.h"
class Profile;
// This class contains the chrome first-run installation actions needed to
// fully test the custom installer. It also contains the opposite actions to
// execute during uninstall. When the first run UI is ready we won't
// do the actions unconditionally. Currently the only action is to create a
// desktop shortcut.
//
// The way we detect first-run is by looking at a 'sentinel' file.
// If it does not exists we understand that we need to do the first time
// install work for this user. After that the sentinel file is created.
class FirstRun {
public:
// Returns true if this is the first time chrome is run for this user.
static bool IsChromeFirstRun();
// Creates the desktop shortcut to chrome for the current user. Returns
// false if it fails. It will overwrite the shortcut if it exists.
static bool CreateChromeDesktopShortcut();
// Creates the quick launch shortcut to chrome for the current user. Returns
// false if it fails. It will overwrite the shortcut if it exists.
static bool CreateChromeQuickLaunchShortcut();
// Creates the sentinel file that signals that chrome has been configured.
static bool CreateSentinel();
// Removes the sentinel file created in ConfigDone(). Returns false if the
// sentinel file could not be removed.
static bool RemoveSentinel();
// Imports settings in a separate process. It spawns a second dedicated
// browser process that just does the import with the import progress UI.
static bool ImportSettings(Profile* profile, int browser,
int items_to_import, HWND parent_window);
// Import browser items with a progress UI. The browser and the items to
// import are encoded int the command line. This function is paired with
// FirstRun::ImportSettings().
static int ImportWithUI(Profile* profile, const CommandLine& cmdline);
// These are the possible results of calling ProcessMasterPreferences.
enum MasterPrefResult {
MASTER_PROFILE_NOT_FOUND = 0,
MASTER_PROFILE_ERROR = 1,
MASTER_PROFILE_SHOW_EULA = 2,
MASTER_PROFILE_NO_FIRST_RUN_UI = 4
};
// The master preferences is a JSON file with the same entries as the
// 'Default\Preferences' file. This function locates this file from
// master_pref_path or if that path is empty from the default location
// which is '<path to chrome.exe>\master_preferences', and process it
// so it becomes the default preferences in profile pointed by user_data_dir.
//
// Since this function destroys any existing prefs file, it is meant to be
// invoked only on first run. The current use of this function is to set the
// following 3 properties:
// - default home page
// - show bookmark bar
// - show home page button
//
// A prototypical 'master_preferences' file looks like this:
//
// {
// "browser": {
// "show_home_button": true
// },
// "bookmark_bar": {
// "show_on_all_tabs": true
// },
// "homepage": "http://slashdot.org",
// "homepage_is_newtabpage": false
// }
//
// A reserved "distribution" entry in the file will be used to group
// other installation properties such as the EULA display. This entry will
// be ignored at other times.
// Currently only the following return values are used:
// MASTER_PROFILE_NOT_FOUND : Typical outcome for organic installs.
// MASTER_PROFILE_ERROR : A critical error processing the master profile.
// MASTER_PROFILE_SHOW_FIRST_RUN_UI : master profile processed ok.
static MasterPrefResult ProcessMasterPreferences(
const std::wstring& user_data_dir,
const std::wstring& master_prefs_path);
private:
// This class is for scoping purposes.
DISALLOW_COPY_AND_ASSIGN(FirstRun);
};
// This class contains the actions that need to be performed when an upgrade
// is required. This involves mainly swapping the chrome exe and relaunching
// the new browser.
class Upgrade {
public:
// If the new_chrome.exe exists (placed by the installer then is swapped
// to chrome.exe and the old chrome is renamed to old_chrome.exe. If there
// is no new_chrome.exe or the swap fails the return is false;
static bool SwapNewChromeExeIfPresent();
// Launches chrome again simulating a 'user' launch. If chrome could not
// be launched the return is false.
static bool RelaunchChromeBrowser(const CommandLine& command_line);
};
// A subclass of BrowserProcessImpl that does not have a GoogleURLTracker
// so we don't fetch as we have no IO thread (see bug #1292702).
class FirstRunBrowserProcess : public BrowserProcessImpl {
public:
FirstRunBrowserProcess(CommandLine& command_line)
: BrowserProcessImpl(command_line) {
}
virtual ~FirstRunBrowserProcess() { }
virtual GoogleURLTracker* google_url_tracker() { return NULL; }
private:
DISALLOW_COPY_AND_ASSIGN(FirstRunBrowserProcess);
};
// Show the First Run UI to the user, allowing them to create shortcuts for
// the app, import their bookmarks and other data from another browser into
// |profile| and perhaps some other tasks.
void OpenFirstRunDialog(Profile* profile);
#endif // CHROME_BROWSER_FIRST_RUN_H_
|
