source: x/lib/qt5-alternate.xml@ 81a1d5fb

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 81a1d5fb was 81a1d5fb, checked in by Douglas R. Reno <renodr@…>, 10 months ago

qt-components: Fix building qtlocation with gcc-13.

It's not in qt5-alternate though, so we can remove the fix from that
page.
  • Property mode set to 100644
File size: 20.6 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 qt5-major "5.15">
8 <!ENTITY qt5-url "https://download.qt.io/archive/qt/&qt5-major;/&qt5-version;/single">
9
10 <!ENTITY qt5-download-http "&qt5-url;/qt-everywhere-opensource-src-&qt5-version;.tar.xz">
11 <!ENTITY qt5-download-ftp " ">
12 <!ENTITY qt5-md5sum "fb41d86bea6bc4886030a5092c910b09">
13 <!ENTITY qt5-size "629 MB">
14 <!ENTITY qt5-buildsize "8.7 GB (153 MB installed)">
15 <!ENTITY qt5-time "5.7 SBU (using parallelism=8)">
16]>
17
18<sect1 id="qt5-alternate" xreflabel="qt-alternate-&qt5-version;">
19 <?dbhtml filename="qt5-alternate.html" ?>
20
21 <title>qt-alternate-&qt5-version;</title>
22
23 <indexterm zone="qt5">
24 <primary sortas="a-Qt">Qt</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to qt5 (alternate)</title>
29
30 <para>
31 <application>Qt5</application> is a cross-platform application framework
32 that is widely used for developing application software with a graphical
33 user interface (GUI) (in which cases <application>qt5</application> is
34 classified as a widget toolkit), and also used for developing non-GUI
35 programs such as command-line tools and consoles for servers. Two of the
36 major users of <application>qt</application> are <application>KDE
37 Frameworks 5 (KF5)</application> and <application>LXQt</application>.
38 </para>
39
40 <important>
41 <para>
42 The full <application>qt5</application> packeage consists of 43 separate
43 components. These instructions use a small subset of the full
44 <application>qt5</application> installation instructions above.
45 They cover most, but not all, of the components needed to build
46 packages in BLFS. This page, and the next, are provided to
47 reduce the amount of time, space, and dependencies needed
48 to build these packages. They are not recommended if you will build
49 the <xref linkend="kf5-frameworks"/> based <xref linkend="plasma5-build"/> desktop
50 environment.
51 </para>
52 </important>
53
54 &lfs113_checked;
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>
60 Download (HTTP): <ulink url="&qt5-download-http;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download (FTP): <ulink url="&qt5-download-ftp;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download MD5 sum: &qt5-md5sum;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download size: &qt5-size;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated disk space required: &qt5-buildsize;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated build time: &qt5-time;
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
91 <itemizedlist spacing="compact">
92 <listitem>
93 <para>
94 Now that <application>qt5</application> updates are restricted to
95 commercial customers, upstream patches for the various modules are
96 being curated at kde.
97 Patches for the modules required by packages in BLFS have been
98 aggregated for the non-modular qt5 build we use.
99 </para>
100 <para>
101 Required patch:
102 <ulink url="&patch-root;/qt-everywhere-opensource-src-&qt5-version;-kf5-1.patch"/>
103 </para>
104 <para>
105 Details of the kde curation can be found at
106 <ulink url="https://dot.kde.org/2021/04/06/announcing-kdes-qt-5-patch-collection"/>
107 and <ulink url="https://community.kde.org/Qt5PatchCollection"/>.
108 </para>
109 </listitem>
110 </itemizedlist>
111
112 <bridgehead renderas="sect3">qt5 Dependencies</bridgehead>
113
114 <bridgehead renderas="sect4">Required</bridgehead>
115 <para role="required">
116 <xref linkend="xorg7-lib"/>
117 </para>
118
119 <bridgehead renderas="sect4">Recommended</bridgehead>
120 <para role="recommended">
121 <xref linkend="alsa-lib"/>,
122 <xref linkend="cups"/>,
123 <xref linkend="double-conversion"/>,
124 <xref linkend="hicolor-icon-theme"/>,
125 <xref linkend="libxkbcommon"/>,
126 <xref linkend="sqlite"/>, and
127 <xref linkend="xdg-utils"/>
128 </para>
129
130 <bridgehead renderas="sect4">Optional</bridgehead>
131 <para role="optional">
132 <xref linkend="mariadb"/>
133 or <ulink url="https://www.mysql.com/">MySQL</ulink>,
134 <xref linkend="postgresql"/>, and
135 <xref linkend="unixodbc"/>,
136 </para>
137 <!--
138 <para condition="html" role="usernotes">
139 Editor Notes: <ulink url="&blfs-wiki;/qt5"/>
140 </para>
141 -->
142 </sect2>
143
144 <sect2 role="qt5-prefix">
145 <title>Setting the installation prefix</title>
146
147 <bridgehead renderas="sect3">Installing in /opt/qt5</bridgehead>
148
149 <para>
150 The BLFS editors recommend installing <application>qt5</application> in a
151 directory other than <filename class="directory">/usr</filename>, i.e.
152 <filename class="directory">/opt/qt5</filename>. To do this, set the
153 following environment variable:
154 </para>
155
156<screen><userinput>export QT5PREFIX=/opt/qt5</userinput></screen>
157
158 <tip>
159 <para>
160 Sometimes, the installation paths are hardcoded into installed files.
161 This is the reason why <filename class="directory">/opt/qt5</filename>
162 is used as installation prefix instead of <filename
163 class="directory">/opt/qt-&qt5-version;</filename>. To create a
164 versioned <application>qt5</application> directory after the
165 installation is complete, you may rename the directory and create a symlink:
166 </para>
167
168<screen role="root"><userinput>mkdir -pv /opt/qt-&qt5-version;
169ln -sfnv qt-&qt5-version; /opt/qt5</userinput></screen>
170
171 <para>
172 Later on, you may want to install other versions of
173 <application>qt5</application>. To do that, just remove the symlink
174 and use <filename class="directory">/opt/qt5</filename> as the
175 prefix again. Which version of <application>qt5</application> you
176 use depends only on where the symlink points.
177 </para>
178 </tip>
179
180 </sect2>
181
182 <sect2 role="installation">
183 <title>Installation of qt5</title>
184
185 <warning>
186 <para>
187 If <application>qt5</application> is being reinstalled into the
188 same directory as an existing instance, run the commands done by
189 <systemitem class="username">root</systemitem>, such as
190 <command>make install</command>, from a console or non-qt5 based
191 window manager. It overwrites <application>qt5</application>
192 libraries that should not be in use during the install process.
193 </para>
194 </warning>
195
196 <caution>
197 <para>
198 If you did not install some of the recommended dependencies, examine
199 <command>./configure --help</command> output to check how to disable
200 them or use internal versions bundled in the source tarball.
201 </para>
202 </caution>
203
204 <note>
205 <para>
206 The BLFS editors do not recommend installing <application>qt5</application>
207 into the /usr hierarchy because it becomes difficult to find
208 components and to update to a new version. If you do want to install
209 <application>qt5</application> in /usr, the directories need to
210 be specified explicitly. In this case, set QT5PREFIX=/usr and add
211 the following to the configure arguments below:
212 </para>
213
214<screen role="nodump"><userinput> -archdatadir /usr/lib/qt5 \
215 -bindir /usr/bin \
216 -plugindir /usr/lib/qt5/plugins \
217 -importdir /usr/lib/qt5/imports \
218 -headerdir /usr/include/qt5 \
219 -datadir /usr/share/qt5 \
220 -docdir /usr/share/doc/qt5 \
221 -translationdir /usr/share/qt5/translations \
222 -examplesdir /usr/share/doc/qt5/examples</userinput></screen>
223 </note>
224
225 <para>
226 First, apply a patch to pull in the fixes curated by kde for those
227 modules which are required by packages mentioned in this book:
228 </para>
229
230<screen><userinput remap="pre">patch -Np1 -i ../qt-everywhere-opensource-src-&qt5-version;-kf5-1.patch</userinput></screen>
231
232 <para>
233 The patch is supposed to be used in a git repository, because the
234 behavior of the <command>configure</command> command below is changed
235 in this case. It is enough to create a
236 <filename class="directory">.git</filename> directory in the
237 <filename class="directory">qmake</filename> directory, where the
238 <command>configure</command> script is run:
239 </para>
240
241 <screen><userinput remap="pre">mkdir -pv qtbase/.git</userinput></screen>
242
243 <para>
244 At this point we want to set up skipping most components. Do that with:
245 </para>
246
247<screen><userinput>ls -Fd qt* | grep / | sed 's/^/-skip /;s@/@@' > tempconf &amp;&amp;
248sed -ir '/base|tools|x11extras|svg|declarative|wayland/d' tempconf</userinput></screen>
249
250 <para>
251 Now, install <application>qt5</application> by running the following commands:
252 </para>
253
254<screen revision="sysv"><userinput>./configure -prefix $QT5PREFIX \
255 -sysconfdir /etc/xdg \
256 -confirm-license \
257 -opensource \
258 -dbus-linked \
259 -openssl-linked \
260 -system-harfbuzz \
261 -system-sqlite \
262 -nomake examples \
263 -no-rpath \
264 -syslog \
265 $(cat tempconf) \
266 &amp;&amp;
267make</userinput></screen>
268
269<screen revision="systemd"><userinput>./configure -prefix $QT5PREFIX \
270 -sysconfdir /etc/xdg \
271 -confirm-license \
272 -opensource \
273 -dbus-linked \
274 -openssl-linked \
275 -system-harfbuzz \
276 -system-sqlite \
277 -nomake examples \
278 -no-rpath \
279 -journald \
280 $(cat tempconf) \
281 &amp;&amp;
282make</userinput></screen>
283
284 <para>
285 This package does not come with a test suite.
286 </para>
287
288 <para>
289 Now, as the <systemitem class="username">root</systemitem> user:
290 </para>
291
292<screen role="root"><userinput>make install</userinput></screen>
293
294 <!-- EDITORS NOTE: This package uses INSTALL_ROOT= instead of DESTDIR= for
295 installing in a temporary directory. -->
296
297 <para>
298 Remove references to the build directory from installed library
299 dependency (prl) <!--and profile include (pri)--> files by running the following
300 command as the <systemitem class="username">root</systemitem> user:
301 </para>
302
303<screen role="root"><userinput>find $QT5PREFIX/ -name \*.prl \
304 -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>
305
306 <para>
307 Install images and create the menu entries for installed applications.
308 The <envar>QT5BINDIR</envar> variable is used here to point to the
309 directory for the executable programs. If you have changed the bindir
310 above, <envar>QT5BINDIR</envar> will need to be adjusted below. Be sure
311 that the <envar>QT5BINDIR</envar> variable is defined in root's
312 environment and as the <systemitem class="username">root</systemitem>
313 user:
314 </para>
315
316<screen role="root"><userinput>QT5BINDIR=$QT5PREFIX/bin
317
318install -v -dm755 /usr/share/pixmaps/ &amp;&amp;
319
320install -v -Dm644 qttools/src/assistant/assistant/images/assistant-128.png \
321 /usr/share/pixmaps/assistant-qt5.png &amp;&amp;
322
323install -v -Dm644 qttools/src/designer/src/designer/images/designer.png \
324 /usr/share/pixmaps/designer-qt5.png &amp;&amp;
325
326install -v -Dm644 qttools/src/linguist/linguist/images/icons/linguist-128-32.png \
327 /usr/share/pixmaps/linguist-qt5.png &amp;&amp;
328
329install -v -Dm644 qttools/src/qdbus/qdbusviewer/images/qdbusviewer-128.png \
330 /usr/share/pixmaps/qdbusviewer-qt5.png &amp;&amp;
331
332install -dm755 /usr/share/applications &amp;&amp;
333
334cat &gt; /usr/share/applications/assistant-qt5.desktop &lt;&lt; EOF
335<literal>[Desktop Entry]
336Name=Qt5 Assistant
337Comment=Shows Qt5 documentation and examples
338Exec=$QT5BINDIR/assistant
339Icon=assistant-qt5.png
340Terminal=false
341Encoding=UTF-8
342Type=Application
343Categories=Qt;Development;Documentation;</literal>
344EOF
345
346cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
347<literal>[Desktop Entry]
348Name=Qt5 Designer
349GenericName=Interface Designer
350Comment=Design GUIs for Qt5 applications
351Exec=$QT5BINDIR/designer
352Icon=designer-qt5.png
353MimeType=application/x-designer;
354Terminal=false
355Encoding=UTF-8
356Type=Application
357Categories=Qt;Development;</literal>
358EOF
359
360cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
361<literal>[Desktop Entry]
362Name=Qt5 Linguist
363Comment=Add translations to Qt5 applications
364Exec=$QT5BINDIR/linguist
365Icon=linguist-qt5.png
366MimeType=text/vnd.trolltech.linguist;application/x-linguist;
367Terminal=false
368Encoding=UTF-8
369Type=Application
370Categories=Qt;Development;</literal>
371EOF
372
373cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
374<literal>[Desktop Entry]
375Name=Qt5 QDbusViewer
376GenericName=D-Bus Debugger
377Comment=Debug D-Bus applications
378Exec=$QT5BINDIR/qdbusviewer
379Icon=qdbusviewer-qt5.png
380Terminal=false
381Encoding=UTF-8
382Type=Application
383Categories=Qt;Development;Debugger;</literal>
384EOF</userinput></screen>
385
386 <para>
387 Some packages such as <xref linkend='vlc'/> look for certain
388 executables with a -qt5 suffix. Run the following command as the
389 <systemitem class="username">root</systemitem> user
390 to create the necessary symlinks:
391 </para>
392
393<screen role="root"><userinput>for file in moc uic rcc qmake lconvert lrelease lupdate; do
394 ln -sfrvn $QT5BINDIR/$file /usr/bin/$file-qt5
395done</userinput></screen>
396
397 </sect2>
398
399 <sect2 role="commands">
400 <title>Command Explanations</title>
401
402 <para>
403 <parameter>-confirm-license</parameter>: Accept license
404 without prompting user during configuration.
405 </para>
406
407 <para>
408 <parameter>-opensource</parameter>: Install the opensource
409 version of <application>qt</application>.
410 </para>
411
412 <para>
413 <parameter>-nomake examples</parameter>: This switch
414 disables building of the example programs included
415 in the source tarball. Remove it if you want to build
416 them.
417 </para>
418
419 <para>
420 <parameter>-system-sqlite</parameter>: This switch enables use
421 of the system version of <application>SQLite</application>.
422 </para>
423
424 <para>
425 <parameter>-system-harfbuzz</parameter>: This switch enables use
426 of the system version of <application>Harfbuzz</application>.
427 </para>
428
429 <para>
430 <parameter>-dbus-linked -openssl-linked</parameter>: These
431 switches enable explicit linking of the
432 <application>D-Bus</application> and
433 <application>OpenSSL</application> libraries into
434 <application>qt5</application> libraries instead of
435 <command>dlopen()</command>-ing them.
436 </para>
437
438 <para revision="sysv">
439 <parameter>-syslog</parameter>: This switch allows to send qt messages
440 to the <command>syslog</command> logging system.
441 </para>
442
443 <para revision="systemd">
444 <parameter>-journald</parameter>: This switch allows to send qt messages
445 to the <command>journald</command> logging system.
446 </para>
447
448 <para>
449 <parameter>-skip qtwebengine</parameter>: This switch disables building
450 the QtWebEngine. The BLFS editors have chosen to build <xref
451 linkend="qtwebengine"/> separately.
452 </para>
453 <para>
454 <command>$(cat tempconf)</command>: This command provides a list of
455 components that should not be built. These entries are in the form of
456 "-skip &lt;component&gt;".
457 </para>
458
459 </sect2>
460
461 <sect2 role="configuration">
462 <title>Configuring qt5</title>
463
464 <sect3 id="qt5-alt-config">
465 <title>Configuration Information</title>
466
467 <para>
468 If <xref linkend="sudo"/> is installed, QT5DIR should be available to
469 the super user as well. Execute the following commands as the
470 <systemitem class="username">root</systemitem> user:
471 </para>
472
473<screen role="root"><userinput>cat &gt; /etc/sudoers.d/qt &lt;&lt; "EOF"
474<literal>Defaults env_keep += QT5DIR</literal>
475EOF</userinput></screen>
476
477 <bridgehead renderas="sect4">If you installed qt5 in /usr</bridgehead>
478
479 <para>
480 If you installed <application>qt5</application> in
481 <filename class="directory">/usr</filename>, create an
482 environment variable needed by certain packages.
483 As the <systemitem class="username">root</systemitem> user:
484 </para>
485
486<screen role="nodump"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
487<literal># Begin /etc/profile.d/qt5.sh
488
489QT5DIR=/usr
490export QT5DIR
491pathappend $QT5DIR/bin
492
493# End /etc/profile.d/qt5.sh</literal>
494EOF</userinput></screen>
495
496 <bridgehead renderas="sect4">If you did not install qt5 in /usr</bridgehead>
497
498 <para>
499 If you installed <application>qt5</application> in a location other
500 than <filename class="directory">/usr</filename>, you need to update the
501 following configuration files so that <application>qt5</application> is
502 correctly found by other packages and system processes.
503 </para>
504
505 <para>
506 As the <systemitem class="username">root</systemitem> user, update
507 the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
508 run-time cache file:
509 </para>
510
511<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
512<literal># Begin Qt addition
513
514/opt/qt5/lib
515
516# End Qt addition</literal>
517EOF
518
519ldconfig</userinput></screen>
520
521 <indexterm zone="qt5 qt5-config">
522 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
523 </indexterm>
524
525 <para>
526 As the <systemitem class="username">root</systemitem> user, create
527 the <filename>/etc/profile.d/qt5.sh</filename> file:
528 </para>
529
530<screen role="root"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
531<literal># Begin /etc/profile.d/qt5.sh
532
533QT5DIR=/opt/qt5
534
535pathappend $QT5DIR/bin PATH
536pathappend $QT5DIR/lib/pkgconfig PKG_CONFIG_PATH
537
538export QT5DIR
539
540# End /etc/profile.d/qt5.sh</literal>
541EOF</userinput></screen>
542
543 </sect3>
544
545 </sect2>
546
547 <sect2 role="content">
548 <title>Contents</title>
549
550 <segmentedlist>
551 <segtitle>Installed Programs</segtitle>
552 <segtitle>Installed Libraries</segtitle>
553 <segtitle>Installed Directories</segtitle>
554
555 <seglistitem>
556 <seg>
557 assistant, designer, fixqt4headers.pl, lconvert,
558 linguist, lprodump, lrelease, lrelease-pro, lupdate, lupdate-pro,
559 moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
560 qdbusviewer, qdbusxml2cpp, qdistancefieldgenerator, qdoc,
561 qhelpgenerator, qlalr, qmake, qml, qmlcachegen, qmleasing,
562 qmlformat, qmlimportscanner, qmllint, qmlmin, qmlplugindump,
563 qmlpreview, qmlprofiler, qmlscene, qmltestrunner, qmltime,
564 qmltyperegistrar,
565 qtattributionscanner, qtdiag, qtpaths, qtplugininfo,
566 qtwaylandscanner, qvkgen, rcc, syncqt.pl, tracegen, and
567 uic
568 </seg>
569 <seg>
570 libQt5Concurrent.so,
571 libQt5Core.so,
572 libQt5DBus.so,
573 libQt5Designer.so,
574 libQt5DesignerComponents.so,
575 libQt5EglFSDeviceIntegration.so,
576 libQt5EglFsKmsSupport.so,
577 libQt5Gui.so,
578 libQt5Help.so,
579 libQt5Network.so,
580 libQt5OpenGL.so,
581 libQt5PrintSupport.so,
582 libQt5Qml.so,
583 libQt5QmlModels.so,
584 libQt5QmlWorkerScript.so,
585 libQt5Quick.so,
586 libQt5QuickParticles.so,
587 libQt5QuickShapes.so,
588 libQt5QuickTest.so,
589 libQt5WaylandClient.so,
590 libQt5WaylandCompositor.so,
591 libQt5Widgets.so,
592 libQt5X11Extras.so,
593 libQt5XcbQpa.so,
594 libQt5Xml.so,
595 several static libraries,
596 and several plugins under /opt/qt5/{plugins,qml}
597 </seg>
598 <seg>
599 /usr/include/qt5,
600 /usr/lib/qt5,
601 /usr/share/doc/qt5, and
602 /usr/share/qt5
603 OR
604 /opt/qt5 and
605 /opt/qt-&qt5-version;
606 </seg>
607 </seglistitem>
608 </segmentedlist>
609
610 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
611 <para>See <xref linkend="qt5-descriptions"/></para>
612
613
614 </sect2>
615
616</sect1>
Note: See TracBrowser for help on using the repository browser.