Home | History | Annotate | Download | only in app_list 
      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.
      4 
      5 #ifndef CHROME_BROWSER_UI_APP_LIST_APP_LIST_SERVICE_H_
      6 #define CHROME_BROWSER_UI_APP_LIST_APP_LIST_SERVICE_H_
      7 
      8 #include <string>
      9 
     10 #include "base/basictypes.h"
     11 #include "base/compiler_specific.h"
     12 #include "chrome/browser/ui/host_desktop.h"
     13 #include "ui/gfx/native_widget_types.h"
     14 
     15 class AppListControllerDelegate;
     16 class PrefRegistrySimple;
     17 class Profile;
     18 
     19 namespace base {
     20 class CommandLine;
     21 class FilePath;
     22 }
     23 
     24 namespace gfx {
     25 class ImageSkia;
     26 }
     27 
     28 class AppListService {
     29  public:
     30   // Source that triggers the app launcher being enabled. This is used for UMA
     31   // to track discoverability of the app lancher shortcut after install. Also
     32   // used to provide custom install behavior (e.g. "always" enable).
     33   enum AppListEnableSource {
     34     ENABLE_NOT_RECORDED,        // Indicates app launcher not recently enabled.
     35     ENABLE_FOR_APP_INSTALL,     // Triggered by a webstore packaged app install.
     36     ENABLE_VIA_WEBSTORE_LINK,   // Triggered by webstore explicitly via API.
     37     ENABLE_VIA_COMMAND_LINE,    // Triggered by --enable-app-list.
     38     ENABLE_ON_REINSTALL,        // Triggered by Chrome reinstall finding pref.
     39     ENABLE_SHOWN_UNDISCOVERED,  // This overrides a prior ENABLE_FOR_APP_INSTALL
     40                                 // when the launcher is auto-shown without
     41                                 // being "discovered" beforehand.
     42     ENABLE_NUM_ENABLE_SOURCES
     43   };
     44 
     45   // Get the AppListService for the current platform and specified
     46   // |desktop_type|.
     47   static AppListService* Get(chrome::HostDesktopType desktop_type);
     48 
     49   // Call Init for all AppListService instances on this platform.
     50   static void InitAll(Profile* initial_profile);
     51 
     52   static void RegisterPrefs(PrefRegistrySimple* registry);
     53 
     54   // Initializes the AppListService, and returns true if |command_line| is for
     55   // showing the app list.
     56   static bool HandleLaunchCommandLine(const base::CommandLine& command_line,
     57                                       Profile* launch_profile);
     58 
     59   // Indicates that |callback| should be called next time the app list is
     60   // painted.
     61   virtual void SetAppListNextPaintCallback(void (*callback)()) = 0;
     62 
     63   // Perform Chrome first run logic. This is executed before Chrome's threads
     64   // have been created.
     65   virtual void HandleFirstRun() = 0;
     66 
     67   virtual base::FilePath GetProfilePath(
     68       const base::FilePath& user_data_dir) = 0;
     69   virtual void SetProfilePath(const base::FilePath& profile_path) = 0;
     70 
     71   // Show the app list for the profile configured in the user data dir for the
     72   // current browser process.
     73   virtual void Show() = 0;
     74 
     75   // Create the app list UI, and maintain its state, but do not show it.
     76   virtual void CreateForProfile(Profile* requested_profile) = 0;
     77 
     78   // Show the app list for the given profile. If it differs from the profile the
     79   // app list is currently showing, repopulate the app list and save the new
     80   // profile to local prefs as the default app list profile.
     81   virtual void ShowForProfile(Profile* requested_profile) = 0;
     82 
     83   // Show the app list due to a trigger which was not an explicit user action
     84   // to show the app list. E.g. the auto-show when installing an app. This
     85   // permits UMA to distinguish between a user discovering the app list shortcut
     86   // themselves versus having it shown for them automatically.
     87   virtual void AutoShowForProfile(Profile* requested_profile) = 0;
     88 
     89   // Dismiss the app list.
     90   virtual void DismissAppList() = 0;
     91 
     92   // Get the profile the app list is currently showing.
     93   virtual Profile* GetCurrentAppListProfile() = 0;
     94 
     95   // Returns true if the app list is visible.
     96   virtual bool IsAppListVisible() const = 0;
     97 
     98   // Enable the app list. What this does specifically will depend on the host
     99   // operating system and shell.
    100   virtual void EnableAppList(Profile* initial_profile,
    101                              AppListEnableSource enable_source) = 0;
    102 
    103   // Get the window the app list is in, or NULL if the app list isn't visible.
    104   virtual gfx::NativeWindow GetAppListWindow() = 0;
    105 
    106   // Returns a pointer to the platform specific AppListControllerDelegate.
    107   virtual AppListControllerDelegate* GetControllerDelegate() = 0;
    108 
    109   // Create a platform-specific shortcut for the app list.
    110   virtual void CreateShortcut() = 0;
    111 
    112  protected:
    113   AppListService() {}
    114   virtual ~AppListService() {}
    115 
    116   // Do any once off initialization needed for the app list.
    117   virtual void Init(Profile* initial_profile) = 0;
    118 
    119  private:
    120   DISALLOW_COPY_AND_ASSIGN(AppListService);
    121 };
    122 
    123 #endif  // CHROME_BROWSER_UI_APP_LIST_APP_LIST_SERVICE_H_
    124