chrome/browser/android/webapps/add_to_homescreen_data_fetcher.h

   1 // Copyright 2015 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_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_DATA_FETCHER_H_
   6 #define CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_DATA_FETCHER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "base/task/cancelable_task_tracker.h"
  10 #include "base/timer/timer.h"
  11 #include "chrome/browser/android/shortcut_info.h"
  12 #include "chrome/common/web_application_info.h"
  13 #include "components/favicon_base/favicon_types.h"
  14 #include "content/public/browser/web_contents_observer.h"
  15 #include "content/public/common/manifest.h"
  16
  17 namespace content {
  18 class WebContents;
  19 }  // namespace content
  20
  21 namespace IPC {
  22 class Message;
  23 }
  24
  25 class GURL;
  26
  27 // Aysnchronously fetches and processes data needed to create a shortcut for an
  28 // Android Home screen launcher.
  29 //
  30 // Because of the various asynchronous calls made by this class, it is
  31 // refcounted to prevent the class from being prematurely deleted.  If the
  32 // pointer to the ShortcutHelper becomes invalid, the pipeline should kill
  33 // itself.
  34 class AddToHomescreenDataFetcher
  35     : public base::RefCounted<AddToHomescreenDataFetcher>,
  36       public content::WebContentsObserver {
  37  public:
  38   class Observer {
  39    public:
  40     // Called when the title of the page is available.
  41     virtual void OnUserTitleAvailable(const base::string16& title) = 0;
  42
  43     // Converts the icon into one that can be used on the Android Home screen.
  44     virtual SkBitmap FinalizeLauncherIcon(const SkBitmap& icon,
  45                                           const GURL& url) = 0;
  46
  47     // Called when all the data needed to create a shortcut is available.
  48     virtual void OnDataAvailable(const ShortcutInfo& info,
  49                                  const SkBitmap& icon) = 0;
  50   };
  51
  52   // Initialize the fetcher by requesting the information about the page to the
  53   // renderer process. The initialization is asynchronous and
  54   // OnDidGetWebApplicationInfo is expected to be called when finished.
  55   AddToHomescreenDataFetcher(content::WebContents* web_contents,
  56                              int ideal_icon_size_in_dp,
  57                              int minimum_icon_size_in_dp,
  58                              int ideal_splash_image_size_in_dp,
  59                              int minimum_splash_image_size_in_dp,
  60                              Observer* observer);
  61
  62   // Called to fetch the splash screen image to be stored for the webapp with
  63   // the specified |id|.
  64   void FetchSplashScreenImage(const std::string& id);
  65
  66   // IPC message received when the initialization is finished.
  67   void OnDidGetWebApplicationInfo(const WebApplicationInfo& web_app_info);
  68
  69   // Called when the Manifest has been parsed, or if no Manifest was found.
  70   void OnDidGetManifest(const content::Manifest& manifest);
  71
  72   // Accessors, etc.
  73   void set_weak_observer(Observer* observer) { weak_observer_ = observer; }
  74   bool is_ready() { return is_ready_; }
  75   ShortcutInfo& shortcut_info() { return shortcut_info_; }
  76   const SkBitmap& shortcut_icon() { return shortcut_icon_; }
  77
  78   // WebContentsObserver
  79   bool OnMessageReceived(const IPC::Message& message) override;
  80
  81  private:
  82   ~AddToHomescreenDataFetcher() override;
  83
  84   // Grabs the favicon for the current URL.
  85   void FetchFavicon();
  86   void OnFaviconFetched(
  87       const favicon_base::FaviconRawBitmapResult& bitmap_result);
  88
  89   // Creates the launcher icon from the given bitmap.
  90   void CreateLauncherIcon(
  91       const favicon_base::FaviconRawBitmapResult& bitmap_result);
  92
  93   // Callback run after an attempt to download manifest icon has been made. May
  94   // kick off the download of a favicon if it failed (i.e. the bitmap is empty).
  95   void OnManifestIconFetched(const SkBitmap& icon);
  96
  97   // Notifies the observer that the shortcut data is all available.
  98   void NotifyObserver(const SkBitmap& icon);
  99
 100   Observer* weak_observer_;
 101
 102   bool is_waiting_for_web_application_info_;
 103   bool is_icon_saved_;
 104   bool is_ready_;
 105   base::Timer icon_timeout_timer_;
 106   ShortcutInfo shortcut_info_;
 107   GURL splash_screen_url_;
 108
 109   // The icon must only be set on the UI thread for thread safety.
 110   SkBitmap shortcut_icon_;
 111   base::CancelableTaskTracker favicon_task_tracker_;
 112
 113   const int ideal_icon_size_in_dp_;
 114   const int minimum_icon_size_in_dp_;
 115   const int ideal_splash_image_size_in_dp_;
 116   const int minimum_splash_image_size_in_dp_;
 117
 118   friend class base::RefCounted<AddToHomescreenDataFetcher>;
 119   DISALLOW_COPY_AND_ASSIGN(AddToHomescreenDataFetcher);
 120 };
 121
 122 #endif  // CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_DATA_FETCHER_H_