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 #ifndef CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_ 6 #define CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_ 7 8 #include "base/command_line.h" 9 #include "base/files/file_path.h" 10 #include "chrome/browser/ui/host_desktop.h" 11 #include "chrome/common/extensions/extension_constants.h" 12 #include "ui/base/window_open_disposition.h" 13 #include "ui/gfx/rect.h" 14 #include "url/gurl.h" 15 16 class Browser; 17 class Profile; 18 19 namespace base { 20 class CommandLine; 21 } 22 23 namespace content { 24 class WebContents; 25 } 26 27 namespace extensions { 28 class Extension; 29 } 30 31 struct AppLaunchParams { 32 AppLaunchParams(Profile* profile, 33 const extensions::Extension* extension, 34 extensions::LaunchContainer container, 35 WindowOpenDisposition disposition); 36 37 // Helper to create AppLaunchParams using extensions::GetLaunchContainer with 38 // LAUNCH_TYPE_REGULAR to check for a user-configured container. 39 AppLaunchParams(Profile* profile, 40 const extensions::Extension* extension, 41 WindowOpenDisposition disposition); 42 43 // Helper to create AppLaunchParams using event flags that allows user to 44 // override the user-configured container using modifier keys, falling back to 45 // extensions::GetLaunchContainer() with no modifiers. |desktop_type| 46 // indicates the desktop upon which to launch (Ash or Native). 47 AppLaunchParams(Profile* profile, 48 const extensions::Extension* extension, 49 int event_flags, 50 chrome::HostDesktopType desktop_type); 51 52 ~AppLaunchParams(); 53 54 // The profile to load the application from. 55 Profile* profile; 56 57 // The extension to load. 58 std::string extension_id; 59 60 // The container type to launch the application in. 61 extensions::LaunchContainer container; 62 63 // If container is TAB, this field controls how the tab is opened. 64 WindowOpenDisposition disposition; 65 66 // The desktop type to launch on. Uses GetActiveDesktop() if unspecified. 67 chrome::HostDesktopType desktop_type; 68 69 // If non-empty, use override_url in place of the application's launch url. 70 GURL override_url; 71 72 // If non-empty, use override_boudns in place of the application's default 73 // position and dimensions. 74 gfx::Rect override_bounds; 75 76 // If non-empty, information from the command line may be passed on to the 77 // application. 78 base::CommandLine command_line; 79 80 // If non-empty, the current directory from which any relative paths on the 81 // command line should be expanded from. 82 base::FilePath current_directory; 83 }; 84 85 // Opens the application, possibly prompting the user to re-enable it. 86 void OpenApplicationWithReenablePrompt(const AppLaunchParams& params); 87 88 // Open the application in a way specified by |params|. 89 content::WebContents* OpenApplication(const AppLaunchParams& params); 90 91 // Open |url| in an app shortcut window. 92 // There are two kinds of app shortcuts: Shortcuts to a URL, 93 // and shortcuts that open an installed application. This function 94 // is used to open the former. To open the latter, use 95 // application_launch::OpenApplication(). 96 content::WebContents* OpenAppShortcutWindow(Profile* profile, 97 const GURL& url); 98 99 // Whether the extension can be launched by sending a 100 // chrome.app.runtime.onLaunched event. 101 bool CanLaunchViaEvent(const extensions::Extension* extension); 102 103 #endif // CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_ 104