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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
// Copyright (c) 2011 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_SHELL_INTEGRATION_H_
#define CHROME_BROWSER_SHELL_INTEGRATION_H_
#pragma once
#include <string>
#include "base/basictypes.h"
#include "base/memory/ref_counted.h"
#include "base/string16.h"
#include "googleurl/src/gurl.h"
#include "third_party/skia/include/core/SkBitmap.h"
class CommandLine;
class FilePath;
class PrefService;
#if defined(USE_X11)
namespace base {
class Environment;
}
#endif
class ShellIntegration {
public:
// Sets Chrome as default browser (only for current user). Returns false if
// this operation fails.
static bool SetAsDefaultBrowser();
// On Linux, it may not be possible to determine or set the default browser
// on some desktop environments or configurations. So, we use this enum and
// not a plain bool. (Note however that if used like a bool, this enum will
// have reasonable behavior.)
enum DefaultBrowserState {
NOT_DEFAULT_BROWSER = 0,
IS_DEFAULT_BROWSER,
UNKNOWN_DEFAULT_BROWSER
};
// Attempt to determine if this instance of Chrome is the default browser and
// return the appropriate state. (Defined as being the handler for HTTP/HTTPS
// protocols; we don't want to report "no" here if the user has simply chosen
// to open HTML files in a text editor and FTP links with an FTP client.)
static DefaultBrowserState IsDefaultBrowser();
// Returns true if Firefox is likely to be the default browser for the current
// user. This method is very fast so it can be invoked in the UI thread.
static bool IsFirefoxDefaultBrowser();
struct ShortcutInfo {
ShortcutInfo();
~ShortcutInfo();
GURL url;
// If |extension_id| is non-empty, this is short cut is to an extension-app
// and the launch url will be detected at start-up. In this case, |url|
// is still used to generate the app id (windows app id, not chrome app id).
std::string extension_id;
string16 title;
string16 description;
SkBitmap favicon;
bool create_on_desktop;
bool create_in_applications_menu;
// For Windows, this refers to quick launch bar prior to Win7. In Win7,
// this means "pin to taskbar". For Mac/Linux, this could be used for
// Mac dock or the gnome/kde application launcher. However, those are not
// implemented yet.
bool create_in_quick_launch_bar;
};
// Set up command line arguments for launching a URL or an app.
// The new command line reuses the current process's user data directory (and
// login profile, for ChromeOS).
// If |extension_app_id| is non-empty, the arguments use kAppId=<id>.
// Otherwise, kApp=<url> is used.
static CommandLine CommandLineArgsForLauncher(
const GURL& url,
const std::string& extension_app_id);
#if defined(USE_X11)
// Returns filename of the desktop shortcut used to launch the browser.
static std::string GetDesktopName(base::Environment* env);
static bool GetDesktopShortcutTemplate(base::Environment* env,
std::string* output);
// Returns filename for .desktop file based on |url|, sanitized for security.
static FilePath GetDesktopShortcutFilename(const GURL& url);
// Returns contents for .desktop file based on |template_contents|, |url|
// and |title|. The |template_contents| should be contents of .desktop file
// used to launch Chrome.
static std::string GetDesktopFileContents(
const std::string& template_contents,
const std::string& app_name,
const GURL& url,
const std::string& extension_id,
const string16& title,
const std::string& icon_name);
static void CreateDesktopShortcut(const ShortcutInfo& shortcut_info,
const std::string& shortcut_template);
#endif // defined(USE_X11)
#if defined(OS_WIN)
// Generates Win7 app id for given app name and profile path. The returned app
// id is in the format of "|app_name|[.<profile_id>]". "profile_id" is
// appended when user override the default value.
static std::wstring GetAppId(const std::wstring& app_name,
const FilePath& profile_path);
// Generates Win7 app id for Chromium by calling GetAppId with
// chrome::kBrowserAppID as app_name.
static std::wstring GetChromiumAppId(const FilePath& profile_path);
// Migrates existing chrome shortcuts by tagging them with correct app id.
// see http://crbug.com/28104
static void MigrateChromiumShortcuts();
#endif // defined(OS_WIN)
// The current default browser UI state
enum DefaultBrowserUIState {
STATE_PROCESSING,
STATE_NOT_DEFAULT,
STATE_IS_DEFAULT,
STATE_UNKNOWN
};
class DefaultBrowserObserver {
public:
// Updates the UI state to reflect the current default browser state.
virtual void SetDefaultBrowserUIState(DefaultBrowserUIState state) = 0;
virtual ~DefaultBrowserObserver() {}
};
// A helper object that handles checking if Chrome is the default browser on
// Windows and also setting it as the default browser. These operations are
// performed asynchronously on the file thread since registry access is
// involved and this can be slow.
//
class DefaultBrowserWorker
: public base::RefCountedThreadSafe<DefaultBrowserWorker> {
public:
explicit DefaultBrowserWorker(DefaultBrowserObserver* observer);
// Checks if Chrome is the default browser.
void StartCheckDefaultBrowser();
// Sets Chrome as the default browser.
void StartSetAsDefaultBrowser();
// Called to notify the worker that the view is gone.
void ObserverDestroyed();
private:
friend class base::RefCountedThreadSafe<DefaultBrowserWorker>;
virtual ~DefaultBrowserWorker() {}
// Functions that track the process of checking if Chrome is the default
// browser. |ExecuteCheckDefaultBrowser| checks the registry on the file
// thread. |CompleteCheckDefaultBrowser| notifies the view to update on the
// UI thread.
void ExecuteCheckDefaultBrowser();
void CompleteCheckDefaultBrowser(DefaultBrowserState state);
// Functions that track the process of setting Chrome as the default
// browser. |ExecuteSetAsDefaultBrowser| updates the registry on the file
// thread. |CompleteSetAsDefaultBrowser| notifies the view to update on the
// UI thread.
void ExecuteSetAsDefaultBrowser();
void CompleteSetAsDefaultBrowser();
// Updates the UI in our associated view with the current default browser
// state.
void UpdateUI(DefaultBrowserState state);
DefaultBrowserObserver* observer_;
DISALLOW_COPY_AND_ASSIGN(DefaultBrowserWorker);
};
};
#endif // CHROME_BROWSER_SHELL_INTEGRATION_H_
|
