README.rst

CMake

简介

中文翻译说明

CMake是一个跨平台、开源的构建系统生成器。完整的文档请访问CMake主页和CMake文档页。也可以去CMake社区维基参考有用的资料。

Kitware维护和支持CMake，与此同时也和与富有成效的贡献者社区合作。

许可

CMake是在OSI认证BSD 3条款许可下发布的。详情见Copyright.txt。

构建CMake

支持的平台

• Microsoft Windows
• Apple macOS
• Linux
• FreeBSD
• OpenBSD
• Solaris
• AIX

其他类UNIX操作系统应该也能开箱即用，如果不是的话，将CMake移植到这个平台应该不是什么大问题。请在CMake论坛发帖询问其他人是否有该平台的相关经验。

用CMake构建CMake

你可以使用基于CMake的构建系统将CMake构建为任何其他项目：使用你首选的生成器和选项在此源树上运行已经安装的CMake。然后构建并安装它。

要构建文档，请安装Sphinx并使用-DSPHINX_HTML=ON和/或-DSPHINX_MAN=ON配置CMake以启用"html"或"man"构建器。如果没有自动找到sphinx-build工具，请添加-DSPHINX_EXECUTABLE=/path/to/sphinx-build。

要运行测试套件，构建后在CMake构建目录下运行ctest。详情请参阅CMake测试指南 。

从头开始建造CMake

UNIX/Mac OSX/MinGW/MSYS/Cygwin

你需要有一个支持C++11的C++编译器和一个make。运行你在CMake的源目录中找到的bootstrap脚本。可以使用--help选项来查看支持的选项。可以使用--prefix=<install_prefix>选项指定CMake的自定义安装目录。执行无误后，运行make和make install。

例如，如果你只是想从源代码构建和安装CMake，你可以直接在源代码树中构建：

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

或者，如果你计划开发CMake或以其他方式运行测试套件，创建 一个单独的构建树：

$ mkdir build && cd build
$ ../bootstrap && make

Windows

在Windows下有两种构建CMake的方法：

1. 使用VS 2015或更高版本VS的MSVC编译器。 你需要下载并安装CMake的二进制版本。可以从CMake下载页获得这些版本。然后继续用CMake构建CMake的步骤。

2. 使用MSYS2下的MinGW。 下载并安装MSYS2。然后安装所需的构建工具：

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

   然后和上面一样引导。

报告错误

如果你发现了错误：

1. 如果你有补丁，请阅读CONTRIBUTING.rst文档。
2. 否则，请发布到CMake论坛，询问预期和观察到的行为，以确定它是否是一个真正的错误。
3. 最后，如果上述步骤不能解决问题，在CMake问题跟踪中新开一个条目。

贡献

请参阅CONTRIBUTING.rst，了解如何贡献。