source: x/lib/qtwebengine.xml@ 0c38e23

10.0 10.1 11.0 11.1 11.2 9.0 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 0c38e23 was 0c38e23, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Fix Qtwebengine URL

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21814 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY qtwebengine-major "5.13">
8 <!ENTITY qtwebengine-download-http "https://download.qt.io/archive/qt/&qtwebengine-major;/&qtwebengine-version;/submodules/qtwebengine-everywhere-src-&qtwebengine-version;.tar.xz">
9 <!ENTITY qtwebengine-download-ftp " ">
10 <!ENTITY qtwebengine-md5sum "235ecc14211ba03ae7331c175c1b7c78">
11 <!ENTITY qtwebengine-size "245 MB">
12 <!ENTITY qtwebengine-buildsize "3.5 GB (135 MB installed)">
13 <!ENTITY qtwebengine-time "62 SBU (using 4 cores)">
14]>
15
16<sect1 id="qtwebengine" xreflabel="qtwebengine-&qtwebengine-version;">
17 <?dbhtml filename="qtwebengine.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>QtWebEngine-&qtwebengine-version;</title>
25
26 <indexterm zone="qtwebengine">
27 <primary sortas="a-qtwebengine">qtwebengine</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to QtWebEngine</title>
32
33 <para>
34 <application>QtWebEngine</application> integrates
35 <application>chromium</application>'s web capabilities into Qt. It
36 ships with its own copy of ninja which it uses for the build if it cannot
37 find a system copy, and various copies of libraries from ffmpeg, icu,
38 libvpx, and zlib (including libminizip) which have been forked by the
39 <application>chromium</application> developers.
40 </para>
41
42 &lfs84_checked;
43
44 <note>
45 <para>
46 By default, ninja will use all online CPUs +2 (if at least 4 exist),
47 even if they are not available to the current task because the build
48 terminal has been restricted with 'taskset'. To work around this, see
49 the Command Explanations below.
50 </para>
51
52 <para>
53 Unusually, the shipped GN build system (used to create the Ninja files)
54 requires a static <filename class="libraryfile">libstdc++.a</filename>
55 although the installed libraries correctly use the shared version. If
56 that static library is not present, the build will fail quite quickly.
57 Please note that if you try to build webengine as part of
58 <application>Qt</application> and the static library is not available,
59 that build will either complete without installing webengine, or else fail
60 during the install (both variants have been observed in 5.12.0).
61 </para>
62 </note>
63
64 <bridgehead renderas="sect3">Package Information</bridgehead>
65 <itemizedlist spacing="compact">
66 <listitem>
67 <para>
68 Download (HTTP): <ulink url="&qtwebengine-download-http;"/>
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Download (FTP): <ulink url="&qtwebengine-download-ftp;"/>
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Download MD5 sum: &qtwebengine-md5sum;
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Download size: &qtwebengine-size;
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Estimated disk space required: &qtwebengine-buildsize;
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Estimated build time: &qtwebengine-time;
94 </para>
95 </listitem>
96 </itemizedlist>
97
98<!-- The patch is not needed anymore for 5.12.1
99 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
100 <itemizedlist spacing="compact">
101 <listitem>
102 <para>
103 Required patch (if building on i686):
104 <ulink url="&patch-root;/qtwebengine-&qtwebengine-version;-i686_alignof_fix-1.patch"/>
105 </para>
106 </listitem>
107 </itemizedlist>
108-->
109 <bridgehead renderas="sect3">qtwebengine Dependencies</bridgehead>
110
111 <bridgehead renderas="sect4">Required</bridgehead>
112 <!-- the qmake output tends to be misleading. 'khr' is from Mesa -->
113 <para role="required">
114 <xref linkend="nss"/>,
115 <xref linkend="python2"/>, and
116 <xref linkend='qt5'/>
117 </para>
118
119 <bridgehead renderas="sect4">Recommended</bridgehead>
120 <note>
121 <para>
122 If these packages are not installed, the build process will compile and
123 install its own (perhaps older) version, with the side effect of
124 increasing build and installed disk space and build time.
125 </para>
126 </note>
127
128 <para role="recommended">
129 either <xref linkend="alsa-lib"/> or
130 <xref linkend="pulseaudio"/> (or both),
131 <xref linkend="ffmpeg"/>,
132 <xref linkend="icu"/>,
133 <xref linkend="libwebp"/>,
134 <xref linkend="libxslt"/>, and
135 <xref linkend="opus"/>
136 </para>
137
138 <bridgehead renderas="sect4">Optional</bridgehead>
139 <para role="optional">
140 <xref linkend="libevent"/>,
141 <xref linkend="poppler"/>,
142 <ulink url="https://github.com/open-source-parsers/jsoncpp/releases">jsoncpp</ulink>,
143 <ulink url="https://github.com/cisco/libsrtp/releases">libsrtp</ulink>,
144 <ulink url="http://google.github.io/snappy/">snappy</ulink>
145 </para>
146
147 <para condition="html" role="usernotes">
148 User Notes: <ulink url="&blfs-wiki;/qtwebengine"/>
149 </para>
150 </sect2>
151
152 <sect2 role="installation">
153 <title>Installation of qtwebengine</title>
154
155 <para>
156 First, ensure that the local headers are available when not building as
157 part of the complete <xref linkend="qt5"/>:
158 </para>
159
160<screen><userinput>find -type f -name "*.pr[io]" |
161 xargs sed -i -e 's|INCLUDEPATH += |&amp;$$QTWEBENGINE_ROOT/include |'</userinput></screen>
162
163 <para>
164 If an older version of the package's main library has been installed,
165 when the package is built separately it will link to that in preference
166 to its own not-yet-installed version, and fail because of missing symbols.
167 Prevent that by, as the <systemitem class="username">root</systemitem>
168 user, moving the symlink out of the way.:
169 </para>
170
171<screen role="root"><userinput>if [ -e ${QT5DIR}/lib/libQtWebEngineCore.so ]; then
172 mv -v ${QT5DIR}/lib/libQtWebEngineCore.so{,.old}
173fi</userinput></screen>
174
175<!-- Not needed for 5.12.1
176 <para>
177 If you are building on a 32-bit i686 system, GCC changed the alignof
178 operator to optimize the ABI. Unfortunately, this makes the alignof()
179 operator return an incorrect number (4 instead of 8). Apply a patch to
180 fix this:
181 </para>
182
183<screen><userinput>patch -Np1 -i ../qtwebengine-&qtwebengine-version;-i686_alignof_fix-1.patch</userinput></screen>
184-->
185 <para>
186 Install <application>qtwebengine</application> by running the following
187 commands:
188 </para>
189
190<screen><userinput>mkdir build &amp;&amp;
191cd build &amp;&amp;
192
193qmake .. -- -system-ffmpeg -webengine-icu &amp;&amp;
194make</userinput></screen>
195<!--
196 <para>
197 if you wish to build the HTML documentation, issue:
198 </para>
199
200<screen><userinput>make docs</userinput></screen>
201-->
202 <para>
203 This package does not come with a test suite.
204 </para>
205
206 <para>
207 Now, as the <systemitem class="username">root</systemitem> user:
208 </para>
209
210<screen role="root"><userinput>make install</userinput></screen>
211 <!-- EDITORS NOTE: If you are updating this package, use INSTALL_ROOT=
212 instead of DESTDIR= -->
213<!--
214 <para>
215 If you built the HTML documentation, install it with:
216 </para>
217
218<screen role="root"><userinput>make install_docs</userinput></screen>
219-->
220 <para>
221 Remove references to the build directory from installed library
222 dependency (prl) files by running the following
223 commands as the <systemitem class="username">root</systemitem> user:
224 </para>
225
226<screen role="root"><userinput>find $QT5DIR/ -name \*.prl \
227 -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>
228 </sect2>
229
230 <sect2 role="commands">
231 <title>Command Explanations</title>
232
233 <para>
234 <command>qmake</command>: This will build the included copy of
235 <application>ninja</application> if it is not already installed
236 and use it to configure the build.
237 </para>
238
239 <para>
240 <command>-- -system-ffmpeg -webengine-icu</command>: If any options are
241 passed to qmake they must come after '--' which must follow '..' that points
242 to the main directory. The options here cause it to use system ffmpeg and
243 system icu. If built as part of full Qt5, the system icu is automatically
244 used (only) by Qt5Core if it is available, but unless this option is used
245 webengine will always use its shipped copy of icu, adding time and space
246 to the build.
247 </para>
248
249 <para>
250 <option>NINJAJOBS=4 make</option>: If you patched system ninja in LFS to
251 recognize the NINJAJOBS environment variable, this command will run system
252 ninja with the specified number of jobs (i.e. 4).
253 There are several reasons why you might want to do this:</para>
254
255 <itemizedlist>
256 <listitem>
257 <para> Building on a subset of CPUs allows measuring the build time
258 for that number of processors or to run other CPU-intensive tasks on
259 other cores.</para>
260 </listitem>
261 <listitem>
262 <para>Improving the build speed on a less-well endowed 4-core
263 machine. On a machine with a powerful CPU and plenty of RAM, running
264 N+2 jobs (the ninja default for 4+ cores) for the large working sets
265 of the C++ compiles in this package is typically only marginally
266 faster than running N jobs at a time. But for a machine with less
267 memory it can be much slower.</para>
268 </listitem>
269 <listitem>
270 <para>Reducing the number of cores being used on long running, CPU
271 intensive packages may alleviate heat problems.</para>
272 </listitem>
273 </itemizedlist>
274
275 </sect2>
276
277 <sect2 role="configuration">
278 <title>Configuring QtWebEngine</title>
279
280 <sect3 id="qtwebengine-config">
281 <title>Configuration Information</title>
282
283 <para>
284 If you are upgrading from an older minor version of this
285 application, for some webpages to load you may need to
286 clear the <emphasis>browser</emphasis> caches, e.g. for
287 <application>falkon</application> they will be found in
288 <filename class="directory">~/.cache/falkon/</filename>.
289 You will need to do this if the browser starts to render
290 the page and then changes to a blank tab with a message
291 that something went wrong, and a button to Retry. Even
292 after removing the old caches, you may need to retry a
293 few times for each affected tab.
294 </para>
295
296 </sect3>
297
298 </sect2>
299
300
301 <sect2 role="content">
302 <title>Contents</title>
303
304 <segmentedlist>
305 <segtitle>Installed Programs</segtitle>
306 <segtitle>Installed Libraries</segtitle>
307 <segtitle>Installed Directories</segtitle>
308
309 <seglistitem>
310 <seg>
311 qtwebengine_convert_dict and
312 QtWebEngineProcess
313 </seg>
314 <seg>
315 libQt5WebEngineCore.so,
316 libQt5WebEngine.so, and
317 libQt5WebEngineWidgets.so
318 </seg>
319 <seg>
320 $QT5PREFIX/includeQtWebEngine,
321 $QT5PREFIX/include/QtWebEngineCore, and
322 $QT5PREFIX/include/QtWebEngineWidgets
323 </seg>
324 </seglistitem>
325 </segmentedlist>
326
327 <variablelist>
328 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
329 <?dbfo list-presentation="list"?>
330 <?dbhtml list-presentation="table"?>
331
332 <varlistentry id="qtwebengine_convert_dict">
333 <term><command>qtwebengine_convert_dict</command></term>
334 <listitem>
335 <para>
336 converts hunspell dictionaries (<literal>.dic</literal>) to chromium
337 format (<literal>.bdic</literal>)
338 </para>
339 <indexterm zone="qtwebengine qtwebengine_convert_dict">
340 <primary sortas="b-qtwebengine_convert_dict">qtwebengine_convert_dict</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="QtWebEngineProcess">
346 <term><command>QtWebEngineProcess</command></term>
347 <listitem>
348 <para>
349 is a libexec program which runs a zygote process (one that listens
350 for spawn requests from a master process and will fork itself in
351 response).
352 </para>
353 <indexterm zone="qtwebengine QtWebEngineProcess">
354 <primary sortas="b-QtWebEngineProcess">QtWebEngineProcess</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="libQtWebEngine-lib">
360 <term><filename class="libraryfile">libQtWebEngine.so</filename></term>
361 <listitem>
362 <para>
363 provides QML types for rendering web content within a QML application.
364 </para>
365 <indexterm zone="qtwebengine libQtWebEngine-lib">
366 <primary sortas="c-libQtWebEngine">libQtWebEngine.so</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="libQtWebEngineCore">
372 <term><filename class="libraryfile">libQtWebEngineCore.so</filename></term>
373 <listitem>
374 <para>
375 provides public API shared by both QtWebEngine and QtWebEngineWidgets.
376 </para>
377 <indexterm zone="qtwebengine libQtWebEngineCore">
378 <primary sortas="c-libQtWebEngineCore">libQtWebEngineCore.so</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="libQtWebEngineWidgets">
384 <term><filename class="libraryfile">libQtWebEngineWidgets.so</filename></term>
385 <listitem>
386 <para>
387 provides a web browser engine as well as C++ classes to render and
388 interact with web content.
389 </para>
390 <indexterm zone="qtwebengine libQtWebEngineWidgets">
391 <primary sortas="c-libQtWebEngineWidgets">libQtWebEngineWidgets.so</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 </variablelist>
397 </sect2>
398</sect1>
Note: See TracBrowser for help on using the repository browser.