Projects/Edu/Artikulate/BuildAndInstall: Difference between revisions

    From KDE TechBase
    < Projects‎ | Edu‎ | Artikulate
    (→‎Artikulate Development Environment: increase build dependency)
    Line 46: Line 46:
    # export KDEDIRS=$HOME/artikulate-install:$KDEDIRS
    # export KDEDIRS=$HOME/artikulate-install:$KDEDIRS
    # export QML_IMPORT_PATH=/usr/lib/kde4/imports:$HOME/artikulate/share/apps/artikulate/qml/
    # export QML_IMPORT_PATH=/usr/lib/kde4/imports:$HOME/artikulate/share/apps/artikulate/qml/
    (the QML_IMPORT_PATH depends on your distribution, i.e., the first part could be for example also "/usr/lib64/kde4" or similar; you find the correct path by searching in your file system where the file structure .../imports/org/kde/plasma/core/ exists)
    Finally, you can run your build Artikulate binaries in $HOME/artikulate-install/bin/artikulate.
    Finally, you can run your build Artikulate binaries in $HOME/artikulate-install/bin/artikulate.

    Revision as of 16:11, 29 March 2013

    Artikulate is a pronunciaton trainer, currently in the Edu Playground. This means the application is not released yet and still under development! Please take this in mind when looking at the application. Though already now, all kinds of bug reports are very welcomed!

    Setting up Development or Testing Environment

    The following general steps are mandatory:

    1. setup development enviroment for KDE applications
    2. get the Artikulate source code
    3. configure the build system
    4. compile Artikulate
    5. install Artikulate
    6. set KDEDIRS and run QML_IMPORT_PATH
    7. run Artikulate

    Some of these steps need further explenations:

    Artikulate Development Environment

    Usually it is not necessary to compile kdelibs and Qt by yourself! The current master branch only requires development packges of the following framewoks:

    • KDE >= 4.10
    • Qt >= 4.8
    • CMake >= 2.8.9
    • QtMobility with component QtMultimedia

    Those package are usually provided by your distribution. Not that you also must install the development packages (often indicated by a trailing "-dev" in the package name).

    Example: Development Packages on Debian

    • kde-sc-dev-latest
    • cmake
    • kdelibs5-dev
    • qtmobility-dev
    • libqtmultimediakit1

    Get the Source Code

    You can fetch the sources from the Artikulate Project Page by cloning the Git repository. Let's say for the further explenations here that you fetch the source to: "$HOME/artikulate-source" (replace $HOME by the path to your home directory!)

    Configure Your Build-System

    Next, we need folders for building and for installing Artikulate. Let's say we create folders

    • $HOME/artikulate-build
    • $HOME/artikulate-install

    Then we need to say the build-scripts that those folders exist. Very comfortable this can be done by using the program cmake-gui. Take care to set the following variables:

    • Source-directory is: $HOME/artkulate-source
    • Build-directory is: $HOME/artikulate-build
    • set: CMAKE_BUILD_TYPE = debugfull
    • set: CMAKE_INSTALL_PREFIX = $HOME/artikulate-install

    Then press "configure" to see if all necessary libraries are present. Maybe you must press configure twice to get all red warnings resolved. If nothing red remains, all dependencies are found. To generate the build files, press "Generate".

    Setup Execution Enviroment and Run Artikulate

    It is necessary that the following variables are set when executing the application. This can either be done in your IDE (like KDevelop or QtCreator) or at the console with the export command, i.e.:

    1. export KDEDIRS=$HOME/artikulate-install:$KDEDIRS
    2. export QML_IMPORT_PATH=/usr/lib/kde4/imports:$HOME/artikulate/share/apps/artikulate/qml/

    (the QML_IMPORT_PATH depends on your distribution, i.e., the first part could be for example also "/usr/lib64/kde4" or similar; you find the correct path by searching in your file system where the file structure .../imports/org/kde/plasma/core/ exists)

    Finally, you can run your build Artikulate binaries in $HOME/artikulate-install/bin/artikulate.