1 # Copyright 1999-2018 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
7 # @BLURB: Support eclass for packages that follow KDE packaging conventions.
9 # This eclass is intended to streamline the creation of ebuilds for packages
10 # that follow KDE upstream packaging conventions. It's primarily intended for
11 # the three upstream release groups (Frameworks, Plasma, Applications) but
12 # is also for any package that follows similar conventions.
14 # This eclass unconditionally inherits kde5-functions.eclass and all its public
15 # functions and variables may be considered as part of this eclass's API.
17 # This eclass unconditionally inherits cmake-utils.eclass and all its public
18 # variables and helper functions (not phase functions) may be considered as part
19 # of this eclass's API.
21 # This eclass's phase functions are not intended to be mixed and matched, so if
22 # any phase functions are overriden the version here should also be called.
24 if [[ -z ${_KDE5_ECLASS} ]]; then
27 # @ECLASS-VARIABLE: VIRTUALX_REQUIRED
29 # For proper description see virtualx.eclass manpage.
30 # Here we redefine default value to be manual, if your package needs virtualx
31 # for tests you should proceed with setting VIRTUALX_REQUIRED=test.
32 : ${VIRTUALX_REQUIRED:=manual}
34 inherit cmake-utils eutils flag-o-matic gnome2-utils kde5-functions versionator virtualx xdg
36 if [[ ${KDE_BUILD_TYPE} = live ]]; then
38 git) inherit git-r3 ;;
42 if [[ -v KDE_GCC_MINIMAL ]]; then
43 EXPORT_FUNCTIONS pkg_pretend
46 EXPORT_FUNCTIONS pkg_setup pkg_nofetch src_unpack src_prepare src_configure src_compile src_test src_install pkg_preinst pkg_postinst pkg_postrm
48 # @ECLASS-VARIABLE: KDE_AUTODEPS
50 # If set to "false", do nothing.
51 # For any other value, add dependencies on dev-qt/qtcore:5, kde-frameworks/kf-env
52 # and kde-frameworks/extra-cmake-modules:5. Additionally, required blockers may
53 # be set depending on the value of CATEGORY.
54 : ${KDE_AUTODEPS:=true}
56 # @ECLASS-VARIABLE: KDE_BLOCK_SLOT4
58 # This variable only has any effect when when CATEGORY = "kde-apps" and
59 # KDE_AUTODEPS is also set. If set to "true", add RDEPEND block on kde-apps/${PN}:4
60 : ${KDE_BLOCK_SLOT4:=true}
62 # @ECLASS-VARIABLE: KDE_DEBUG
64 # If set to "false", add -DNDEBUG (via cmake-utils_src_configure) and -DQT_NO_DEBUG
66 # Otherwise, add debug to IUSE.
69 # @ECLASS-VARIABLE: KDE_DESIGNERPLUGIN
71 # If set to "false", do nothing.
72 # Otherwise, add "designer" to IUSE to toggle build of designer plugins
73 # and add the necessary DEPENDs.
74 : ${KDE_DESIGNERPLUGIN:=false}
76 # @ECLASS-VARIABLE: KDE_EXAMPLES
78 # If set to "false", unconditionally ignore a top-level examples subdirectory.
79 # Otherwise, add "examples" to IUSE to toggle adding that subdirectory.
80 : ${KDE_EXAMPLES:=false}
82 # @ECLASS-VARIABLE: KDE_HANDBOOK
84 # If set to "false", do nothing.
85 # Otherwise, add "+handbook" to IUSE, add the appropriate dependency, and
86 # generate and install KDE handbook.
87 # If set to "optional", config with -DCMAKE_DISABLE_FIND_PACKAGE_KF5DocTools=ON
88 # when USE=!handbook. In case package requires KF5KDELibs4Support, see next:
89 # If set to "forceoptional", remove a KF5DocTools dependency from the root
90 # CMakeLists.txt in addition to the above.
91 : ${KDE_HANDBOOK:=false}
93 # @ECLASS-VARIABLE: KDE_DOC_DIR
95 # Specifies the location of the KDE handbook if not the default.
98 # @ECLASS-VARIABLE: KDE_PO_DIRS
100 # Specifies the possible locations of KDE l10n files if not the default.
101 : ${KDE_PO_DIRS:="po poqm"}
103 # @ECLASS-VARIABLE: KDE_QTHELP
105 # If set to "false", do nothing.
106 # Otherwise, add "doc" to IUSE, add the appropriate dependency, generate
107 # and install Qt compressed help files with -DBUILD_QCH=ON when USE=doc.
108 if [[ ${CATEGORY} = kde-frameworks ]]; then
109 : ${KDE_QTHELP:=true}
111 : ${KDE_QTHELP:=false}
113 # @ECLASS-VARIABLE: KDE_TESTPATTERN
115 # DANGER: Only touch it if you know what you are doing.
116 # By default, matches autotest(s), unittest(s) and test(s) pattern inside
117 # cmake add_subdirectory calls.
118 : ${KDE_TESTPATTERN:="\(auto|unit\)\?tests\?"}
120 # @ECLASS-VARIABLE: KDE_TEST
122 # If set to "false", do nothing.
123 # For any other value, add test to IUSE and add a dependency on dev-qt/qttest:5.
124 # If set to "optional", configure with -DCMAKE_DISABLE_FIND_PACKAGE_Qt5Test=ON
126 # If set to "forceoptional", remove a Qt5Test dependency and comment test
127 # subdirs from the root CMakeLists.txt in addition to the above.
128 # If set to "forceoptional-recursive", remove Qt5Test dependencies and make
129 # test subdirs according to KDE_TESTPATTERN from *any* CMakeLists.txt in ${S}
130 # and below conditional on BUILD_TESTING. This is always meant as a short-term
131 # fix and creates ${T}/${P}-tests-optional.patch to refine and submit upstream.
132 if [[ ${CATEGORY} = kde-frameworks ]]; then
137 # @ECLASS-VARIABLE: KDE_SELINUX_MODULE
139 # If set to "none", do nothing.
140 # For any other value, add selinux to IUSE, and depending on that useflag
141 # add a dependency on sec-policy/selinux-${KDE_SELINUX_MODULE} to (R)DEPEND.
142 : ${KDE_SELINUX_MODULE:=none}
144 # @ECLASS-VARIABLE: KDE_SUBSLOT
146 # If set to "false", do nothing.
147 # If set to "true", add a subslot to the package, where subslot is either
148 # defined as major.minor version for kde-*/ categories or ${PV} if other.
149 # For any other value, that value will be used as subslot.
150 : ${KDE_SUBSLOT:=false}
152 # @ECLASS-VARIABLE: KDE_UNRELEASED
155 # An array of $CATEGORY-$PV pairs of packages that are unreleased upstream.
156 # Any package matching this will have fetch restriction enabled, and receive
157 # a proper error message via pkg_nofetch.
160 if [[ ${KDEBASE} = kdevelop ]]; then
161 HOMEPAGE="https://www.kdevelop.org/"
162 elif [[ ${KMNAME} = kdepim ]]; then
163 HOMEPAGE="https://www.kde.org/applications/office/kontact/"
165 HOMEPAGE="https://www.kde.org/"
172 if [[ ${CATEGORY} = kde-frameworks ]]; then
176 case ${KDE_SUBSLOT} in
183 SLOT+="/$(get_version_component_range 1-2)"
191 SLOT+="/${KDE_SUBSLOT}"
195 case ${KDE_AUTODEPS} in
198 DEPEND+=" $(add_frameworks_dep extra-cmake-modules)"
199 RDEPEND+=" >=kde-frameworks/kf-env-4"
200 COMMONDEPEND+=" $(add_qt_dep qtcore)"
202 # all packages need breeze/oxygen icons for basic iconset, bug #564838
203 if [[ ${PN} != breeze-icons && ${PN} != oxygen-icons ]]; then
204 RDEPEND+=" || ( $(add_frameworks_dep breeze-icons) kde-frameworks/oxygen-icons:* )"
210 RDEPEND+=" !<kde-apps/kde4-l10n-15.12.3-r1"
213 [[ ${KDE_BLOCK_SLOT4} = true ]] && RDEPEND+=" !kde-apps/${PN}:4"
214 [[ $(get_version_component_range 1) -ge 17 ]] && \
217 !<kde-apps/kde4-l10n-16.12.0:4
218 !kde-apps/kdepim-l10n:5
232 case ${KDE_DESIGNERPLUGIN} in
236 DEPEND+=" designer? ( $(add_frameworks_dep kdesignerplugin) )"
237 [[ ${PV} = 17.08* ]] && \
238 DEPEND+=" designer? ( $(add_qt_dep designer) )"
242 case ${KDE_EXAMPLES} in
249 case ${KDE_HANDBOOK} in
253 DEPEND+=" handbook? ( $(add_frameworks_dep kdoctools) )"
257 case ${KDE_QTHELP} in
261 COMMONDEPEND+=" doc? ( $(add_qt_dep qt-docs) )"
264 >=app-doc/doxygen-1.8.13-r1
273 DEPEND+=" test? ( $(add_qt_dep qttest) )"
277 case ${KDE_SELINUX_MODULE} in
281 RDEPEND+=" selinux? ( sec-policy/selinux-${KDE_SELINUX_MODULE} )"
285 DEPEND+=" ${COMMONDEPEND} dev-util/desktop-file-utils"
286 RDEPEND+=" ${COMMONDEPEND}"
289 if [[ -n ${KMNAME} && ${KMNAME} != ${PN} && ${KDE_BUILD_TYPE} = release ]]; then
290 S=${WORKDIR}/${KMNAME}-${PV}
293 if [[ -n ${KDEBASE} && ${KDEBASE} = kdevelop && ${KDE_BUILD_TYPE} = release ]]; then
294 if [[ -n ${KMNAME} ]]; then
295 S=${WORKDIR}/${KMNAME}-${PV}
301 _kde_is_unreleased() {
303 for pair in "${KDE_UNRELEASED[@]}" ; do
304 if [[ "${pair}" = "${CATEGORY}-${PV}" ]]; then
312 # Determine fetch location for released tarballs
313 _calculate_src_uri() {
314 debug-print-function ${FUNCNAME} "$@"
318 if [[ -n ${KMNAME} ]]; then
331 _kmname="portingAids/${_kmname}"
335 DEPEND+=" app-arch/xz-utils"
340 ??.?.[6-9]? | ??.??.[6-9]? )
341 SRC_URI="mirror://kde/unstable/applications/${PV}/src/${_kmname}-${PV}.tar.xz"
345 SRC_URI="mirror://kde/stable/applications/${PV}/src/${_kmname}-${PV}.tar.xz" ;;
349 SRC_URI="mirror://kde/stable/frameworks/${PV%.*}/${_kmname}-${PV}.tar.xz" ;;
351 local plasmapv=$(get_version_component_range 1-3)
354 5.?.[6-9]? | 5.??.[6-9]? )
355 # Plasma 5 beta releases
356 SRC_URI="mirror://kde/unstable/plasma/${plasmapv}/${_kmname}-${PV}.tar.xz"
360 # Plasma 5 stable releases
361 SRC_URI="mirror://kde/stable/plasma/${plasmapv}/${_kmname}-${PV}.tar.xz" ;;
366 if [[ -z ${SRC_URI} && -n ${KDEBASE} ]] ; then
372 _kdebase=${KDEBASE} ;;
376 SRC_URI="mirror://kde/unstable/${_kdebase}/${PV}/src/${_kmname}-${PV}.tar.xz"
380 SRC_URI="mirror://kde/stable/${_kdebase}/${PV}/src/${_kmname}-${PV}.tar.xz" ;;
385 if _kde_is_unreleased ; then
390 # Determine fetch location for live sources
391 _calculate_live_repo() {
392 debug-print-function ${FUNCNAME} "$@"
398 # @ECLASS-VARIABLE: EGIT_MIRROR
400 # This variable allows easy overriding of default kde mirror service
401 # (anongit) with anything else you might want to use.
402 EGIT_MIRROR=${EGIT_MIRROR:=https://anongit.kde.org}
406 # @ECLASS-VARIABLE: EGIT_REPONAME
408 # This variable allows overriding of default repository
409 # name. Specify only if this differ from PN and KMNAME.
410 if [[ -n ${EGIT_REPONAME} ]]; then
411 # the repository and kmname different
412 _kmname=${EGIT_REPONAME}
413 elif [[ -n ${KMNAME} ]]; then
419 if [[ ${PV} == ??.??.49.9999 && ${CATEGORY} = kde-apps ]]; then
420 EGIT_BRANCH="Applications/$(get_version_component_range 1-2)"
423 if [[ ${PV} != 9999 && ${CATEGORY} = kde-plasma ]]; then
424 EGIT_BRANCH="Plasma/$(get_version_component_range 1-2)"
427 EGIT_REPO_URI="${EGIT_MIRROR}/${_kmname}"
432 case ${KDE_BUILD_TYPE} in
433 live) _calculate_live_repo ;;
434 *) _calculate_src_uri ;;
437 debug-print "${LINENO} ${ECLASS} ${FUNCNAME}: SRC_URI is ${SRC_URI}"
439 # @FUNCTION: kde5_pkg_pretend
441 # Checks if the active compiler meets the minimum version requirements.
442 # phase function is only exported if KDE_GCC_MINIMAL is defined.
444 debug-print-function ${FUNCNAME} "$@"
448 # @FUNCTION: kde5_pkg_setup
450 # Checks if the active compiler meets the minimum version requirements.
452 debug-print-function ${FUNCNAME} "$@"
456 # @FUNCTION: kde5_pkg_nofetch
458 # Intended for use in the KDE overlay. If this package matches something in
459 # KDE_UNRELEASED, display a giant warning that the package has not yet been
460 # released upstream and should not be used.
462 if ! _kde_is_unreleased ; then
466 eerror " _ _ _ _ ____ _____ _ _____ _ ____ _____ ____ "
467 eerror "| | | | \ | | _ \| ____| | | ____| / \ / ___|| ____| _ \ "
468 eerror "| | | | \| | |_) | _| | | | _| / _ \ \___ \| _| | | | |"
469 eerror "| |_| | |\ | _ <| |___| |___| |___ / ___ \ ___) | |___| |_| |"
470 eerror " \___/|_| \_|_| \_\_____|_____|_____/_/ \_\____/|_____|____/ "
472 eerror " ____ _ ____ _ __ _ ____ _____ "
473 eerror "| _ \ / \ / ___| |/ / / \ / ___| ____|"
474 eerror "| |_) / _ \| | | ' / / _ \| | _| _| "
475 eerror "| __/ ___ \ |___| . \ / ___ \ |_| | |___ "
476 eerror "|_| /_/ \_\____|_|\_\/_/ \_\____|_____|"
478 eerror "${CATEGORY}/${P} has not been released to the public yet"
479 eerror "and is only available to packagers right now."
481 eerror "This is not a bug. Please do not file bugs or contact upstream about this."
483 eerror "Please consult the upstream release schedule to see when this "
484 eerror "package is scheduled to be released:"
485 eerror "https://community.kde.org/Schedules"
488 # @FUNCTION: kde5_src_unpack
490 # Unpack the sources, automatically handling both release and live ebuilds.
492 debug-print-function ${FUNCNAME} "$@"
494 if [[ ${KDE_BUILD_TYPE} = live ]]; then
505 # @FUNCTION: kde5_src_prepare
507 # Wrapper for cmake-utils_src_prepare with lots of extra logic for magic
508 # handling of linguas, tests, handbook etc.
510 debug-print-function ${FUNCNAME} "$@"
512 cmake-utils_src_prepare
514 # only build examples when required
515 if ! use_if_iuse examples || ! use examples ; then
516 cmake_comment_add_subdirectory examples
519 # only enable handbook when required
520 if ! use_if_iuse handbook ; then
521 cmake_comment_add_subdirectory ${KDE_DOC_DIR}
523 if [[ ${KDE_HANDBOOK} = forceoptional ]] ; then
524 punt_bogus_dep KF5 DocTools
525 sed -i -e "/kdoctools_install/ s/^/#DONT/" CMakeLists.txt || die
529 # drop translations when nls is not wanted
530 if in_iuse nls && ! use nls ; then
532 for po in ${KDE_PO_DIRS}; do
533 if [[ -d ${po} ]] ; then
539 # enable only the requested translations when required
540 if [[ -v LINGUAS ]] ; then
542 for po in ${KDE_PO_DIRS}; do
543 if [[ -d ${po} ]] ; then
544 pushd ${po} > /dev/null || die
547 if [[ -e ${lang} ]] && ! has ${lang/.po/} ${LINGUAS} ; then
552 *) rm -r ${lang} || die ;;
554 if [[ -e CMakeLists.txt ]] ; then
555 cmake_comment_add_subdirectory ${lang}
556 sed -e "/add_subdirectory([[:space:]]*${lang}\/.*[[:space:]]*)/d" \
557 -i CMakeLists.txt || die
561 popd > /dev/null || die
566 if [[ ${KDE_BUILD_TYPE} = release && ${CATEGORY} != kde-apps ]] ; then
567 if [[ ${KDE_HANDBOOK} != false && -d ${KDE_DOC_DIR} && -v LINGUAS ]] ; then
568 pushd ${KDE_DOC_DIR} > /dev/null || die
571 if ! has ${lang} ${LINGUAS} ; then
572 cmake_comment_add_subdirectory ${lang}
575 popd > /dev/null || die
579 # only build unit tests when required
580 if ! use_if_iuse test ; then
581 if [[ ${KDE_TEST} = forceoptional ]] ; then
582 punt_bogus_dep Qt5 Test
583 # if forceoptional, also cover non-kde categories
584 cmake_comment_add_subdirectory autotests test tests
585 elif [[ ${KDE_TEST} = forceoptional-recursive ]] ; then
586 punt_bogus_dep Qt5 Test
587 local f pf="${T}/${P}"-tests-optional.patch
588 touch ${pf} || die "Failed to touch patch file"
589 for f in $(find . -type f -name "CMakeLists.txt" -exec \
590 grep -l "^\s*add_subdirectory\s*\(\s*.*${KDE_TESTPATTERN}\s*)\s*\)" {} \;); do
591 cp ${f} ${f}.old || die "Failed to prepare patch origfile"
592 pushd ${f%/*} > /dev/null || die
593 punt_bogus_dep Qt5 Test
594 sed -i CMakeLists.txt -e \
595 "/^#/! s/add_subdirectory\s*\(\s*.*${KDE_TESTPATTERN}\s*)\s*\)/if(BUILD_TESTING)\n&\nendif()/" \
597 popd > /dev/null || die
598 diff -Naur ${f}.old ${f} 1>>${pf}
599 rm ${f}.old || die "Failed to clean up"
601 einfo "Build system was modified by KDE_TEST=forceoptional-recursive."
602 einfo "Unified diff file ready for pickup in:"
604 einfo "Push it upstream to make this message go away."
605 elif [[ ${CATEGORY} = kde-frameworks || ${CATEGORY} = kde-plasma || ${CATEGORY} = kde-apps ]] ; then
606 cmake_comment_add_subdirectory autotests test tests
610 # in frameworks, tests = manual tests so never build them
611 if [[ ${CATEGORY} = kde-frameworks ]] && [[ ${PN} != extra-cmake-modules ]]; then
612 cmake_comment_add_subdirectory tests
616 # @FUNCTION: kde5_src_configure
618 # Wrapper for cmake-utils_src_configure with extra logic for magic handling of
619 # handbook, tests etc.
620 kde5_src_configure() {
621 debug-print-function ${FUNCNAME} "$@"
623 # we rely on cmake-utils.eclass to append -DNDEBUG too
624 if ! use_if_iuse debug; then
625 append-cppflags -DQT_NO_DEBUG
630 if in_iuse test && ! use test ; then
631 cmakeargs+=( -DBUILD_TESTING=OFF )
633 if [[ ${KDE_TEST} = optional ]] ; then
634 cmakeargs+=( -DCMAKE_DISABLE_FIND_PACKAGE_Qt5Test=ON )
638 if ! use_if_iuse handbook && [[ ${KDE_HANDBOOK} = optional ]] ; then
639 cmakeargs+=( -DCMAKE_DISABLE_FIND_PACKAGE_KF5DocTools=ON )
642 if ! use_if_iuse designer && [[ ${KDE_DESIGNERPLUGIN} != false ]] ; then
643 if [[ ${PV} = 17.08* ]]; then
644 cmakeargs+=( -DCMAKE_DISABLE_FIND_PACKAGE_Qt5Designer=ON )
646 cmakeargs+=( -DCMAKE_DISABLE_FIND_PACKAGE_KF5DesignerPlugin=ON )
650 if [[ ${KDE_QTHELP} != false ]]; then
651 cmakeargs+=( -DBUILD_QCH=$(usex doc) )
654 # install mkspecs in the same directory as qt stuff
655 cmakeargs+=(-DKDE_INSTALL_USE_QT_SYS_PATHS=ON)
657 # allow the ebuild to override what we set here
658 mycmakeargs=("${cmakeargs[@]}" "${mycmakeargs[@]}")
660 cmake-utils_src_configure
663 # @FUNCTION: kde5_src_compile
665 # Wrapper for cmake-utils_src_compile. Currently doesn't do anything extra, but
666 # is included as part of the API just in case it's needed in the future.
668 debug-print-function ${FUNCNAME} "$@"
670 cmake-utils_src_compile "$@"
673 # @FUNCTION: kde5_src_test
675 # Wrapper for cmake-utils_src_test with extra logic for magic handling of dbus
678 debug-print-function ${FUNCNAME} "$@"
681 if [[ -n "${VIRTUALDBUS_TEST}" ]]; then
682 export $(dbus-launch)
688 # When run as normal user during ebuild development with the ebuild command, the
689 # kde tests tend to access the session DBUS. This however is not possible in a real
690 # emerge or on the tinderbox.
691 # > make sure it does not happen, so bad tests can be recognized and disabled
692 unset DBUS_SESSION_BUS_ADDRESS DBUS_SESSION_BUS_PID
694 if [[ ${VIRTUALX_REQUIRED} = always || ${VIRTUALX_REQUIRED} = test ]]; then
700 if [[ -n "${DBUS_SESSION_BUS_PID}" ]] ; then
701 kill ${DBUS_SESSION_BUS_PID}
705 # @FUNCTION: kde5_src_install
707 # Wrapper for cmake-utils_src_install with extra logic to avoid compressing
708 # certain types of files. For example, khelpcenter is not able to read
709 # compressed handbooks.
711 debug-print-function ${FUNCNAME} "$@"
713 cmake-utils_src_install
715 # We don't want QCH and tags files to be compressed, because then
716 # cmake can't find the tags and qthelp viewers can't find the docs
717 local p=$(best_version dev-qt/qtcore:5)
718 local pv=$(echo ${p/%-r[0-9]*/} | rev | cut -d - -f 1 | rev)
719 if [[ -d ${ED%/}/usr/share/doc/qt-${pv} ]]; then
720 docompress -x /usr/share/doc/qt-${pv}
723 # We don't want /usr/share/doc/HTML to be compressed,
724 # because then khelpcenter can't find the docs
725 if [[ -d ${ED%/}/usr/share/doc/HTML ]]; then
726 docompress -x /usr/share/doc/HTML
730 # @FUNCTION: kde5_pkg_preinst
732 # Sets up environment variables required in kde5_pkg_postinst.
734 debug-print-function ${FUNCNAME} "$@"
740 # @FUNCTION: kde5_pkg_postinst
742 # Updates the various XDG caches (icon, desktop, mime) if necessary.
743 kde5_pkg_postinst() {
744 debug-print-function ${FUNCNAME} "$@"
746 if [[ -n ${GNOME2_ECLASS_ICONS} ]]; then
747 gnome2_icon_cache_update
751 if [[ -z ${I_KNOW_WHAT_I_AM_DOING} ]]; then
752 if [[ ${KDE_BUILD_TYPE} = live ]]; then
754 einfo "WARNING! This is an experimental live ebuild of ${CATEGORY}/${PN}"
755 einfo "Use it at your own risk."
756 einfo "Do _NOT_ file bugs at bugs.gentoo.org because of this ebuild!"
761 # @FUNCTION: kde5_pkg_postrm
763 # Updates the various XDG caches (icon, desktop, mime) if necessary.
765 debug-print-function ${FUNCNAME} "$@"
767 if [[ -n ${GNOME2_ECLASS_ICONS} ]]; then
768 gnome2_icon_cache_update