1 // Copyright 2013 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.
5 #ifndef APPS_APP_SHIM_APP_SHIM_HANDLER_MAC_H_
6 #define APPS_APP_SHIM_APP_SHIM_HANDLER_MAC_H_
11 #include "apps/app_shim/app_shim_launch.h"
12 #include "base/files/file_path.h"
16 // Registrar, and interface for services that can handle interactions with OSX
18 class AppShimHandler {
22 // Invoked when the app is successfully launched.
23 virtual void OnAppLaunchComplete(AppShimLaunchResult result) = 0;
24 // Invoked when the app is closed in the browser process.
25 virtual void OnAppClosed() = 0;
26 // Invoked when the app should be hidden.
27 virtual void OnAppHide() = 0;
28 // Invoked when the app is requesting user attention.
29 virtual void OnAppRequestUserAttention() = 0;
31 // Allows the handler to determine which app this host corresponds to.
32 virtual base::FilePath GetProfilePath() const = 0;
33 virtual std::string GetAppId() const = 0;
39 // Register a handler for an |app_mode_id|.
40 static void RegisterHandler(const std::string& app_mode_id,
41 AppShimHandler* handler);
43 // Remove a handler for an |app_mode_id|.
44 static void RemoveHandler(const std::string& app_mode_id);
46 // Returns the handler registered for the given |app_mode_id|. If there is
47 // none registered, it returns the default handler or NULL if there is no
49 static AppShimHandler* GetForAppMode(const std::string& app_mode_id);
51 // Sets the default handler to return when there is no app-specific handler.
52 // Setting this to NULL removes the default handler.
53 static void SetDefaultHandler(AppShimHandler* handler);
55 // Terminate Chrome if a browser window has never been opened, there are no
56 // shell windows, and the app list is not visible.
57 static void MaybeTerminate();
59 // Invoked by the shim host when the shim process is launched. The handler
60 // must call OnAppLaunchComplete to inform the shim of the result.
61 // |launch_type| indicates the type of launch.
62 // |files|, if non-empty, holds an array of files paths given as arguments, or
63 // dragged onto the app bundle or dock icon.
64 virtual void OnShimLaunch(Host* host,
65 AppShimLaunchType launch_type,
66 const std::vector<base::FilePath>& files) = 0;
68 // Invoked by the shim host when the connection to the shim process is closed.
69 virtual void OnShimClose(Host* host) = 0;
71 // Invoked by the shim host when the shim process receives a focus event.
72 // |files|, if non-empty, holds an array of files dragged onto the app bundle
74 virtual void OnShimFocus(Host* host,
75 AppShimFocusType focus_type,
76 const std::vector<base::FilePath>& files) = 0;
78 // Invoked by the shim host when the shim process is hidden or shown.
79 virtual void OnShimSetHidden(Host* host, bool hidden) = 0;
81 // Invoked by the shim host when the shim process receives a quit event.
82 virtual void OnShimQuit(Host* host) = 0;
86 virtual ~AppShimHandler() {}
91 #endif // APPS_APP_SHIM_APP_SHIM_HANDLER_MAC_H_