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
122
123
124
125
126
127
128
129
130
|
// Copyright 2013 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_SHORTCUT_HELPER_H_
#define CHROME_BROWSER_ANDROID_SHORTCUT_HELPER_H_
#include "base/android/jni_android.h"
#include "base/android/jni_weak_ref.h"
#include "base/basictypes.h"
#include "base/task/cancelable_task_tracker.h"
#include "chrome/browser/android/shortcut_info.h"
#include "chrome/common/web_application_info.h"
#include "components/favicon_base/favicon_types.h"
#include "content/public/browser/web_contents_observer.h"
#include "content/public/common/manifest.h"
namespace content {
class WebContents;
} // namespace content
namespace IPC {
class Message;
}
class GURL;
// ShortcutHelper is the C++ counterpart of org.chromium.chrome.browser's
// ShortcutHelper in Java. The object is owned by the Java object. It is created
// from there via a JNI (Initialize) call and can be destroyed from Java too
// using TearDown. When the Java implementations calls AddShortcut, it gives up
// the ownership of the object. The instance will then destroy itself when done.
class ShortcutHelper : public content::WebContentsObserver {
public:
ShortcutHelper(JNIEnv* env,
jobject obj,
content::WebContents* web_contents);
// Initialize the helper by requesting the information about the page to the
// renderer process. The initialization is asynchronous and
// OnDidRetrieveWebappInformation is expected to be called when finished.
void Initialize();
// Called by the Java counter part to let the object knows that it can destroy
// itself.
void TearDown(JNIEnv* env, jobject obj);
// IPC message received when the initialization is finished.
void OnDidGetWebApplicationInfo(const WebApplicationInfo& web_app_info);
// Callback run when the Manifest is ready to be used.
void OnDidGetManifest(const content::Manifest& manifest);
// Adds a shortcut to the current URL to the Android home screen.
void AddShortcut(JNIEnv* env,
jobject obj,
jstring title,
jint launcher_large_icon_size);
// Callback run when the requested Manifest icon is ready to be used.
void OnDidDownloadIcon(int id,
int http_status_code,
const GURL& url,
const std::vector<SkBitmap>& bitmaps,
const std::vector<gfx::Size>& sizes);
// Called after AddShortcut() and OnDidDownloadIcon() are run if
// OnDidDownloadIcon has a valid icon.
void AddShortcutUsingManifestIcon();
// Use FaviconService to get the best available favicon and create the
// shortcut using it. This is used when no Manifest icons are available or
// appropriate.
void AddShortcutUsingFavicon();
// Callback run when a favicon is received from GetFavicon() call.
void OnDidGetFavicon(
const favicon_base::FaviconRawBitmapResult& bitmap_result);
// WebContentsObserver
bool OnMessageReceived(const IPC::Message& message) override;
void WebContentsDestroyed() override;
// Adds a shortcut to the launcher using a FaviconRawBitmapResult.
// Must be called from a WorkerPool task.
static void AddShortcutInBackgroundWithRawBitmap(
const ShortcutInfo& info,
const favicon_base::FaviconRawBitmapResult& bitmap_result);
// Adds a shortcut to the launcher using a SkBitmap.
// Must be called from a WorkerPool task.
static void AddShortcutInBackgroundWithSkBitmap(
const ShortcutInfo& info,
const SkBitmap& icon_bitmap,
const bool return_to_homescreen);
// Registers JNI hooks.
static bool RegisterShortcutHelper(JNIEnv* env);
private:
enum ManifestIconStatus {
MANIFEST_ICON_STATUS_NONE,
MANIFEST_ICON_STATUS_FETCHING,
MANIFEST_ICON_STATUS_DONE
};
~ShortcutHelper() override;
void Destroy();
void RecordAddToHomescreen();
JavaObjectWeakGlobalRef java_ref_;
ShortcutInfo shortcut_info_;
SkBitmap manifest_icon_;
base::CancelableTaskTracker cancelable_task_tracker_;
bool add_shortcut_requested_;
ManifestIconStatus manifest_icon_status_;
const int preferred_icon_size_in_px_;
static const int kPreferredIconSizeInDp;
base::WeakPtrFactory<ShortcutHelper> weak_ptr_factory_;
DISALLOW_COPY_AND_ASSIGN(ShortcutHelper);
};
#endif // CHROME_BROWSER_ANDROID_SHORTCUT_HELPER_H_
|
