Desenvolvimento/Tutoriais/Configuração

    From KDE TechBase
    Revision as of 19:13, 18 October 2019 by Juliano Assis (talk | contribs) (Created page with "Vá para o diretório do framework baixado/clonado e execute os seguintes comandos:")
    Other languages:

    Ao contrário da crença popular, você não precisa instalar todo o "KDE" (não é possível baixar uma comunidade) ou um kdelibs monolítico (não existe mais) apenas para desenvolver software KDE. Isso é especialmente verdade se você quiser usar apenas alguns KDE Frameworks para o seu projeto Qt. Você nem precisa compilar nada! Exceto o seu próprio projeto, é claro. É verdade que existem algumas maneiras de usar as bibliotecas do KDE no seu aplicativo, portanto esta página lista algumas delas, dependendo da sua situação ou necessidade.

    Instalação

    Pré-requisitos

    Este guia se concentra principalmente na configuração do KDE Frameworks. Quer você o compile a partir do código-fonte ou use os pacotes da sua distribuição, você precisará de mais algumas peças para usá-los.

    CMake - a partir de 2019, a versão requerida é o CMake 3.5

    • Compilador - No Linux, o GCC 4.8 e o Clang 3.3 são requeridos, permitindo suporte aos recursos do C ++ 11

    Muito Fácil: Package manager

    A maneira mais fácil e segura de usar KDE framework é instalá-lo (ou seu pacote de desenvolvimento) a partir do gerenciador de pacotes da sua distribuição Linux. Digamos que você queira adicionar alguma sintaxe destacada ao seu widget de edição de texto Qt. No KDE Neon ou Kubuntu ou Debian, esta linha define tudo:

    sudo apt install libkf5syntaxhighlighting-dev
    

    É isso aí! Você pode prosseguir agora para usando o framework no seu aplicativo. Obviamente, isso pressupõe que sua distribuição tenha uma versão mais ou menos recente do framework em seu repositório ou que você está confortável em não usar a mais recente. Caso contrário, prossiga para o Plano B.

    Faça assim!

    O KDE Frameworks é lançado mensalmente para garantir que os desenvolvedores sempre tenham acesso a correções de bugs ou novos recursos assim que possível. As Plasma workspaces e os aplicativos do KDE também têm suas próprias agendas de lançamento. Às vezes, no entanto, as distros nem sempre fornecem a versão mais recente do software KDE que você pode precisar. Se for esse o caso, talvez seja necessário compilar a estrutura a partir do fonte. Não se preocupe, não é tão assustador ou complicado como no passado.

    Passo 1: baixar o framework

    Faça o download da versão mais recente do framework a partir da tarballs ou do Git. Observe que o Git master sempre terá a versão mais recente do código e pode não ser estável, portanto, verifique a tag stable da versão que você precisa.

    git clone https://anongit.kde.org/kwidgetsaddons.git
    

    Passo 2: Compile-o!

    Vá para o diretório do framework baixado/clonado e execute os seguintes comandos:

    mkdir build && cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=$HOME
    make install
    

    Presuming you have the proper dependencies installed (you'll have to consult your distro's package manager), this should end in a successful build that's ready to install. Note that KDE software use an "out-of-source build" structure to make things cleaner and easier to clean up if needed.

    Step 3: Install

    This part is usually tricky. Normally, you'd issue the make install command at this point, which you can certainly do that if you already know the CMake trick. You can also use sudo make install but that would overwrite your system-installed version of the framework without prejudice. The safest way would be to install the framework somewhere in your home directory, following the steps outlined in this tutorial. Do note you'll have to adjust some system environment variables so that your project will see the newly-installed framework.

    Use the source

    KDE does have a tool that specializes in automating the above. It might be overkill for one-off use of frameworks but if you find yourself getting attached to more and more KDE Frameworks (which is definitely a good thing), you might want to give the kdesrc_build tool a good try. It's especially useful for developers interested in leveling up to become KDE rockstars.

    Using KDE Frameworks

    Made it this far? Congratulations! The brunt of the setup work is complete and you're ready to use that powerful new framework to boost your Qt application. If you're using QMake, all you need is to add a simple line to your project file:

    QT += KWidgetsAddons
    

    If you're using CMake, be sure to check out the helpful Extra CMake Modules for making it easy to look for and add KDE Frameworks. Check out the Frameworks Quick Start Guide for a simple example of using the framework or jump right into the rest of Tutorials.