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 16class Browser; 17class Profile; 18 19namespace base { 20class CommandLine; 21} 22 23namespace content { 24class WebContents; 25} 26 27namespace extensions { 28class Extension; 29} 30 31struct 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. 86void OpenApplicationWithReenablePrompt(const AppLaunchParams& params); 87 88// Open the application in a way specified by |params|. 89content::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(). 96content::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. 101bool CanLaunchViaEvent(const extensions::Extension* extension); 102 103// Get the launch URL for a given extension, with optional override/fallback. 104// |override_url|, if non-empty, will be preferred over the extension's 105// launch url. 106GURL UrlForExtension(const extensions::Extension* extension, 107 const GURL& override_url); 108 109#endif // CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_ 110