source: x/lib/qtwebengine.xml@ ceb3dc7

10.0 10.1 11.0 11.1 11.2 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since ceb3dc7 was ceb3dc7, checked in by Ken Moffat <ken@…>, 6 years ago

Build QtWebEngine separately - it often breaks when things change, doing it this ways saves the time needed to rebuild Qt5: in the full Qt5 build QtWebEngine is built at the end.

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

  • Property mode set to 100644
File size: 9.5 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.8">
8 <!ENTITY qtwebengine-download-http "https://download.qt.io/archive/qt/&qtwebengine-major;/&qtwebengine-version;/submodules/qtwebengine-opensource-src-&qtwebengine-version;.tar.xz">
9 <!ENTITY qtwebengine-download-ftp " ">
10 <!ENTITY qtwebengine-md5sum "6e7fb2be161c6db4d988a4f5b329672f">
11 <!ENTITY qtwebengine-size "187 MB">
12 <!ENTITY qtwebengine-buildsize "2.5 GB (153 MB installed including docs)">
13 <!ENTITY qtwebengine-time "43 SBU (on a 4 core processor)">
14
15<!-- Both qmake and ninja will use all available cores, in fact ninja runs n+2
16 jobs at a time. Most of our readers do not have more than 4 cores.
17 To reduce the number of available cores for measuring the build time:
18 # echo 0 > /sys/devices/system/cpu/cpu4/online
19 and repeat for each subsequent cpu. Never do this for cpu0.
20 You can cat /sys/devices/system/cpu/{online,offline} to check.
21 To reinstate the cores after measuring, echo 1 to the same files. -->
22]>
23
24<sect1 id="qtwebengine" xreflabel="qtwebengine-&qtwebengine-version;">
25 <?dbhtml filename="qtwebengine.html"?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>QtWebEngine-&qtwebengine-version;</title>
33
34 <indexterm zone="qtwebengine">
35 <primary sortas="a-qtwebengine">qtwebengine</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to QtWebEngine</title>
40
41 <para>
42 <application>QtWebEngine</application> integrates
43 <application>chromium</application>&quot;s web capabilities into Qt. It
44 ships with its own copy of <xref linkend="ninja"/> which it uses for the
45 build, and various copies of libraries from ffmpeg, icu, libvpx, and zlib
46 (including libminizip) which have been forked by the
47 <application>chromium</application> developers.
48 </para>
49
50 &lfs80_checked;
51 &gcc7_checked;
52
53 <bridgehead renderas="sect3">Package Information</bridgehead>
54 <itemizedlist spacing="compact">
55 <listitem>
56 <para>
57 Download (HTTP): <ulink url="&qtwebengine-download-http;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download (FTP): <ulink url="&qtwebengine-download-ftp;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download MD5 sum: &qtwebengine-md5sum;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download size: &qtwebengine-size;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated disk space required: &qtwebengine-buildsize;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated build time: &qtwebengine-time;
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
88 <itemizedlist spacing="compact">
89 <listitem>
90 <para>
91 Required patch:
92 <ulink url="&patch-root;/qtwebengine-&qtwebengine-version;-gcc7-1.patch"/>
93 </para>
94 </listitem>
95 </itemizedlist>
96
97 <bridgehead renderas="sect3">qtwebengine Dependencies</bridgehead>
98
99 <bridgehead renderas="sect4">Required</bridgehead>
100 <!-- the qmake output tends to be misleading. 'khr' is from Mesa -->
101 <para role="required">
102 <xref linkend="nss"/>,
103 <xref linkend="pulseaudio"/>,
104 <xref linkend='qt5'/>
105 </para>
106
107 <bridgehead renderas="sect4">Recommended</bridgehead>
108 <note>
109 <para>
110 If these packages are not installed, the build process will compile and
111 install its own (perhaps older) version, with the side effect of
112 increasing build and installed disk space and build time.
113 </para>
114 </note>
115
116 <para role="recommended">
117 <xref linkend="libwebp"/>,
118 <xref linkend="libxslt"/>,
119 <xref linkend="opus"/>
120 </para>
121
122 <bridgehead renderas="sect4">Optional</bridgehead>
123 <para role="optional">
124 <xref linkend="libevent"/>,
125 <ulink url="https://github.com/open-source-parsers/jsoncpp/releases">jsoncpp</ulink>,
126 <ulink url="https://github.com/cisco/libsrtp/releases">libsrtp</ulink>,
127 <ulink url="http://google.github.io/snappy/">snappy</ulink>
128 </para>
129
130 <para condition="html" role="usernotes">
131 User Notes: <ulink url="&blfs-wiki;/qtwebengine"/>
132 </para>
133 </sect2>
134
135 <sect2 role="installation">
136 <title>Installation of qtwebengine</title>
137
138 <para>
139 Install <application>qtwebengine</application> by running the following
140 commands:
141 </para>
142
143<screen><userinput>
144patch -Np1 -i ../qtwebengine-&qtwebengine-version;-gcc7-1.patch &amp;&amp;
145qmake -r &amp;&amp;
146make</userinput></screen>
147
148 <para>
149 if you wish to build the HTML documentation, issue:
150 </para>
151
152<screen><userinput>make docs</userinput></screen>
153
154 <para>
155 This package does not come with a test suite.
156 </para>
157
158 <para>
159 Now, as the <systemitem class="username">root</systemitem> user:
160 </para>
161
162<screen role="root"><userinput>make install &amp;&amp;
163ldconfig</userinput></screen>
164
165 <para>
166 If you built the HTML documentation, install it with:
167 </para>
168
169<screen role="root"><userinput>make install_docs</userinput></screen>
170
171 <para>
172 Remove references to the build directory from installed library
173 dependency (prl) files by running the following
174 commands as the <systemitem class="username">root</systemitem> user:
175 </para>
176
177<screen role="root"><userinput>find $QT5PREFIX/ -name \*.prl \
178 -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>
179 </sect2>
180
181 <sect2 role="commands">
182 <title>Command Explanations</title>
183
184 <para>
185 <command>qmake -r</command>: This will build the included copy of
186 <application>ninja</application> and use it to configure the build.
187 That and the subsequent <command>make</command> command will use all
188 available CPU cores.
189 </para>
190
191 </sect2>
192
193 <sect2 role="content">
194 <title>Contents</title>
195
196 <segmentedlist>
197 <segtitle>Installed Programs</segtitle>
198 <segtitle>Installed Libraries</segtitle>
199 <segtitle>Installed Directories</segtitle>
200
201 <seglistitem>
202 <seg>
203 qtwebengine_convert_dict,QtWebEngineProcess
204 </seg>
205 <seg>
206 libQt5WebEngineCore.so, libQt5WebEngine.so, libQt5WebEngineWidgets.so
207 </seg>
208 <seg>
209 $QT5PREFIX/doc/qtwebengine,
210 $QT5PREFIX/includeQtWebEngine,
211 $QT5PREFIX/include/QtWebEngineCore,
212 $QT5PREFIX/include/QtWebEngineWidgets
213 </seg>
214 </seglistitem>
215 </segmentedlist>
216
217 <variablelist>
218 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
219 <?dbfo list-presentation="list"?>
220 <?dbhtml list-presentation="table"?>
221
222 <varlistentry id="qtwebengine_convert_dict">
223 <term><command>qtwebengine_convert_dict</command></term>
224 <listitem>
225 <para>
226 converts hunspell dictionaries (<literal>.dic</literal>) to chromium
227 format (<literal>.bdic</literal>)
228 </para>
229 <indexterm zone="qtwebengine qtwebengine_convert_dict">
230 <primary sortas="b-qtwebengine_convert_dict">qtwebengine_convert_dict</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="QtWebEngineProcess">
236 <term><command>QtWebEngineProcess</command></term>
237 <listitem>
238 <para>
239 is a libexec program which runs a zygote process (one that listens
240 for spawn requests from a master process and will fork itself in
241 response).
242 </para>
243 <indexterm zone="qtwebengine QtWebEngineProcess">
244 <primary sortas="b-QtWebEngineProcess">QtWebEngineProcess</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libQtWebEngine-lib">
250 <term><filename class="libraryfile">libQtWebEngine.so</filename></term>
251 <listitem>
252 <para>
253 provides QML types for rendering web content within a QML application.
254 </para>
255 <indexterm zone="qtwebengine libQtWebEngine-lib">
256 <primary sortas="c-libQtWebEngine">libQtWebEngine.so</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="libQtWebEngineCore">
262 <term><filename class="libraryfile">libQtWebEngineCore.so</filename></term>
263 <listitem>
264 <para>
265 provides public API shared by both QtWebEngine and QtWebEngineWidgets.
266 </para>
267 <indexterm zone="qtwebengine libQtWebEngineCore">
268 <primary sortas="c-libQtWebEngineCore">libQtWebEngineCore.so</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="libQtWebEngineWidgets">
274 <term><filename class="libraryfile">libQtWebEngineWidgets.so</filename></term>
275 <listitem>
276 <para>
277 provides a web browser engine as well as C++ classes to render and
278 interact with web content.
279 </para>
280 <indexterm zone="qtwebengine libQtWebEngineWidgets">
281 <primary sortas="c-libQtWebEngineWidgets">libQtWebEngineWidgets.so</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 </variablelist>
287 </sect2>
288</sect1>
Note: See TracBrowser for help on using the repository browser.