Jump to content

Get Involved/development/Install the dependencies: Difference between revisions

From KDE Community Wiki
← Older edit
Nmariusp (talk | contribs)
992 edits
Instead of a chapter "Missing binary packages per operating system" we should create merge requests for the KDE git repo sysadmin-repo-metadata
Nmariusp (talk | contribs)
992 edits
See https://develop.kde.org/docs/getting-started/building/help-dependencies
Tag: Replaced
 
Line 1: Line 1:
If you have any trouble getting things to build due to missing 3rd-party package dependencies, read on to learn what to do. If you need help, see https://community.kde.org/Get_Involved#Contacting_The_Community.
See https://develop.kde.org/docs/getting-started/building/help-dependencies
 
== How to install the dependencies of one package ==
=== KDE neon, Debian, Ubuntu, Kubuntu ===
 
Enable <code>deb-src</code> apt repositories.
All the build dependencies for the module that you want to build can be installed by running:
 
<code>sudo apt build-dep <Debian package which corresponds to the module that you want to build></code>
 
For example, to install the build dependencies for Dolphin, run:
 
<code>sudo apt build-dep dolphin</code>
 
=== Fedora ===
If dependencies are missing for a specific RPM package, you can run:
 
<code>sudo dnf builddep <name_of_rpm_package></code>
 
For example, to install the build dependencies for Dolphin, run:
 
<code>sudo dnf builddep dolphin</code>
 
=== openSUSE ===
Generally you can install the required -devel packages that are needed to build some KDE software from source by using <code>zypper</code> (as root, or by using <code>sudo</code>), e.g. to install the -devel packages required to build dolphin from source:
{{Input|1=<nowiki>
# zypper --plus-content repo-source source-install --build-deps-only dolphin
</nowiki>}}
 
replace ''dolphin'' with some other package name, e.g. to build ''ktexteditor'' from source:
{{Input|1=<nowiki>
# zypper --plus-content repo-source source-install --build-deps-only ktexteditor
</nowiki>}}
 
Note that the <code>--plus-content</code> option in the above commands means you don't need to have the source repository enabled all the time, <code>--plus-content</code> will make zypper temporarily enable it to get the info it needs.
 
openSUSE (and most other RPM-based Linux distributions) support cmake() BuildRequires, which means you can install a development package like so:
{{Input|1=<nowiki>
# zypper install 'cmake(KF5KIO)'
</nowiki>}}
 
the part between the parenthesis ''KF5KIO'' is going to be in the error message that CMake will print in the terminal if you try to build something that requires e.g. KIO if KIO development headers aren't installed.
 
Any other dependencies can be figured out and installed as you continue building the modules one by one. For instance, to build ''Dolphin'' or ''Kate'', you will need need to also run:
 
{{Input|1=<nowiki>
# zypper install libassuan-devel makeinfo graphviz-gd
</nowiki>}}
 
== Fix CMake Error ==
 
If you run kdesrc-build in order to build a KDE git repository. And if building fails with a CMake error. Then, that is most often caused by the fact that you do not have installed some binary packages from your Linux OS.
 
See below for some ideas about how to find out what Linux packages you need to install.
 
=== Missing pkgconfig or cmake ===
 
If the CMake error looks like:
<pre>
Build-time dependency gi-docgen found: NO (tried pkgconfig and cmake)
 
docs/api/meson.build:5:15: ERROR: Dependency "gi-docgen" not found, tried pkgconfig and cmake
</pre>
 
The error here is that CMake could not find the pkgconfig named "gi-docgen" (most probably a file with the extension".pc") or the CMake file (most probably a file with the extension".cmake") that contains "gi-docgen" case insensitively in name.
 
==== Fedora ====
 
* Maybe we can find the correct package name.
 
<pre>
# Is there an rpm package with the name "gi-docgen" installed?
rpm -qa gi-docgen
# It is not installed.
 
# Is there in the package repositories an rpm with name containing "gi-docgen"?
dnf search gi-docgen
# Returns:
# Last metadata expiration check: ...
#============================================================================== Name #Exactly Matched: gi-docgen #==============================================================================
#gi-docgen.noarch : Documentation tool for GObject-based libraries
#============================================================================= Name & #Summary Matched: gi-docgen #=============================================================================
#gi-docgen-doc.noarch : Documentation for gi-docgen
#gi-docgen-fonts.noarch : Metapackage providing fonts for gi-docgen output
 
# Install the rpm gi-docgen
dnf install gi-docgen
</pre>
 
* Look for the .pc or .cmake file in the content of all rpm files in all of the enabled package repositories.
 
<pre>
dnf repoquery -l gi-docgen
# Returns:
#/usr/bin/gi-docgen
#...
#/usr/share/pkgconfig/gi-docgen.pc
 
dnf install gi-docgen
</pre>
 
* DNF knows how to install the rpm that contains a given pkgconfig file.
 
<pre>
dnf provides 'pkgconfig(gi-docgen)'
# Returns:
#gi-docgen-2023.1-9.fc39.noarch : Documentation tool for GObject-based libraries
#Repo        : fedora
#Matched from:
#Provide    : pkgconfig(gi-docgen) = 2023.1
sudo dnf install 'pkgconfig(gi-docgen)'
</pre>
 
=== Missing executable ===
 
If the CMake error looks like:
<pre>
CMake Error at /usr/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find Sass (missing: Sass_EXECUTABLE)
Call Stack (most recent call first):
  /usr/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:600 (_FPHSA_FAILURE_MESSAGE)
  cmake/modules/FindSass.cmake:48 (find_package_handle_standard_args)
  CMakeLists.txt:31 (find_package)
</pre>
 
The error here is that CMake could not find the executable named "sass" (most probably a file "/usr/bin/sass").
 
==== Fedora ====
 
* DNF knows which rpm contains a given executable.
 
<pre>
dnf provides sass
# Returns:
#rubygem-sass-3.7.4-7.fc39.noarch : A powerful but elegant CSS compiler that makes CSS fun again
#Repo        : fedora
#Matched from:
#Filename    : /usr/bin/sass
sudo dnf install rubygem-sass
</pre>
 
=== Debian/Kubuntu/KDE neon ===
 
E.g. I am on Kubuntu 22.10, <code>kdesrc-build frameworks</code> fails, module <code>kcoreaddons</code> has CMake (configure) error <code>Could NOT find Qt6LinguistTools (missing: Qt6LinguistTools_DIR)</code>.
 
Option 1:
 
Search on the internet for <code>ubuntu packages Qt6LinguistTools</code> it returns https://packages.ubuntu.com/kinetic/amd64/qt6-tools-dev Expand "amd64 [list of files]": <code>/usr/lib/x86_64-linux-gnu/cmake/Qt6LinguistTools/Qt6LinguistToolsConfig.cmake</code>
 
{{Input|1=<nowiki>
sudo apt install qt6-tools-dev
</nowiki>}}
 
Option 2:
<syntaxhighlight lang="bash">
sudo apt install apt-file
sudo apt-file update
apt-file find Qt6LinguistToolsConfig.cmake
# qt6-tools-dev: /usr/lib/x86_64-linux-gnu/cmake/Qt6LinguistTools/Qt6LinguistToolsConfig.cmake
# Or
apt-file search -i Qt6LinguistTools
# All results are from the package qt6-tools-dev e.g.:
# qt6-tools-dev: /usr/lib/x86_64-linux-gnu/cmake/Qt6LinguistTools/Qt6LinguistToolsConfig.cmake
 
sudo apt install qt6-tools-dev
</syntaxhighlight>
 
If the error is:
<syntaxhighlight lang="bash">
The imported target "Qt6::qtwaylandscanner" references the file
    "/usr/lib/qt6/libexec/qtwaylandscanner"
but this file does not exist.
</syntaxhighlight>
 
Then:
<syntaxhighlight lang="bash">
apt-file find /usr/lib/qt6/libexec/qtwaylandscanner
# qt6-wayland-dev-tools: /usr/lib/qt6/libexec/qtwaylandscanner
sudo apt install qt6-wayland-dev-tools
</syntaxhighlight>
 
Option 3:
<syntaxhighlight lang="bash">
apt search linguist | grep qt6
# linguist-qt6/kinetic 6.3.1-2 amd64
sudo apt install linguist-qt6
</syntaxhighlight>
 
More examples:
<syntaxhighlight lang="bash">
# Error "Could not find OsmTools (missing: OSMCONVERT_EXECUTABLE
apt-file search -i OSMCONVERT
# Returns "osmctools: /usr/bin/osmconvert".
sudo apt install osmctools
</syntaxhighlight>
 
<syntaxhighlight lang="bash">
# Error "Program doxygen found: NO
# doc/meson.build:6:0: ERROR: Program 'doxygen' not found or not executable"
apt-file search doxygen | grep "/doxygen$"
#doxygen: /usr/bin/doxygen
#polymake-common: /usr/share/polymake/scripts/doxygen
sudo apt install doxygen
</syntaxhighlight>
 
=== Fedora ===
 
E.g. if the error is:
<syntaxhighlight lang="bash">
Failed to find required Qt component "LinguistTools".
 
Expected Config file at
"/lib64/cmake/Qt6LinguistTools/Qt6LinguistToolsConfig.cmake" does NOT exist
</syntaxhighlight>
 
run:
<syntaxhighlight lang="bash">sudo dnf install 'cmake(Qt6LinguistTools)'</syntaxhighlight>
 
You can also search by file:
<syntaxhighlight lang="bash">dnf provides */Qt6LinguistToolsConfig.cmake
# qt6-qttools-devel-6.5.1-1.fc38.i686 : Development files for qt6-qttools
# Repo        : updates
# Matched from:
# Filename    : /usr/lib/cmake/Qt6LinguistTools/Qt6LinguistToolsConfig.cmake
</syntaxhighlight>
 
===FreeBSD===
In order to be able to run <code>sudo pkg</code> edit the file ~/.profile, uncomment the line:
<pre>
PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:$HOME/bin; export PATH
</pre>
Reboot the computer.
 
E.g. xmlto executable is missing:
<pre>
pkg search xmlto
# xmlto-0.0.28                  Front-end to an XSL toolchain
pkg install xmlto
</pre>
 
Error <code>makeinfo: not found WARNING: 'makeinfo' is missing on your system.</code>:
<pre>
pkg install pkg-provides
</pre>
Uncomment the following lines in <code>/usr/local/etc/pkg.conf</code> file
and add pkg-provides to the supported plugin list:
<pre>
PKG_PLUGINS_DIR = "/usr/local/lib/pkg/";
PKG_ENABLE_PLUGINS = true;
PLUGINS [ provides ];
</pre>
 
<pre>
pkg plugins
# NAME      DESC                                          VERSION 
# provides  A plugin for querying which package provides a particular file 0.7.3
pkg provides -u
pkg provides bin/makeinfo
# Name    : texinfo-7.0.3,1
# Comment : Typeset documentation system with multiple format output
Repo    : FreeBSD
# Filename: usr/local/bin/makeinfo
pkg install texinfo
</pre>

Latest revision as of 22:44, 6 December 2024

See https://develop.kde.org/docs/getting-started/building/help-dependencies

Retrieved from "https://community.kde.org/index.php?title=Get_Involved/development/Install_the_dependencies&oldid=102304"