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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
GeckoView Save to PDF
=====================
Olivia Hall <ohall@mozilla.com>, Jonathan Almeida <jon@mozilla.com>
Why
---
- The Save to PDF feature was originally available in Fennec and users would
like to see the return of this feature. There are a lot of user requests for
Save to PDF in Fenix.
- We would have more parity with Desktop, and be able to share the same
underlying implementation with them.
- Product is currently evaluating the addition of pdf.js as well; having Save
to PDF would be an added bonus.
Goals
-----
- Save the current page to a text-based PDF document.
- Embedders should also be able to call into GeckoView to provide a PDF copy of
the selected GeckoSession.
- Enable the ability to iterate on PDF customizations.
Non-Goals
---------
- We do not want to implement a PDF “preview” of the document prior to the
download. This has open questions: does Product want this, should this be
implemented by the embedder, etc.
- The generated PDF should not match the theme (e.g., light or dark mode) of
the currently displayed page - the PDF will always appear as themeless or as
a plain document.
- No customizable settings. The current API design will not include
customization settings that the embedder can control. This can be worked on
in a follow-up feature request. Our current API design however, would enable
for these particular iterations.
What
----
This work will add a method to ``GeckoSession`` called ``savePdf`` for
embedders to use, which will communicate with a new ``GeckoViewPdf.jsm`` to
create the PDF file. When the document is available, the
``GeckoViewPdfController`` will notify the
``ContentDelegate.onExternalResponse`` with the downloadable document.
- ``GeckoViewPdf.jsm`` - JavaScript implementation that converts the content to
a PDF and saves the file, also responds to messaging from
``GeckoViewPdfController``.
- ``GeckoViewPdfController.java`` - The Controller coordinates between the Java
and JS through response messaging and notifies the content delegate when the
PDF is available for use.
API
---
GeckoSession.java
^^^^^^^^^^^^^^^^^
.. code:: java
public class GeckoSession {
public GeckoSession(final @Nullable GeckoSessionSettings settings) {
mPdfController = new PdfController(this);
}
@UiThread
public void saveAsPdf(PdfSettings settings) {
mPdfController.savePdf(null);
}
}
GeckoViewPdf.jsm
^^^^^^^^^^^^^^^^
.. code:: java
this.registerListener([
"GeckoView:SavePdf",
]);
async onEvent(aEvent, aData, aCallback) {
debug`onEvent: event=${aEvent}, data=${aData}`;
switch (aEvent) {
case "GeckoView:SavePdf":
this.saveToPDF();
Break;
}
}
}
async saveToPDF() {
// Reference: https://searchfox.org/mozilla-central/source/remote/cdp/domains/parent/Page.jsm#519
}
GeckoViewPdfController.java
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code:: java
class PdfController {
private static final String LOGTAG = "PdfController";
private final GeckoSession mSession;
PdfController(final GeckoSession session) {
mSession = session;
}
private PdfDelegate mDelegate;
private BundleEventListener mEventListener;
/* package */
PdfController() {
mEventListener = new EventListener();
EventDispatcher.getInstance()
.registerUiThreadListener(mEventListener,"GeckoView:PdfSaved");
}
@UiThread
public void setDelegate(final @Nullable PdfDelegate delegate) {
ThreadUtils.assertOnUiThread();
mDelegate = delegate;
}
@UiThread
@Nullable
public PdfDelegate getDelegate() {
ThreadUtils.assertOnUiThread();
return mDelegate;
}
@UiThread
public void savePdf() {
ThreadUtils.assertOnUiThread();
mEventDispatcher.dispatch("GeckoView:SavePdf", null);
}
private class EventListener implements BundleEventListener {
@Override
public void handleMessage(
final String event,
final GeckoBundle message,
final EventCallback callback
) {
if (mDelegate == null) {
callback.sendError("Not allowed");
return;
}
switch (event) {
case "GeckoView:PdfSaved": {
final ContentDelegate delegate = mSession.getContentDelegate();
if (message.containsKey("pdfPath")) {
InputStream inputStream; /* construct InputStream from local file path */
WebResponse response = WebResponse.Builder()
.body(inputStream)
// Add other attributes as well.
.build();
if (delegate != null) {
delegate.onExternalResponse(mSession, response);
} else {
throw Exception("Needs ContentDelegate for this to work.")
}
}
break;
}
}
}
}
}
geckoview.js
^^^^^^^^^^^^
.. code:: java
{
name: "GeckoViewPdf",
onInit: {
resource: "resource://gre/modules/GeckoViewPdf.jsm",
}
}
Testing
-------
- Tests for the jsm and java code will be covered by mochitests and junit.
- Make assertions to check that the text and images are in the finished PDF;
the PDF is a non-zero file size.
Risks
-----
The API and the code that this work would be using are pretty new, currently
pref'd off in Nightly and could contain implementation bugs.
|
