chrome/browser/android/webapps/add_to_homescreen_installer.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_INSTALLER_H_
#define CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_INSTALLER_H_

#include "base/callback_forward.h"
#include "chrome/browser/android/webapps/add_to_homescreen_params.h"

namespace content {
class WebContents;
}

// Helper class for installing a web app or an Android native app and recording
// related UMA.
class AddToHomescreenInstaller {
 public:
  enum class Event {
    INSTALL_STARTED,
    INSTALL_FAILED,
    INSTALL_REQUEST_FINISHED,
    NATIVE_INSTALL_OR_OPEN_FAILED,
    NATIVE_INSTALL_OR_OPEN_SUCCEEDED,
    NATIVE_DETAILS_SHOWN,
    UI_SHOWN,
    UI_CANCELLED,
  };

  // Installs the app referenced by the data in this object.
  // |event_callback| will be run to inform the caller of the progress of the
  // installation. It is guaranteed that |event_callback| will only be called
  // before the add-to-homescreen prompt is dismissed.
  static void Install(
      content::WebContents* web_contents,
      const AddToHomescreenParams& params,
      const base::RepeatingCallback<void(Event, const AddToHomescreenParams&)>&
          event_callback);

 private:
  static void InstallOrOpenNativeApp(
      content::WebContents* web_contents,
      const AddToHomescreenParams& params,
      const base::RepeatingCallback<void(Event, const AddToHomescreenParams&)>&
          event_callback);
  static void InstallWebApk(content::WebContents* web_contents,
                            const AddToHomescreenParams& params);
  static void InstallShortcut(content::WebContents* web_contents,
                              const AddToHomescreenParams& params);

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

#endif  // CHROME_BROWSER_ANDROID_WEBAPPS_ADD_TO_HOMESCREEN_INSTALLER_H_