CMake

CMake

Introdução

CMake é um gerador de sistema de construção de código aberto e multiplataforma. Para documentação completa, visite a página inicial do CMake e a página de documentação do CMake. O CMake Community Wiki também faz referência a guias e receitas úteis.

CMake é mantido e apoiado pela Kitware e desenvolvido em colaboração com uma comunidade produtiva de colaboradores.

Licença

CMake é distribuído sob a licença BSD de 3 cláusulas aprovada pela OSI. Consulte Copyright.txt para obter detalhes.

Construindo CMake

Plataformas suportadas

• Microsoft Windows

• MacOS da Apple

• Linux

• FreeBSD

• OpenBSD

• Solaris

• AIX

Outros sistemas operacionais do tipo UNIX podem funcionar muito imediatamente; caso contrário, não será um grande problema portar o CMake para esta plataforma. Por favor, poste no Fórum de Discurso do CMake para perguntar se outras pessoas tiveram experiência com a plataforma.

Construindo CMake com CMake

Você pode construir o CMake como qualquer outro projeto com um sistema de construção baseado em CMake: execute um CMake já instalado nesta árvore de origem com seu gerador e opções preferidos. Em seguida, construa-o e instale-o.

Para construir a documentação, instale o Sphinx e configure o CMake com -DSPHINX_HTML=ON e/ou -DSPHINX_MAN=ON para habilitar o construtor "html" ou "man". Adicione -DSPHINX_EXECUTABLE=/path/to/sphinx-build se a ferramenta não for encontrada automaticamente.

Para executar o conjunto de testes, execute ctest no diretório de construção do CMake após a construção. Consulte o Guia de testes do CMake para obter detalhes.

Construindo o CMake do zero

UNIX/Mac OSX/MinGW/MSYS/Cygwin

Você precisa ter um compilador C++ (suportando C++11) e um make instalado. Execute o script bootstrap que você encontra no diretório de origem do CMake. Você pode usar a opção --help para ver as opções suportadas. Você pode usar a opção --prefix= para especificar um diretório de instalação personalizado para o CMake. Assim que terminar com sucesso, execute make e make install .

Por exemplo, se você simplesmente deseja compilar e instalar o CMake a partir do código-fonte, você pode compilar diretamente na árvore de origem:

 $ ./bootstrap && make && sudo make install

Ou, se você planeja desenvolver o CMake ou executar o conjunto de testes, crie uma árvore de construção separada:

 $ compilação mkdir && compilação cd
$ ../bootstrap && make

Windows

Existem duas maneiras de construir o CMake no Windows:

1. Compile com MSVC do VS 2015 ou posterior. Você precisa baixar e instalar uma versão binária do CMake. Você pode obter esses lançamentos na página de download do CMake. Em seguida, prossiga com as instruções acima para Construir CMake com CMake.

2. Bootstrap com MinGW em MSYS2. Baixe e instale o MSYS2. Em seguida, instale as ferramentas de compilação necessárias:

    $ pacman -S --needed git base-devel mingw-w64-x86_64-gcc

   e bootstrap como acima.

Relatando erros

Se você encontrou um bug:

1. Se você tiver um patch, leia o documento CONTRIBUTING.rst.

2. Caso contrário, poste no Fórum de Discurso do CMake e pergunte sobre os comportamentos esperados e observados para determinar se é realmente um bug.

3. Finalmente, se o problema não for resolvido pelas etapas acima, abra uma entrada no CMake Issue Tracker.

Contribuindo

Consulte CONTRIBUTING.rst para obter instruções sobre como contribuir.