Projects/K3b: Difference between revisions

    From KDE TechBase
    (Migration to git)
    m (Text replace - "<code>" to "<syntaxhighlight lang="text">")
    Line 3: Line 3:
    ===Setting Up Environment===
    ===Setting Up Environment===
    Create target install directory. For the sake of example we will assume your home directory is <tt>/home/joe</tt> and you will install your compiled K3b to <tt>/home/joe/k3b/install</tt>. Add following lines to your <tt>~/.bashrc</tt> file:
    Create target install directory. For the sake of example we will assume your home directory is <tt>/home/joe</tt> and you will install your compiled K3b to <tt>/home/joe/k3b/install</tt>. Add following lines to your <tt>~/.bashrc</tt> file:
    <code>
    <syntaxhighlight lang="text">
    export K3B_INSTALL_PREFIX=/home/joe/k3b/install
    export K3B_INSTALL_PREFIX=/home/joe/k3b/install
    export KDEDIRS=${K3B_INSTALL_PREFIX}:${KDEDIRS}
    export KDEDIRS=${K3B_INSTALL_PREFIX}:${KDEDIRS}
    Line 15: Line 15:


    If you don't have a KDE development access you can get the source code using anonymous access repository:
    If you don't have a KDE development access you can get the source code using anonymous access repository:
    <code>
    <syntaxhighlight lang="text">
    git clone git://anongit.kde.org/k3b
    git clone git://anongit.kde.org/k3b
    </code>
    </code>
    If you have development access you should go the other way:
    If you have development access you should go the other way:
    <code>
    <syntaxhighlight lang="text">
    git clone ssh://[email protected]:k3b
    git clone ssh://[email protected]:k3b
    </code>
    </code>
    Line 28: Line 28:


    First the build directory should be created.
    First the build directory should be created.
    <code>
    <syntaxhighlight lang="text">
    cd k3b
    cd k3b
    mkdir build
    mkdir build
    Line 36: Line 36:


    Now we need to configure the source tree. This have to be done only once, later this step will be invoked automatically when necessary. If you are familiar with [http://en.wikipedia.org/wiki/Autotools Autotools] this step corresponds to <tt>./configure</tt> command.
    Now we need to configure the source tree. This have to be done only once, later this step will be invoked automatically when necessary. If you are familiar with [http://en.wikipedia.org/wiki/Autotools Autotools] this step corresponds to <tt>./configure</tt> command.
    <code>
    <syntaxhighlight lang="text">
    cmake .. \
    cmake .. \
           -DCMAKE_INSTALL_PREFIX=/home/joe/k3b/install \
           -DCMAKE_INSTALL_PREFIX=/home/joe/k3b/install \
    Line 46: Line 46:


    Finally to compile the source code and install it you should call:
    Finally to compile the source code and install it you should call:
    <code>
    <syntaxhighlight lang="text">
    make && make install
    make && make install
    </code>
    </code>


    After that compiled K3b will be placed in <tt>/home/joe/k3b/install</tt> directory. Now you can run K3b by simply typing in the console:
    After that compiled K3b will be placed in <tt>/home/joe/k3b/install</tt> directory. Now you can run K3b by simply typing in the console:
    <code>
    <syntaxhighlight lang="text">
    k3b
    k3b
    </code>
    </code>

    Revision as of 20:48, 29 June 2011

    Getting Started in K3b Development

    Setting Up Environment

    Create target install directory. For the sake of example we will assume your home directory is /home/joe and you will install your compiled K3b to /home/joe/k3b/install. Add following lines to your ~/.bashrc file: <syntaxhighlight lang="text"> export K3B_INSTALL_PREFIX=/home/joe/k3b/install export KDEDIRS=${K3B_INSTALL_PREFIX}:${KDEDIRS} export PATH=${K3B_INSTALL_PREFIX}/bin:${PATH} export XDG_DATA_DIRS=${K3B_INSTALL_PREFIX}/share:${XDG_DATA_DIRS} Relogin to let changes take effect.

    Getting Source Code

    K3b sources code is hosted in KDE git repository. It is a part of KDE Extragear module

    If you don't have a KDE development access you can get the source code using anonymous access repository: <syntaxhighlight lang="text"> git clone git://anongit.kde.org/k3b If you have development access you should go the other way: <syntaxhighlight lang="text"> git clone ssh://[email protected]:k3b This will give you right to push back your changes to the origin repository.

    Compilation

    K3b, as most KDE applications, uses CMake for configuration and compilation of source code.

    First the build directory should be created. <syntaxhighlight lang="text"> cd k3b mkdir build cd build It is guaranteed all files created during build will be placed in this directory. That means that if you want to clean up source tree after build the only thing you need to do is to remove build directory.

    Now we need to configure the source tree. This have to be done only once, later this step will be invoked automatically when necessary. If you are familiar with Autotools this step corresponds to ./configure command. <syntaxhighlight lang="text"> cmake .. \

         -DCMAKE_INSTALL_PREFIX=/home/joe/k3b/install \
         -DKDE4_AUTH_POLICY_FILES_INSTALL_DIR=/home/joe/k3b/install/share/polkit-1/actions \
         -DK3B_DEBUG=ON \
         -DCMAKE_BUILD_TYPE=Debug
    

    CMake will search for all required and optional libraries.

    Finally to compile the source code and install it you should call: <syntaxhighlight lang="text"> make && make install

    After that compiled K3b will be placed in /home/joe/k3b/install directory. Now you can run K3b by simply typing in the console: <syntaxhighlight lang="text"> k3b

    See Also