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