Plugin de compilaçãoO plugin de compilação permite executar ações como build, clean e compile em um projeto. Você também pode executar automaticamente os aplicativos gerados. O plugin basicamente oferece uma maneira de configurar conjuntos de comandos para serem executados e pode analisar a saída em busca de links para arquivos e linhas e colunas específicas nesses arquivos. Portanto, mesmo que o plugin tenha sido originalmente criado para compilar C/C++ e testado principalmente com essa linguagem, ele também pode ser útil para outros fins e linguagens.
O plugin de compilação adiciona uma área de ferramentas Compilar na parte inferior e um menu no menu principal. A área de ferramentas pode ser usada para selecionar e configurar alvos de compilação, enquanto o menu e seus atalhos podem ser usados para selecionar e executar os comandos de shell configurados.
A visualização da ferramenta Compilar possui duas abas:
Configurações do alvo
Saída
A aba de configurações de alvo pode ser usada para configurar vários alvos e definir conjuntos de alvos.
Um conjunto de alvos é um grupo de comandos que podem ser executados em uma pasta de trabalho específica. Os conjuntos de alvos podem ser adicionados em Projetos ou Sessão. Os conjuntos de alvos personalizados adicionados em Projetos são armazenados em um arquivo .kateproject.build na pasta raiz do projeto e são restaurados quando o projeto é reaberto. Os conjuntos de alvos adicionados em Sessão são armazenados na configuração atual da sessão Kate.
A primeira linha, em um conjunto de alvos, contém um nome para o conjunto na primeira coluna, e na segunda coluna temos a pasta onde os comandos devem ser executados. Em cada linha seguinte, temos um nome para o comando na primeira coluna, um comando de compilação na segunda coluna e um comando de execução na terceira coluna. Para editar um deles, clique duas vezes na entrada ou use o atalho de edição (geralmente F2).
- Pasta de trabalho
A segunda coluna da primeira linha em um conjunto de alvos é usada para configurar a pasta de trabalho usada para compilar e executar comandos. Se o plugin de projeto estiver habilitado, a string da pasta de trabalho também pode conter marcadores para o caminho da pasta base do projeto: %B e para o nome: %b
- Comando de compilação
A segunda coluna nas "linhas não iniciais" contém o comando do shell a ser executado na pasta de trabalho. Observe a palavra "shell". Quase qualquer comando do shell servirá. O comando de compilação pode conter marcadores. %f para o arquivo atual, %d para a pasta do arquivo atual e %n para o nome base do arquivo atual (nome do arquivo sem sufixo).
- Comando de execução
A terceira coluna nas "linhas não iniciais" pode conter um comando shell para execução em um terminal real no diretório de trabalho definido. O terminal é aberto como uma aba. O plugin tentará reutilizar a aba do terminal se o mesmo comando for executado e o aplicativo anterior tiver sido encerrado.
Na parte superior da aba Configurações do alvo, temos uma barra de ferramentas com um filtro de alvo e os seguintes botões:
 Compilar o alvo selecionado |
 Compilar e executar o alvo selecionado |
 Adicionar um novo alvo de compilação |
 Criar um novo conjunto de alvos |
 Copiar um comando ou conjunto de alvos |
 Excluir o comando atual ou conjunto de alvos |
A aba Saída mostra a saída do console gerada pelo comando (de compilação) em execução. Se uma linha contiver o caminho de um arquivo, essa linha será clicável. Se a linha na saída também mostrar um erro ou aviso, a linha terá uma cor diferente.
Se a opção Adicionar erros e avisos ao diagnóstico estiver ativada na página de configurações do plugin nas configurações do Kate, os erros e avisos também serão adicionados à visualização de diagnóstico. Para navegar até o erro anterior na visualização de diagnóstico, pressione Alt+Shift+Esquerda. Para navegar até o próximo erro, pressione Alt+Shift+Direita.
- →
O filtro de seleção de alvos está focado na aba de configurações de alvo. Digitar um nome filtrará os alvos que não correspondem à string digitada. Também é possível usar as teclas de seta para navegar na árvore de alvos. Quando o alvo desejado for selecionado, pressionar Enter executará o alvo selecionado.
- →
Compila o último alvo selecionado. Se nenhum tiver sido selecionado, funciona como Selecionar alvo...
- →
Compila o último alvo selecionado e executa o comando de execução após a compilação. O comando de compilação terminou com sucesso.
- →
Tente compilar o arquivo atual procurando um comando em um possível arquivo compile_commands.json.
- →
Parar a compilação de um alvo.
- →
Foque na próxima aba do plugin de compilação à esquerda. Ou abre a visualização da ferramenta do plugin de compilação, se estiver oculta.
- →
Foque na próxima aba do plugin de compilação à direita. Ou abre a visualização da ferramenta do plugin de compilação, se estiver oculta.
- →
Abre a janela de arquivo e permite que o usuário selecione um CMakeCache.txt. Quando um arquivo é selecionado, o plugin gera comandos de compilação do CMake que podem ser executados na pasta de compilação para o projeto baseado em CMake.