Projects/Edu/Artikulate/BuildAndInstall: Difference between revisions

    From KDE TechBase
    < Projects‎ | Edu‎ | Artikulate
    m (Cola moved page Projects/Edu/Artikulate to Projects/Edu/Artikulate/BuildAndInstall: Move all content (that only contains information how to build and install) to a subpage such that the previous page can provide an overview for all technical in...)
    No edit summary
     
    (10 intermediate revisions by 4 users not shown)
    Line 1: Line 1:
    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!
    This text explains how to compile Artikulate from sources and what are the necessary steps to run it then.


    == Setting up Development or Testing Environment ==
    == Setting up Development / Compilation Step ==
    The following general steps are mandatory:
    The following general steps are mandatory:
    # setup development enviroment for KDE applications
    # setup development environment for KDE applications
    # get the Artikulate source code
    # get the Artikulate source code
    # configure the build system
    # configure the build system
    # compile Artikulate
    # compile Artikulate
    # install Artikulate
    # install Artikulate
    # set KDEDIRS and run QML_IMPORT_PATH
    # set KDEDIRS and set QML_IMPORT_PATH
    # run Artikulate
    # run Artikulate
     
    We now explain these steps in details.
    Some of these steps need further explenations:


    === Artikulate Development Environment ===
    === 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:
    Usually it is '''not necessary''' to compile kdelibs and Qt by yourself but to use development packages as contributed by your distribution. As those, Artikulate requires development packages of the following framewoks:
    * KDE >= 4.10
    * KDE >= 4.10
    * Qt >= 4.8
    * Qt >= 4.8 (but not Qt 5.x)
    * CMake >= 2.8.9
    * CMake >= 2.8.9
    * QtMobility with component QtMultimedia
    * [https://projects.kde.org/projects/kde/kdeedu/kqtquickcharts kqtquickcharts]
    * one of the following sound backends (available backends are automatically selected at compile time, application prefers QtMultimedia if available):
    ** QtGstreamer 0.10 and GStreamer 0.10, or
    ** alternative is 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).
    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).


    Line 25: Line 27:
    * cmake
    * cmake
    * kdelibs5-dev
    * kdelibs5-dev
    * qtmobility-dev
    * libqtgstreamer-dev
    * libqtmultimediakit1
    * plus checkout of kqtquickcharts


    === Get the Source Code ===
    === Get the Source Code ===
    You can fetch the sources from the [https://projects.kde.org/projects/playground/edu/artikulate 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!)
    Artikulate is now with KDE review. You can fetch the sources from the [https://projects.kde.org/projects/kde/kdeedu/artikulate Artikulate Project Page] by cloning the Git repository. Let's assume for further explanations that you copy the source to: "$HOME/artikulate-source" (replace $HOME by the path to your home directory.)


    === Configure Your Build-System ===
    === Configure Your Build-System ===
    Next, we need folders for building and for installing Artikulate. Let's say we create folders
    Next, we need folders for building and for installing Artikulate. For those we create the following folders:
    * $HOME/artikulate-build
    * $HOME/artikulate-build
    * $HOME/artikulate-install
    * $HOME/artikulate-install
    Line 40: Line 42:
    * set: CMAKE_BUILD_TYPE = debugfull
    * set: CMAKE_BUILD_TYPE = debugfull
    * set: CMAKE_INSTALL_PREFIX = $HOME/artikulate-install
    * set: CMAKE_INSTALL_PREFIX = $HOME/artikulate-install
    * set EXECUTABLE_OUTPUT_PATH
    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".
    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 ===
    === Setup Execution Environment 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.:
    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.:
    # 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/:/KQTQUICKCHARTS/INSTALL/PREFIX/kqtquickcharts/install/lib/kde4/imports
    (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)
    (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 the built Artikulate binaries in $HOME/artikulate-install/bin/artikulate.
     
    == Artikulate Course Data Repository ==
    All course material for Artikulate can be found and edited in the following repository:
    * https://projects.kde.org/projects/playground/edu/artikulate-data
    For licensing information please see:
    * https://projects.kde.org/projects/playground/edu/artikulate-data/repository/revisions/master/entry/README
    You can contribute to this repository with a KDE Developer account. But also if you do not have a KDE Developer account (yet), we are happy to get contributions. For those cases, please write to the mailing list [mailto:[email protected]] and get in touch with us.
     
    === Using the Repository Directly in Artikulate ===
    To work with the Artikulate editor directly at the Artikulate course material repository please create a local copy of it (git clone). Then start Artikulate and go to the dialog "Settings" (top-left tool button) and select the root folder of your local copy in that dialog as your course material repository. After restarting Artikulate the training mode as well as the editor mode operate only on the data from the repository.

    Latest revision as of 15:39, 28 February 2014

    This text explains how to compile Artikulate from sources and what are the necessary steps to run it then.

    Setting up Development / Compilation Step

    The following general steps are mandatory:

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

    We now explain these steps in details.

    Artikulate Development Environment

    Usually it is not necessary to compile kdelibs and Qt by yourself but to use development packages as contributed by your distribution. As those, Artikulate requires development packages of the following framewoks:

    • KDE >= 4.10
    • Qt >= 4.8 (but not Qt 5.x)
    • CMake >= 2.8.9
    • kqtquickcharts
    • one of the following sound backends (available backends are automatically selected at compile time, application prefers QtMultimedia if available):
      • QtGstreamer 0.10 and GStreamer 0.10, or
      • alternative is 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
    • libqtgstreamer-dev
    • plus checkout of kqtquickcharts

    Get the Source Code

    Artikulate is now with KDE review. You can fetch the sources from the Artikulate Project Page by cloning the Git repository. Let's assume for further explanations that you copy 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. For those we create the following 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
    • set EXECUTABLE_OUTPUT_PATH

    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 Environment 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/:/KQTQUICKCHARTS/INSTALL/PREFIX/kqtquickcharts/install/lib/kde4/imports

    (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 the built Artikulate binaries in $HOME/artikulate-install/bin/artikulate.

    Artikulate Course Data Repository

    All course material for Artikulate can be found and edited in the following repository:

    For licensing information please see:

    You can contribute to this repository with a KDE Developer account. But also if you do not have a KDE Developer account (yet), we are happy to get contributions. For those cases, please write to the mailing list [1] and get in touch with us.

    Using the Repository Directly in Artikulate

    To work with the Artikulate editor directly at the Artikulate course material repository please create a local copy of it (git clone). Then start Artikulate and go to the dialog "Settings" (top-left tool button) and select the root folder of your local copy in that dialog as your course material repository. After restarting Artikulate the training mode as well as the editor mode operate only on the data from the repository.