1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_WEBAPPS_BROWSER_ANDROID_BOTTOMSHEET_PWA_BOTTOM_SHEET_CONTROLLER_H_
#define COMPONENTS_WEBAPPS_BROWSER_ANDROID_BOTTOMSHEET_PWA_BOTTOM_SHEET_CONTROLLER_H_
#include <memory>
#include <vector>
#include "base/android/scoped_java_ref.h"
#include "base/functional/callback.h"
#include "base/memory/raw_ref.h"
#include "components/webapps/browser/android/add_to_homescreen_installer.h"
#include "components/webapps/browser/android/add_to_homescreen_params.h"
#include "third_party/skia/include/core/SkBitmap.h"
#include "url/gurl.h"
namespace content {
class WebContents;
}
namespace webapps {
struct Screenshot;
// A Controller for the BottomSheet install UI for progressive web apps.
// If successfully created, the lifetime of this object is tied to the lifetime
// of the BottomSheet UI being shown and the object is destroyed from Java when
// the UI is dismissed. This class can be instantiated from both the Java side
// (when the user selects Install App from the App Menu) and from the C++ side,
// when the engagement score for the web site is high enough to promote the
// install of a PWA.
class PwaBottomSheetController {
public:
// If possible, shows/expand the PWA Bottom Sheet installer and returns true.
// Otherwise does nothing and returns false.
static bool MaybeShow(
content::WebContents* web_contents,
const std::u16string& app_name,
const SkBitmap& primary_icon,
const bool is_primary_icon_maskable,
const GURL& start_url,
const std::vector<Screenshot>& screenshots,
const std::u16string& description,
bool expand_sheet,
std::unique_ptr<AddToHomescreenParams> a2hs_params,
base::RepeatingCallback<void(AddToHomescreenInstaller::Event,
const AddToHomescreenParams&)>
a2hs_event_callback);
virtual ~PwaBottomSheetController();
// Called from the Java side and destructs this object.
void Destroy(JNIEnv* env);
// Called from the Java side when install source needs to be updated (e.g. if
// the bottom sheet is created as an ambient badge, but then the user uses the
// menu item to expand it, we will need to update the source from
// AMBIENT_BADGE to MENU).
void UpdateInstallSource(JNIEnv* env, int install_source);
// Called from the Java side when bottom sheet got closed with swipe.
void OnSheetClosedWithSwipe(JNIEnv* env);
// Called from the Java side when bottom sheet got expanded.
void OnSheetExpanded(JNIEnv* env);
// Called from the Java side when the user opts to install.
void OnAddToHomescreen(
JNIEnv* env,
const base::android::JavaParamRef<jobject>& jweb_contents);
private:
PwaBottomSheetController(
const std::u16string& app_name,
const SkBitmap& primary_icon,
const bool is_primary_icon_maskable,
const GURL& start_url,
const std::vector<Screenshot>& screenshots,
const std::u16string& description,
std::unique_ptr<AddToHomescreenParams> a2hs_params,
base::RepeatingCallback<void(AddToHomescreenInstaller::Event,
const AddToHomescreenParams&)>
a2hs_event_callback);
PwaBottomSheetController(const PwaBottomSheetController&) = delete;
PwaBottomSheetController& operator=(const PwaBottomSheetController&) = delete;
// Shows the Bottom Sheet installer UI for a given |web_contents|.
void ShowBottomSheetInstaller(content::WebContents* web_contents,
bool expand_sheet);
// Called for each screenshot available. Updates the Java side with the new
// image.
void UpdateScreenshot(const SkBitmap& screenshot,
content::WebContents* web_contents);
const std::u16string app_name_;
const SkBitmap primary_icon_;
const bool is_primary_icon_maskable_ = false;
const raw_ref<const GURL> start_url_;
const raw_ref<const std::vector<Screenshot>> screenshots_;
const std::u16string description_;
// Contains app parameters such as its type and the install source used that
// will be passed to |a2hs_event_callback_| eventually.
std::unique_ptr<AddToHomescreenParams> a2hs_params_;
// Called to provide input into the state of the installation process.
base::RepeatingCallback<void(AddToHomescreenInstaller::Event,
const AddToHomescreenParams&)>
a2hs_event_callback_;
// Whether the bottom sheet has been expanded.
bool sheet_expanded_ = false;
// Whether the bottom sheet has been closed.
bool sheet_closed_ = false;
// Whether the install flow was triggered.
bool install_triggered_ = false;
};
} // namespace webapps
#endif // COMPONENTS_WEBAPPS_BROWSER_ANDROID_BOTTOMSHEET_PWA_BOTTOM_SHEET_CONTROLLER_H_
|
