Development/CMake KDE 4 3: Difference between revisions

    From KDE TechBase
    Line 22: Line 22:


    ==Other Changes==
    ==Other Changes==
    ===Required Versions===
    * Qt >= 4.5.0 is required for now (was >= 4.4.0 for KDE 4.2)
    * automoc4 >= 0.9.88 is required now (was 0.9.87 for KDE 4.2)
    * (Windows only): the support package KDEWIN32 has been renamed to KDEWin


    ===New option (Windows only): KDE4_ENABLE_UAC_MANIFEST===
    ===New option (Windows only): KDE4_ENABLE_UAC_MANIFEST===
    Line 27: Line 32:
    This option is only available under Windows, by default it is off.
    This option is only available under Windows, by default it is off.
    It enables support for generating uac manifest files (or something like that).
    It enables support for generating uac manifest files (or something like that).
    ===MACRO_OPTIONAL_ADD_SUBDIRECTORY(): new option DISABLE_ALL_OPTIONAL_SUBDIRECTORIES===
    If the CMake variable DISABLE_ALL_OPTIONAL_SUBDIRECTORIES is set to TRUE for the first CMake run on the project, all optional subdirectories will be disabled by default (but can of course be enabled via the respective options).
    E.g. the following will disable all optional subdirectories except the one named "kcalc":
      $ cmake -DDISABLE_ALL_OPTIONAL_SUBDIRECTORIES=TRUE -DBUILD_kcalc=TRUE <srcdir>


    ===RelWithDebInfo compiler flags===
    ===RelWithDebInfo compiler flags===


    In the RelWithDebInfo build type -DNDEBUG -DQT_NO_DEBUG have been added to the compiler flags.
    In the RelWithDebInfo build type -DNDEBUG -DQT_NO_DEBUG have been added to the compiler flags.
    ===Required Versions===
    * Qt >= 4.5.0 is required for now (was >= 4.4.0 for KDE 4.2)
    * automoc4 >= 0.9.88 is required now (was 0.9.87 for KDE 4.2)
    * (Windows only): the support package KDEWIN32 has been renamed to KDEWin


    ===Nepomuk libraries===
    ===Nepomuk libraries===


    In KDE 4.2 there were two variables KDE4_KNEPOMUK_LIBS and KDE4_KMETADATA_LIBS. This was a bug, they were always empty. They have been removed now (which is not incompatible, since they were empty). Instead a new and correct KDE4_NEPOMUK_LIBS has been added.
    In KDE 4.2 there were two variables KDE4_KNEPOMUK_LIBS and KDE4_KMETADATA_LIBS. This was a bug, they were always empty. They have been removed now (which is not incompatible, since they were empty). Instead a new and correct variable KDE4_NEPOMUK_LIBS has been added.


    ==New Modules==
    ==New Modules==

    Revision as of 23:19, 11 July 2009

    Changes in the buildsystem from KDE 4.2 to KDE 4.3

    As with KDE 4.2, also for KDE 4.3 still CMake >= 2.6.2 is required, so no changes in this regard.

    Incompatible Changes

    Again we had two changes, which are incompatible. But in both cases this hurts these changes are actually bug fixes, since what they did before was actually wrong or unnecessary.

    1. Perl is not required anymore. From KDE 4.0.0 to KDE 4.2.x a call to
    find_package(KDE4)
    

    failed if Perl could not be found. This was an internal, undocumented implementation detail and not necessary, since building software for KDE4 doesn't actually require Perl in general. With KDE 4.3 this has been changed. Now Perl is still searched, but if it is not found, the CMake-run doesn't fail, it just prints a warning message. This way one dependency less is necessary to build software for KDE4. Perl is still required to build kdelibs. So if you use Perl in your project, check properly for it:

    find_package(Perl REQUIRED)
    # in case you didn't use the REQUIRED keyword:
    if (PERL_FOUND)
    ...
    
    1. FindKdepim.cmake has been obsoleted. It was buggy, in that no other software should depend on an installed kdepim. Instead there is a FindKdepimLibs.cmake which can be used to find kdepimlibs. There are no known users of the FindKdepim.cmake module. The module is still there, but it now aborts with FATAL_ERROR.

    Other Changes

    Required Versions

    • Qt >= 4.5.0 is required for now (was >= 4.4.0 for KDE 4.2)
    • automoc4 >= 0.9.88 is required now (was 0.9.87 for KDE 4.2)
    • (Windows only): the support package KDEWIN32 has been renamed to KDEWin

    New option (Windows only): KDE4_ENABLE_UAC_MANIFEST

    This option is only available under Windows, by default it is off. It enables support for generating uac manifest files (or something like that).

    MACRO_OPTIONAL_ADD_SUBDIRECTORY(): new option DISABLE_ALL_OPTIONAL_SUBDIRECTORIES

    If the CMake variable DISABLE_ALL_OPTIONAL_SUBDIRECTORIES is set to TRUE for the first CMake run on the project, all optional subdirectories will be disabled by default (but can of course be enabled via the respective options). E.g. the following will disable all optional subdirectories except the one named "kcalc":

      $ cmake -DDISABLE_ALL_OPTIONAL_SUBDIRECTORIES=TRUE -DBUILD_kcalc=TRUE <srcdir>
    


    RelWithDebInfo compiler flags

    In the RelWithDebInfo build type -DNDEBUG -DQT_NO_DEBUG have been added to the compiler flags.

    Nepomuk libraries

    In KDE 4.2 there were two variables KDE4_KNEPOMUK_LIBS and KDE4_KMETADATA_LIBS. This was a bug, they were always empty. They have been removed now (which is not incompatible, since they were empty). Instead a new and correct variable KDE4_NEPOMUK_LIBS has been added.

    New Modules

    • FindIOKit.cmake
    • FindKDEWin.cmake
    • FindLibLZMA.cmake
    • FindPulseAudio.cmake