Latest revision as of 10:00, 6 September 2020

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.

Qt - a partir de 2019-06, a versão requerida é no mínimo Qt 5.10

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 KDE Frameworks 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://invent.kde.org/frameworks/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

Presumindo que você tenha as dependências adequadas instaladas (você precisará consultar o gerenciador de pacotes da sua distribuição), isso deve terminar em uma compilação bem-sucedida, pronta para instalação. Observe que o software KDE usa uma estrutura de "out-of-source build" para tornar as coisas mais claras e fáceis de limpar, se necessário.

Passo 3: Instalar

Esta parte é geralmente complicada. Normalmente, você executa o comando make install neste momento, o que certamente pode ser feito se você já conhece os segredos do CMake. Você também pode usar o sudo make install, mas isso sobrescreveria a versão do framework instalado pelo sistema, sem prejuízo. A maneira mais segura seria instalar o framework em algum lugar no seu diretório home, seguindo as etapas descritas neste tutorial. Observe que você precisará ajustar algumas variáveis de ambiente do sistema para que seu projeto veja a estrutura recém-instalada.

Use o fonte

O KDE possui uma ferramenta especializada em automatizar o que foi feito acima. Pode ser exagerado para o uso de um único framework, mas se você encontrar-se com mais e mais KDE Frameworks( o que é definitivamente uma coisa boa), convém dar uma chance a ferramenta kdesrc_build. É especialmente útil para desenvolvedores interessados em subir de nível para se tornarem rockstars do KDE.

Usando o KDE Frameworks

Chegou tão longe? Parabéns! O peso do trabalho de instalação está completo e você está pronto para usar esse novo e poderoso framework para aprimorar seu aplicativo Qt. Se você estiver usando o QMake, basta adicionar uma linha simples ao seu arquivo de projeto:

QT += KWidgetsAddons

Se você estiver usando o CMake, verifique o útil Extra CMake Modules para facilitar a procura e adição de módulos ao KDE Frameworks. Confira o Frameworks Quick Start Guide para obter um exemplo simples do uso do framework ou vá direto para o restante dos tutoriais.

@@ Line 1: / Line 1: @@
 <languages/>
-Contrary to popular misconception, you don't have to install all of "KDE" (you can't download a community) or a monolithic kdelibs (no longer exists) just to develop KDE software. That's especially true if you just want to use just a few [[Frameworks|KDE Frameworks]] for your Qt project. You don't even need to compile anything at all! Except for your own project, of course. Granted, there are a few ways to go about using KDE libraries for your application so this page lists some of them, depending on your situation or need.
+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 [[Frameworks|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.
-= Installation =
+= Instalação =
-== Prerequisites ==
+== Pré-requisitos ==
-This guide focuses mainly on setting up KDE Frameworks. Whether you build it from source or use your distro's packages, you will need a few other pieces to use them.
+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.
-* Qt - as of 2019-06, the [[Community:Frameworks/Policies#Frameworks_Qt_requirements|required version]] is at least Qt 5.10
+* Qt - a partir de 2019-06, a [[Community:Frameworks/Policies#Frameworks_Qt_requirements|versão requerida]] é no mínimo Qt 5.10
-* CMake - as of 2019, the required version is CMake 3.5
+* CMake - a partir de 2019, a versão requerida é o CMake 3.5
-* Compiler - On Linux, GCC 4.8 and Clang 3.3 are required, enabling support for C++11 features
+* Compilador - No Linux, o GCC 4.8 e o Clang 3.3 são requeridos, permitindo suporte aos recursos do C ++ 11
-== Easy as pie: Package manager ==
+== Muito Fácil: Package manager ==
-The easiest and safest way to use a KDE framework is to install it (or its development package) from your Linux distribution's package manager. Say you want to add some syntax highlighting to your Qt text editing widget. On KDE Neon or Kubuntu or Debian, this one line sets it all up:
+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:
 <syntaxhighlight lang="bash">
@@ Line 23: / Line 23: @@
 </syntaxhighlight>
-That's it! You can then proceed to [[#Using_KDE_Frameworks|actually using the framework]] in your app. Of course, this presumes that your distro has a more or less recent version of the framework in its repository or that you're fine with not using the latest. If not, proceed to Plan B.
+É isso aí! Você pode prosseguir agora para [[#Usando o KDE Frameworks|usando o KDE Frameworks]] 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.
-== Make it so! ==
+== Faça assim! ==
-KDE Frameworks is released on a monthly basis to ensure that developers will always have access to bug fixes or new features as soon as possible. The Plasma workspaces and KDE applications have their own release schedules as well. Sometimes, however, distros don't always provide the latest version of KDE software that you might need. If that's the case, you might have to compile the framework from the source. Not to worry, it's not as daunting or complicated as in the past.
+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.
-=== Step 1: Download the framework ===
+=== Passo 1: baixar o framework ===
-Download the latest version of the framework either [https://download.kde.org/stable/frameworks/ from tarballs] or [https://cgit.kde.org/kwidgetsaddons.git/ from Git]. Note that Git master will always have the latest version of the code and may not be stable, so be sure to checkout the stable tag for the release you need.
+Faça o download da versão mais recente do framework [https://download.kde.org/stable/frameworks/ a partir da tarballs] ou [https://cgit.kde.org/kwidgetsaddons.git/ 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.
 <syntaxhighlight lang="bash">
-git clone https://anongit.kde.org/kwidgetsaddons.git
+git clone https://invent.kde.org/frameworks/kwidgetsaddons.git
 </syntaxhighlight>
-=== Step 2: Build it! ===
-Go into the directory of the downloaded/cloned framework and issue the following commands:
+=== Passo 2: Compile-o! ===
+Vá para o diretório do framework baixado/clonado e execute os seguintes comandos:
 <syntaxhighlight lang="bash">
@@ Line 47: / Line 48: @@
 </syntaxhighlight>
-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.
+Presumindo que você tenha as dependências adequadas instaladas (você precisará consultar o gerenciador de pacotes da sua distribuição), isso deve terminar em uma compilação bem-sucedida, pronta para instalação. Observe que o software KDE usa uma estrutura de "out-of-source build" para tornar as coisas mais claras e fáceis de limpar, se necessário.
-=== Step 3: Install ===
+=== Passo 3: Instalar ===
-This part is usually tricky. Normally, you'd issue the <code>make install</code> command at this point, which you can certainly do that if you already know the CMake trick. You can also use <code>sudo make install</code> but that would overwrite your system-installed version of the framework without prejudice. The safest way would be to install the framework [[Development/Tutorials/Using_Actions#Make.2C_Install_And_Run|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.
+Esta parte é geralmente complicada. Normalmente, você executa o comando <code>make install</code> neste momento, o que certamente pode ser feito se você já conhece os segredos do CMake. Você também pode usar o <code>sudo make install</code>, mas isso sobrescreveria a versão do framework instalado pelo sistema, sem prejuízo. A maneira mais segura seria instalar o framework em [[Development/Tutorials/Using_Actions#Make.2C_Install_And_Run|algum lugar no seu diretório home]], seguindo as etapas descritas neste tutorial. Observe que você precisará ajustar algumas variáveis de ambiente do sistema para que seu projeto veja a estrutura recém-instalada.
-== Use the source ==
+== Use o fonte ==
-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 [[Community:Get_Involved/development#Set_up_kdesrc-build|the kdesrc_build tool]] a good try. It's especially useful for developers interested in leveling up to become KDE rockstars.
+O KDE possui uma ferramenta especializada em automatizar o que foi feito acima. Pode ser exagerado para o uso de um único framework, mas se você encontrar-se com mais e mais KDE Frameworks( o que é definitivamente uma coisa boa), convém dar uma chance [[Community:Get_Involved/development#Set_up_kdesrc-build|a ferramenta kdesrc_build]]. É especialmente útil para desenvolvedores interessados em subir de nível para se tornarem rockstars do KDE.
-= Using KDE Frameworks =
+= Usando o 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:
+Chegou tão longe? Parabéns! O peso do trabalho de instalação está completo e você está pronto para usar esse novo e poderoso framework para aprimorar seu aplicativo Qt. Se você estiver usando o QMake, basta adicionar uma linha simples ao seu arquivo de projeto:
 <syntaxhighlight lang="make">
@@ Line 65: / Line 66: @@
 </syntaxhighlight>
-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|Frameworks Quick Start Guide]] for a simple example of using the framework or jump right into the [[Development/Tutorials|rest of Tutorials]].
+Se você estiver usando o CMake, verifique o útil Extra CMake Modules para facilitar a procura e adição de módulos ao KDE Frameworks. Confira o [[Frameworks|Frameworks Quick Start Guide]] para obter um exemplo simples do uso do framework ou vá direto para o [[Development/Tutorials|restante dos tutoriais]].