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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.webkit;
import android.annotation.SystemApi;
import android.app.ActivityThread;
import android.app.Application;
import android.content.Context;
import android.content.res.Resources;
import android.graphics.Canvas;
import android.net.http.ErrorStrings;
import android.os.SystemProperties;
import android.os.Trace;
import android.util.SparseArray;
import android.view.HardwareCanvas;
import android.view.View;
import android.view.ViewRootImpl;
/**
* Delegate used by the WebView provider implementation to access
* the required framework functionality needed to implement a {@link WebView}.
*
* @hide
*/
@SystemApi
public final class WebViewDelegate {
/* package */ WebViewDelegate() { }
/**
* Listener that gets notified whenever tracing has been enabled/disabled.
*/
public interface OnTraceEnabledChangeListener {
void onTraceEnabledChange(boolean enabled);
}
/**
* Register a callback to be invoked when tracing for the WebView component has been
* enabled/disabled.
*/
public void setOnTraceEnabledChangeListener(final OnTraceEnabledChangeListener listener) {
SystemProperties.addChangeCallback(new Runnable() {
@Override
public void run() {
listener.onTraceEnabledChange(isTraceTagEnabled());
}
});
}
/**
* Returns true if the WebView trace tag is enabled and false otherwise.
*/
public boolean isTraceTagEnabled() {
return Trace.isTagEnabled(Trace.TRACE_TAG_WEBVIEW);
}
/**
* Returns true if the draw GL functor can be invoked (see {@link #invokeDrawGlFunctor})
* and false otherwise.
*/
public boolean canInvokeDrawGlFunctor(View containerView) {
ViewRootImpl viewRootImpl = containerView.getViewRootImpl();
// viewRootImpl can be null during teardown when window is leaked.
return viewRootImpl != null;
}
/**
* Invokes the draw GL functor. If waitForCompletion is false the functor
* may be invoked asynchronously.
*
* @param nativeDrawGLFunctor the pointer to the native functor that implements
* system/core/include/utils/Functor.h
*/
public void invokeDrawGlFunctor(View containerView, long nativeDrawGLFunctor,
boolean waitForCompletion) {
ViewRootImpl viewRootImpl = containerView.getViewRootImpl();
viewRootImpl.invokeFunctor(nativeDrawGLFunctor, waitForCompletion);
}
/**
* Calls the function specified with the nativeDrawGLFunctor functor pointer. This
* functionality is used by the WebView for calling into their renderer from the
* framework display lists.
*
* @param canvas a hardware accelerated canvas (see {@link Canvas#isHardwareAccelerated()})
* @param nativeDrawGLFunctor the pointer to the native functor that implements
* system/core/include/utils/Functor.h
* @throws IllegalArgumentException if the canvas is not hardware accelerated
*/
public void callDrawGlFunction(Canvas canvas, long nativeDrawGLFunctor) {
if (!(canvas instanceof HardwareCanvas)) {
// Canvas#isHardwareAccelerated() is only true for subclasses of HardwareCanvas.
throw new IllegalArgumentException(canvas.getClass().getName()
+ " is not hardware accelerated");
}
((HardwareCanvas) canvas).callDrawGLFunction(nativeDrawGLFunctor);
}
/**
* Detaches the draw GL functor.
*
* @param nativeDrawGLFunctor the pointer to the native functor that implements
* system/core/include/utils/Functor.h
*/
public void detachDrawGlFunctor(View containerView, long nativeDrawGLFunctor) {
ViewRootImpl viewRootImpl = containerView.getViewRootImpl();
if (nativeDrawGLFunctor != 0 && viewRootImpl != null) {
viewRootImpl.detachFunctor(nativeDrawGLFunctor);
}
}
/**
* Returns the package id of the given {@code packageName}.
*/
public int getPackageId(Resources resources, String packageName) {
SparseArray<String> packageIdentifiers =
resources.getAssets().getAssignedPackageIdentifiers();
for (int i = 0; i < packageIdentifiers.size(); i++) {
final String name = packageIdentifiers.valueAt(i);
if (packageName.equals(name)) {
return packageIdentifiers.keyAt(i);
}
}
throw new RuntimeException("Package not found: " + packageName);
}
/**
* Returns the application which is embedding the WebView.
*/
public Application getApplication() {
return ActivityThread.currentApplication();
}
/**
* Returns the error string for the given {@code errorCode}.
*/
public String getErrorString(Context context, int errorCode) {
return ErrorStrings.getString(errorCode, context);
}
/**
* Adds the WebView asset path to {@link AssetManager}.
*/
public void addWebViewAssetPath(Context context) {
context.getAssets().addAssetPath(
WebViewFactory.getLoadedPackageInfo().applicationInfo.sourceDir);
}
}
|
