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
|
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UI_ANDROID_EXTENSIONS_EXTENSION_ACTION_POPUP_CONTENTS_H_
#define CHROME_BROWSER_UI_ANDROID_EXTENSIONS_EXTENSION_ACTION_POPUP_CONTENTS_H_
#include <memory>
#include "base/android/jni_android.h"
#include "chrome/browser/extensions/extension_view.h"
#include "content/public/browser/web_contents_observer.h"
namespace content {
class RenderFrameHost;
}
namespace extensions {
class ExtensionHost;
class ExtensionViewHost;
// ExtensionActionPopupContents is the native C++ class responsible for managing
// the content of an extension's popup displayed on Android. An extension popup
// is typically a small HTML page an extension can show when its action icon
// is clicked. This class bridges the C++ extensions system with the Java UI.
//
// Lifetime Management:
// An instance of this C++ class is created when its Java counterpart
// (ExtensionActionPopupContents.java) requests it via a JNI call (specifically,
// JNI_ExtensionActionPopupContents_Create). The C++ object's lifetime is tied
// to its Java peer. The Java object holds a native pointer (jlong) to this C++
// instance. When the Java object is no longer needed (e.g. the popup is
// closed), its `destroy()` method is called. This, in turn, calls the native
// `Destroy()` method on this C++ object, which then calls `delete this`.
class ExtensionActionPopupContents : public content::WebContentsObserver,
public ExtensionView {
public:
explicit ExtensionActionPopupContents(
std::unique_ptr<ExtensionViewHost> popup_host);
ExtensionActionPopupContents(const ExtensionActionPopupContents&) = delete;
ExtensionActionPopupContents& operator=(const ExtensionActionPopupContents&) =
delete;
~ExtensionActionPopupContents() override;
// Returns a local JNI reference to the Java counterpart of this object.
base::android::ScopedJavaLocalRef<jobject> GetJavaObject();
// WebContentsObserver:
void RenderFrameHostChanged(content::RenderFrameHost* old_host,
content::RenderFrameHost* new_host) override;
// ExtensionView:
void ResizeDueToAutoResize(content::WebContents* web_contents,
const gfx::Size& new_size) override;
void RenderFrameCreated(content::RenderFrameHost* render_frame_host) override;
bool HandleKeyboardEvent(content::WebContents* source,
const input::NativeWebKeyboardEvent& event) override;
void OnLoaded() override;
// Called from Java when the Java counterpart is being destroyed.
void Destroy(JNIEnv* env);
// Called from Java to trigger the loading of the popup's initial URL in the
// hosted WebContents.
void LoadInitialPage(JNIEnv* env);
private:
void SetUpNewMainFrame(content::RenderFrameHost* render_frame_host);
void HandleCloseExtensionHost(extensions::ExtensionHost* host);
std::unique_ptr<ExtensionViewHost> host_;
base::android::ScopedJavaGlobalRef<jobject> java_object_;
};
} // namespace extensions
#endif // CHROME_BROWSER_UI_ANDROID_EXTENSIONS_EXTENSION_ACTION_POPUP_CONTENTS_H_
|
