Ir para o conteúdo

Compilar

Compilando o Kate a partir do código-fonte no Linux

Atualmente, o código-fonte do Kate está localizado na instância do GitLab invent.kde.org. Este tutorial explica como compilar o Kate sem alterar sua instalação global.

Tudo acontecerá dentro de uma pasta de desenvolvimento extra. Isso evita a necessidade de direitos de administrador e permite sempre usar o Kate instalado globalmente caso a versão atual esteja corrompida.

Como este tutorial apresentará uma configuração que permite desenvolver outras partes da pilha de software do KDE, falaremos a seguir sobre a configuração de um ambiente de desenvolvimento KDE. Os Frameworks KDE necessários serão compilados além das partes do aplicativo Kate. Isso facilita as contribuições para todos os níveis da pilha de software do KDE.

Escolha sua pasta de desenvolvimento do Kate e do KDE

Escolha um caminho para onde todos os recursos de desenvolvimento do Kate e do KDE devem ser colocados. Além dos arquivos de configuração local do usuário, nada fora desta pasta será poluído. Você pode reutilizá-la para desenvolvimento em qualquer parte da pilha de software do KDE.

Para as partes restantes desta descrição usamos

~/projects/kde

Sinta-se à vontade para personalizar isso.

Instale o kdesrc-build

Instalar é mais ou menos apenas clonar a versão atual

mkdir -p ~/projects/kde/src
cd ~/projects/kde/src
git clone https://invent.kde.org/sdk/kdesrc-build.git

Para facilitar o uso posterior, é melhor criar um link simbólico do script kdesrc-build para alguma pasta dentro do seu caminho, por exemplo, se você tiver alguma pasta local do usuário:

ln -s ~/projects/kde/src/kdesrc-build/kdesrc-build ~/bin

Configurar o kdesrc-build

O kdesrc-build possui um passo de configuração que pode configurar algumas coisas para você. Veja esta introdução.

Aqui mostramos apenas um ~/.config/kdesrc-buildrc que é bom o suficiente para as necessidades de desenvolvimento do Kate.

Você pode simplesmente copiar e colar a variante abaixo na sua pasta pessoal como ~/.config/kdesrc-buildrc e adaptar os caminhos às suas necessidades. Se você mantiver o caminho ~/projects/kde que escolhemos acima, ele deverá ser utilizável 1:1.

global
    # use o software mais recente baseado em KF6 e Qt6.
    branch-group kf6-qt6

    # use o ninja para uma recompilação incremental mais rápida, desative algumas coisas do Qt 5
    # para ter menos dependências
    cmake-options -G "Ninja" -DBUILD_WITH_QT6=ON -DQT_MAJOR_VERSION=6 -DPHONON_BUILD_QT5=OFF -DBUILD_QT5=OFF

    # ferramentas clangd
    compile-commands-export yes
    compile-commands-linking yes

    # estrutura plana
    directory-layout flat

    # Pasta de instalação para software KDE
    install-dir ~/projects/kde/usr

    # Pasta para baixar o código-fonte
    source-dir ~/projects/kde/src

    # Pasta para compilar o KDE antes da instalação em relação à pasta de origem por padrão
    build-dir ~/projects/kde/build
end global

include ${module-definitions-dir}/kf6-qt6.ksb

As linhas importantes para ter uma boa experiência desenvolvendo o Kate (ou outras coisas do KDE) com o Kate são descritas abaixo em detalhes.

Integração LSP

# ferramentas clangd
compile-commands-export yes
compile-commands-linking yes

Essas linhas garantem que o CMake gerará os arquivos compile_commands.json necessários para a integração com LSP baseada em clangd. Além de gerá-los dentro da pasta de compilação, a opção de vinculação os vinculará simbolicamente às suas pastas de origem. Isso permite o uso do plugin LSP sem configuração dentro do Kate (e outros editores).

Instale as dependências necessárias (opcional)

O kdesrc-build fornece um modo de configuração inicial para instalar os pacotes necessários para várias distribuições comuns para iniciar o desenvolvimento. Isso é útil se você não tiver certeza se todos os pacotes de desenvolvimento necessários estão instalados no seu sistema e não quiser cuidar disso manualmente. Como isso tentará instalar pacotes para sua distribuição, esta etapa exigirá direitos de administrador para a instalação dos pacotes. Para fazer isso, basta acionar:

kdesrc-build --initial-setup

Já criamos um arquivo .config/kdesrc-buildrc, que permanecerá inalterado. Para uso posterior, você também não precisa modificar as configurações do seu shell.

Compile o Kate e suas dependências

Para iniciar a compilação do Kate e de todas as dependências necessárias do KDE, basta digitar:

kdesrc-build --include-dependencies kate

Isso leva alguns minutos em uma máquina recente. Hora de tomar um café ou pensar no que você realmente quer implementar.

Contanto que a versão KF 6 de nossas dependências não esteja incluída na sua distribuição, pode fazer sentido construir mais algumas partes para ter um estilo melhor e uma integração de terminal:

kdesrc-build --include-dependencies breeze plasma-integration kwayland-integration konsole kate

Se você deseja apenas compilar o Kate sem as dependências porque tem certeza de que possui material recente o suficiente no seu sistema, você pode tentar:

kdesrc-build --no-include-dependencies kate

Mas, considerando que em máquinas modernas os tempos de compilação são baixos, é mais conveniente simplesmente compilar tudo, o que garante que você tenha, por exemplo, os melhores e mais recentes frameworks KSyntaxHighlighting e KTextEditor disponíveis também!

Dada essa configuração, você está livre para construir todas as partes do software KDE com um simples:

kdesrc-build

Lembre-se: isso levará algum tempo (e espaço em disco).

Se durante a compilação você vir alguma falha exibida em fonte vermelha, siga este guia - Como resolver problemas de compilação

Como usar o material compilado?

Para iniciar sua versão local do Kate, você precisa primeiro configurar o ambiente corretamente para garantir que os plugins e recursos corretos sejam carregados. Felizmente, isso é muito simples:

source ~/projects/kde/build/kate/prefix.sh
kate

Uma maneira bacana de fazer isso é, por exemplo, criar um pequeno script wrapper para iniciar sua versão do branch master do Kate dentro da sua pasta bin local:

#!/bin/bash
source ~/projects/kde/build/kate/prefix.sh
exec kate "$@"

Mantenha suas coisas atualizadas

Para manter sua versão local atualizada, você pode simplesmente usar os comandos acima novamente. Eles se encarregarão de extrair as novas alterações dos repositórios do KDE e compilá-las/instalá-las no seu prefixo local.

Desenvolva!

Agora, a questão que resta é: como desenvolver melhor?

Naturalmente, se você quiser hackear o Kate, pode fazer sentido usar o Kate para isso.

Dadas as preparações acima, isso é fácil de fazer: basta iniciar sua nova versão master do Kate e passar a ela a pasta de compilação:

kate ~/projects/kde/build/kate

Alternativamente, você pode navegar até lá no seu terminal e iniciar o Kate a partir daí, ele será aberto automaticamente:

cd ~/projects/kde/build/kate
kate

Para ter a melhor experiência possível, certifique-se de ter pelo menos o projeto e o plugin LSP habilitados. Se você quiser ter alguma integração de compilação com a interface gráfica, ative o plugin de compilação também.

Você terminará com uma nova janela do Kate como mostrado abaixo.

Na visualização inferior da ferramenta "Projeto Atual", você tem, por padrão, dois terminais. O primeiro terminal está dentro da sua pasta de compilação, onde você pode, por exemplo, executar seus comandos ninja e ninja install e similares. O segundo terminal está dentro da sua pasta de origem, perfeito para, por exemplo, chamadas de linha de comando do git.

Dada a configuração acima, o plugin LSP (se você tiver o clangd instalado) deve funcionar imediatamente.

Outras coisas interessantes, como abertura rápida do projeto, busca e substituição, e alvos de compilação corretos, também devem ser configurados.

Contribua!

Sinta-se à vontade para criar uma solicitação de mesclagem em invent.kde.org. Para mais informações, consulte [Junte-se a nós](/join-us /).

Precisa de suporte?

Se tiver dúvidas, você pode perguntar na nossa seção Kate no servidor de discussão do KDE e/ou participar do nosso canal Matrix do Kate (mais informações gerais sobre Matrix e KDE aqui).

Para mais informações, consulte Obter ajuda.

Compilando o Kate a partir do código-fonte no Windows

Para compilar o Kate/KWrite baseado no KF5, você pode seguir o guia em KDE no Windows.

Compilando o Kate a partir do código-fonte no macOS

Para compilar o Kate/KWrite baseado no KF5, você pode seguir o guia em KDE no macOS.