Suporte para CMake
O CMake continua sendo o modelo de projeto mais profundamente integrado ao CLion.
Projeto CMake
Abrir projeto CMake
Qualquer projeto baseado no CMake pode ser aberto facilmente no CLion, sem a necessidade de configuração adicional:
- aponte-o para o arquivo raiz CMakeLists.txt nos fontes do seu projeto ou
- apontar para a pasta de geração ou arquivos CMakeCache.txt existentes (isso funciona apenas para o gerador Makefiles).
Marcar diretório como
Caso você queira marcar diretórios manualmente como bibliotecas ou fontes/cabeçalhos de projeto, ou excluir alguns diretórios (ou seja, independentemente da estrutura do projeto CMake), pode fazer isso com o recurso Mark directory as. Isso afetará a indexação (por exemplo, você pode excluir diretórios de compilação, binários, logs e dados gerados pela indexação) e também a geração do código, as refatorações e a navegação. Descubra mais detalhes.
Detecção do CLion
Se você precisar detectar que o comando CMake no seu projeto foi executado do CLion (e, em caso positivo, definir variáveis/caminhos especiais ou executar alguns scripts adicionais de sua escolha), use a variável de ambiente CLION_IDE. Para facilitar a localização, o CLion fornece complementação de variáveis de ambiente.
Adicionar/excluir arquivos
Ao adicionar um novo arquivo, o CLion sugere adicioná-lo ao destino CMake.
Ao excluir arquivos do projeto, o CLion remove a referência ao arquivo dos argumentos do comando ou avisa sobre um comando possivelmente incorreto após a exclusão.
Importar projeto
Você também pode importar projetos que não são do CMake (File | Import Project...), para os quais o CLion gerará um arquivo CMakeLists.txt.
Geradores CMake
O suporte à API File CMake permite que o CLion habilite vários geradores CMake. Os usuários podem selecionar Ninja, Xcode, Visual Studio, etc. Isso funciona para todas as plataformas, no modo remoto e com WSL.
Saiba maisConfiguração do CMake
Perfis do CMake
Com perfis do CMake (Build, Execution, Deployment | CMake), você tem controle sobre o diretório de geração do CMake, os tipos de configuração do CMake, as opções do CMake e as variáveis de ambiente, entre outros.
Crie qualquer número necessário de perfis do CMake a partir do zero ou copie os existentes (com todas as configurações pré-preenchidas). Armazene sua configuração de build de projetos nas novas e universais Predefinições CMake, que o CLion detectará e importará automaticamente as Predefinições CMake em Perfis CMake.
Alterne entre perfis do CMake usando o alternador de configurações de execução na barra de ferramentas ou no pop-up do alternador de configurações Run (Shift+Alt+F10)/Debug (Shift+Alt+F9).
Janela da ferramentas CMake e Cache do CMake
A janela de ferramentas CMake inclui os logs de saída do CMake, que podem ser usados para rastrear o progresso e depurar scripts do CMake.
Você pode revisar variáveis de cache CMake e atualizar as opções CMake que são transmitidas para o comando CMake numa única UI baseada em tabela em Settings | Build, Execution, Deployment | CMake.
Quando a tabela estiver em foco, comece a digitar para procurar uma variável ou seu valor. O CLion também exibe a descrição curta em dicas de ferramentas para variáveis de cache CMake.
Menu CMake
Acesse Tools | CMake para escolher ações úteis relacionadas ao CMake:
- É possível usar Reload CMake Project para aplicar as alterações mais recentes do CMake e forçar o CLion a recarregar o projeto para refleti-las no editor (o recarregamento automático pode ser habilitado nas configurações de
Build, Execution, Deployment | CMake). - Change Project Root é útil quando o diretório raiz do projeto é diferente do diretório em que o arquivo CMakeLists.txt de nível superior está localizado.
- Reset Cache and Reload Project permite limpar o Cache do CMake sem descartar todos os índices e caches do IDE.
Suporte inteligente para CMake
Renomeação no CMake
Se você usar a refatoração Rename Shift+F6 para renomear símbolos de usuários no CMake (como funções ou macros), todos os usos serão atualizados automaticamente.
Instalação do CMake
Se você tem qualquer destino de instalação do CMake no seu projeto, pode chamar a ação Install no menu Run do CLion. O comando "cmake install" será executado. Como alternativa, você pode adicionar uma etapa de instalação a qualquer uma das suas configurações de execução no CLion.
Comentários CMake
O CLion oferece suporte para argumentos de colchete do CMake 3 e sintaxe de comentários de bloco. Para comentar rapidamente em uma linha no CMake, você não precisa selecioná-la — basta colocar o sinal de intercalação sobre ela e pressionar Ctrl+/ . Para comentar em um bloco, selecione-o e pressione Ctrl+Shift+/.
Assistência de código em CMakeLists.txt
O editor de arquivos CMake no CLion ajuda você a editar arquivos CMakeLists.txt com mais facilidade. Isto inclui:
- Configurações de fontes e cores do CMake.
- A capacidade de expandir e reduzir várias regiões de código no CMake.
- Complementação de código para comandos e variáveis do CMake.
- Complementação de código de
find_packagepara pacotes incluídos com o CMake. - Documentação do comando CMake na complementação de código.
- Exibição da estrutura do CMake.
- Realce com tachado de comandos preteridos no CMake.
Geração de código no CMake
Crie construções de código usadas com frequência ou personalizadas no CMake e reutilize-as com modelos dinâmicos. Selecione entre modelos predefinidos ou crie o seu próprio.
Para usar o modelo, digite sua abreviação (você pode usar a complementação automática aqui também) e pressione Tab (ou qualquer tecla não padrão configurada) para expandi-lo.
Após o termino da edição, aparecerá um banner no qual você pode optar por recarregar o projeto atual manualmente ou habilitar o recarregamento automático em cada edição.
Quick Documentation no CMake
O pop-up Quick Documentation agora está disponível em scripts CMake. A documentação é mostrada para as entidades padrão do CMake:
- Comandos
- Políticas
- Módulos
- Variáveis
- Propriedades
A documentação é sempre renderizada para a versão atualmente incluída do CMake e no momento ainda não está disponível para entidades definidas pelo usuário.
Depurador CMake
Como o CMake é uma linguagem de sistemas de build, nem sempre é fácil investigar erros e detectar comportamentos suspeitos num script CMake. Você pode depurar scripts CMake no CLion como código normal. Defina pontos de interrupção, percorra o código e observe as variáveis e os destinos do CMake. Saiba mais.
Profiling CMake
No CLion, você pode inspecionar visualmente por que está demorando muito para recarregar seu projeto CMake. A partir do CMake 3.18, o novo rastreamento pode ser ativado nas configurações do CMake. O CLion ajudará você a executar o rastreamento e visualizar os resultados. Saiba mais.