chrome/browser/android/webapps/add_to_homescreen_mediator.h

// Copyright 2019 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_MEDIATOR_H_
#define CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_MEDIATOR_H_

#include <memory>

#include "base/android/jni_android.h"
#include "base/android/scoped_java_ref.h"
#include "base/memory/weak_ptr.h"
#include "base/strings/string16.h"
#include "chrome/browser/android/webapps/add_to_homescreen_data_fetcher.h"
#include "chrome/browser/android/webapps/add_to_homescreen_installer.h"
#include "chrome/browser/android/webapps/add_to_homescreen_params.h"
#include "chrome/browser/banners/app_banner_manager.h"
#include "third_party/skia/include/core/SkBitmap.h"
#include "url/gurl.h"

namespace content {
class WebContents;
}

namespace webapps {
struct ShortcutInfo;
}

class AddToHomescreenInstaller;

// AddToHomescreenMediator is the C++ counterpart of
// org.chromium.chrome.browser.webapps.addtohomescreen.AddToHomescreenMediator
// in Java. It uses AddToHomescreenInstaller for installing the current app.
// This class is owned, constructed, and destroyed by its Java counter-part.
class AddToHomescreenMediator : public AddToHomescreenDataFetcher::Observer {
 public:
  // Initializes the mediator for a given reference to the Java side object.
  // After initialization, either StartForAppBanner or StartForAppMenu should be
  // called to update the UI accordingly.
  explicit AddToHomescreenMediator(
      const base::android::JavaParamRef<jobject>& java_ref);

  void StartForAppBanner(
      base::WeakPtr<webapps::AppBannerManager> weak_manager,
      std::unique_ptr<AddToHomescreenParams> params,
      base::RepeatingCallback<void(AddToHomescreenInstaller::Event,
                                   const AddToHomescreenParams&)>
          event_callback);

  void StartForAppMenu(
      JNIEnv* env,
      const base::android::JavaParamRef<jobject>& java_web_contents,
      int title_id);

  // Called from the Java side when the user accepts app installation from the
  // dialog.
  void AddToHomescreen(
      JNIEnv* env,
      const base::android::JavaParamRef<jstring>& j_user_title);

  // Called from the Java side when the installation UI is dismissed.
  void OnUiDismissed(JNIEnv* env);

  // Called from the Java side when details for a native app are shown.
  void OnNativeDetailsShown(JNIEnv* env);

  // Called from the Java side and destructs this object.
  void Destroy(JNIEnv* env);

 private:
  ~AddToHomescreenMediator() override;

  // Called immediatedly after |params_| is available. Displays |display_icon|
  // in the installation UI.
  void SetIcon(const SkBitmap& display_icon, bool need_to_add_padding);

  // Sends the Web App info to the Java side.
  void SetWebAppInfo(const base::string16& user_title,
                     const GURL& url,
                     bool is_webapk);

  // AddToHomescreenDataFetcher::Observer:
  void OnUserTitleAvailable(const base::string16& user_title,
                            const GURL& url,
                            bool is_webapk_compatible) override;

  void OnDataAvailable(const webapps::ShortcutInfo& info,
                       const SkBitmap& display_icon) override;

  void RecordEventForAppMenu(AddToHomescreenInstaller::Event event,
                             const AddToHomescreenParams& a2hs_params);

  content::WebContents* GetWebContents();

  // Points to the Java reference.
  base::android::ScopedJavaGlobalRef<jobject> java_ref_;

  base::WeakPtr<webapps::AppBannerManager> weak_app_banner_manager_;

  // Fetches data required to add a shortcut.
  std::unique_ptr<AddToHomescreenDataFetcher> data_fetcher_;

  std::unique_ptr<AddToHomescreenParams> params_;

  base::RepeatingCallback<void(AddToHomescreenInstaller::Event,
                               const AddToHomescreenParams&)>
      event_callback_;

  int title_id_ = -1;

  AddToHomescreenMediator(const AddToHomescreenMediator&) = delete;
  AddToHomescreenMediator& operator=(const AddToHomescreenMediator&) = delete;
};

#endif  // CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_MEDIATOR_H_