summaryrefslogtreecommitdiffstats
path: root/chrome/browser/browser_init.h
diff options
context:
space:
mode:
authorBen Murdoch <benm@google.com>2010-07-29 17:14:53 +0100
committerBen Murdoch <benm@google.com>2010-08-04 14:29:45 +0100
commitc407dc5cd9bdc5668497f21b26b09d988ab439de (patch)
tree7eaf8707c0309516bdb042ad976feedaf72b0bb1 /chrome/browser/browser_init.h
parent0998b1cdac5733f299c12d88bc31ef9c8035b8fa (diff)
downloadexternal_chromium-c407dc5cd9bdc5668497f21b26b09d988ab439de.zip
external_chromium-c407dc5cd9bdc5668497f21b26b09d988ab439de.tar.gz
external_chromium-c407dc5cd9bdc5668497f21b26b09d988ab439de.tar.bz2
Merge Chromium src@r53293
Change-Id: Ia79acf8670f385cee48c45b0a75371d8e950af34
Diffstat (limited to 'chrome/browser/browser_init.h')
-rw-r--r--chrome/browser/browser_init.h215
1 files changed, 215 insertions, 0 deletions
diff --git a/chrome/browser/browser_init.h b/chrome/browser/browser_init.h
new file mode 100644
index 0000000..3aa9b70
--- /dev/null
+++ b/chrome/browser/browser_init.h
@@ -0,0 +1,215 @@
+// 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_BROWSER_INIT_H_
+#define CHROME_BROWSER_BROWSER_INIT_H_
+
+#include <string>
+#include <vector>
+
+#include "base/basictypes.h"
+#include "base/gtest_prod_util.h"
+#include "googleurl/src/gurl.h"
+
+class Browser;
+class CommandLine;
+class GURL;
+class PrefService;
+class Profile;
+class TabContents;
+#if defined(OS_CHROMEOS)
+namespace chromeos {
+class ServicesCustomizationDocument;
+}
+#endif
+
+// class containing helpers for BrowserMain to spin up a new instance and
+// initialize the profile.
+class BrowserInit {
+ public:
+ BrowserInit() {}
+ ~BrowserInit() {}
+
+ // Adds a url to be opened during first run. This overrides the standard
+ // tabs shown at first run.
+ void AddFirstRunTab(const GURL& url) {
+ first_run_tabs_.push_back(url);
+ }
+
+ // This function is equivalent to ProcessCommandLine but should only be
+ // called during actual process startup.
+ bool Start(const CommandLine& cmd_line, const std::wstring& cur_dir,
+ Profile* profile, int* return_code) {
+ return ProcessCmdLineImpl(cmd_line, cur_dir, true, profile, return_code,
+ this);
+ }
+
+ // This function performs command-line handling and is invoked when
+ // process starts as well as when we get a start request from another
+ // process (via the WM_COPYDATA message). |command_line| holds the command
+ // line we need to process - either from this process or from some other one
+ // (if |process_startup| is true and we are being called from
+ // ProcessSingleton::OnCopyData).
+ static bool ProcessCommandLine(const CommandLine& cmd_line,
+ const std::wstring& cur_dir,
+ bool process_startup, Profile* profile,
+ int* return_code) {
+ return ProcessCmdLineImpl(cmd_line, cur_dir, process_startup, profile,
+ return_code, NULL);
+ }
+
+ template <class AutomationProviderClass>
+ static void CreateAutomationProvider(const std::string& channel_id,
+ Profile* profile,
+ size_t expected_tabs);
+
+ // Returns true if the browser is coming up.
+ static bool InProcessStartup();
+
+ // Launches a browser window associated with |profile|. |command_line|
+ // should be the command line passed to this process. |cur_dir| can be
+ // the null string, which implies that the directory of the executable.
+ // should be used. |process_startup| indicates whether this is the
+ // first browser.
+ bool LaunchBrowser(const CommandLine& command_line, Profile* profile,
+ const std::wstring& cur_dir, bool process_startup,
+ int* return_code);
+
+#if defined(OS_CHROMEOS)
+ // Processes the OEM services customization document and modifies browser
+ // settings like initial startup page, web apps and extentions.
+ bool ApplyServicesCustomization(
+ const chromeos::ServicesCustomizationDocument* customization);
+#endif
+
+ // LaunchWithProfile ---------------------------------------------------------
+ //
+ // Assists launching the application and appending the initial tabs for a
+ // browser window.
+
+ class LaunchWithProfile {
+ public:
+ // Used by OpenTabsInBrowser.
+ struct Tab {
+ Tab() : is_app(false), is_pinned(true) {}
+
+ // The url to load.
+ GURL url;
+
+ // If true, the tab corresponds to an app an |app_id| gives the id of the
+ // app.
+ bool is_app;
+
+ // True if the is tab pinned.
+ bool is_pinned;
+
+ // Id of the app.
+ std::string app_id;
+ };
+
+ // There are two ctors. The first one implies a NULL browser_init object
+ // and thus no access to distribution-specific first-run behaviors. The
+ // second one is always called when the browser starts even if it is not
+ // the first run.
+ LaunchWithProfile(const std::wstring& cur_dir,
+ const CommandLine& command_line);
+ LaunchWithProfile(const std::wstring& cur_dir,
+ const CommandLine& command_line,
+ BrowserInit* browser_init);
+ ~LaunchWithProfile() { }
+
+ // Creates the necessary windows for startup. Returns true on success,
+ // false on failure. process_startup is true if Chrome is just
+ // starting up. If process_startup is false, it indicates Chrome was
+ // already running and the user wants to launch another instance.
+ bool Launch(Profile* profile, bool process_startup);
+
+ // Convenience for OpenTabsInBrowser that converts |urls| into a set of
+ // Tabs.
+ Browser* OpenURLsInBrowser(Browser* browser,
+ bool process_startup,
+ const std::vector<GURL>& urls);
+
+ // Creates a tab for each of the Tabs in |tabs|. If browser is non-null
+ // and a tabbed browser, the tabs are added to it. Otherwise a new tabbed
+ // browser is created and the tabs are added to it. The browser the tabs
+ // are added to is returned, which is either |browser| or the newly created
+ // browser.
+ Browser* OpenTabsInBrowser(Browser* browser,
+ bool process_startup,
+ const std::vector<Tab>& tabs);
+
+ private:
+ FRIEND_TEST_ALL_PREFIXES(BrowserTest, RestorePinnedTabs);
+
+ // If the process was launched with the web application command line flags,
+ // e.g. --app=http://www.google.com/ or --app_id=... return true.
+ // In this case |app_url| or |app_id| are populated if they're non-null.
+ bool IsAppLaunch(std::string* app_url, std::string* app_id);
+
+ // If IsAppLaunch is true, tries to open an application window.
+ // If the app is specified to start in a tab, or IsAppLaunch is false,
+ // returns false to specify default processing.
+ bool OpenApplicationWindow(Profile* profile);
+
+ // Invoked from OpenURLsInBrowser to handle processing of urls. This may
+ // do any of the following:
+ // . Invoke ProcessStartupURLs if |process_startup| is true.
+ // . Restore the last session if necessary.
+ // . Open the urls directly.
+ void ProcessLaunchURLs(bool process_startup,
+ const std::vector<GURL>& urls_to_open);
+
+ // Does the following:
+ // . If the user's startup pref is to restore the last session (or the
+ // command line flag is present to force using last session), it is
+ // restored, and true is returned.
+ // . Attempts to restore any pinned tabs from last run of chrome and:
+ // . If urls_to_open is non-empty, they are opened and true is returned.
+ // . If the user's startup pref is to launch a specific set of URLs they
+ // are opened.
+ //
+ // Otherwise false is returned, which indicates the caller must create a
+ // new browser.
+ bool ProcessStartupURLs(const std::vector<GURL>& urls_to_open);
+
+ // If the last session didn't exit cleanly and tab is a web contents tab,
+ // an infobar is added allowing the user to restore the last session.
+ void AddCrashedInfoBarIfNecessary(TabContents* tab);
+
+ // If we have been started with unsupported flags like --single-process,
+ // politely nag the user about it.
+ void AddBadFlagsInfoBarIfNecessary(TabContents* tab);
+
+ // Returns the list of URLs to open from the command line. The returned
+ // vector is empty if the user didn't specify any URLs on the command line.
+ std::vector<GURL> GetURLsFromCommandLine(Profile* profile);
+
+ // Adds additional startup URLs to the specified vector.
+ void AddStartupURLs(std::vector<GURL>* startup_urls) const;
+
+ // Checks whether Chrome is still the default browser (unless the user
+ // previously instructed not to do so) and warns the user if it is not.
+ void CheckDefaultBrowser(Profile* profile);
+
+ std::wstring cur_dir_;
+ const CommandLine& command_line_;
+ Profile* profile_;
+ BrowserInit* browser_init_;
+ DISALLOW_COPY_AND_ASSIGN(LaunchWithProfile);
+ };
+
+ private:
+ static bool ProcessCmdLineImpl(const CommandLine& command_line,
+ const std::wstring& cur_dir,
+ bool process_startup, Profile* profile,
+ int* return_code, BrowserInit* browser_init);
+
+ // Additional tabs to open during first run.
+ std::vector<GURL> first_run_tabs_;
+
+ DISALLOW_COPY_AND_ASSIGN(BrowserInit);
+};
+
+#endif // CHROME_BROWSER_BROWSER_INIT_H_