> For the complete documentation index, see [llms.txt](https://chenxiaowei.gitbook.io/cmake-cookbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chenxiaowei.gitbook.io/cmake-cookbook/11.0-chinese/11.4-chinese.md).

# 11.4 以Conda包的形式发布一个简单的项目

**NOTE**:*此示例代码可以在* <https://github.com/dev-cafe/cmake-cookbook/tree/v1.0/chapter-11/recipe-04> *中找到。该示例在CMake 3.5版(或更高版本)中是有效的，并且已经在GNU/Linux、macOS和Windows上进行过测试。*

虽然PyPI是发布Python包的标准平台，但Anaconda (<https://anaconda.org> )更为可能更为流行，因为它不仅允许使用Python接口发布Python或混合项目，还允许对非Python项目进行打包和依赖关系管理。这个示例中，我们将为一个非常简单的C++示例项目准备一个Conda包，该项目使用CMake配置和构建，除了C++之外没有依赖关系。下一个示例中，我们将会来看看一个更复杂的Conda包。

## 准备工作

我们的目标是打包以下示例代码(`example.cpp`)：

```cpp
#include <iostream>
int main() {
    std::cout << "hello from your conda package!" << std::endl;
    return 0;
}
```

## 具体实施

1. `CMakeLists.txt`文件给出了最低版本要求、项目名称和支持的语言:

   ```
   cmake_minimum_required(VERSION 3.5 FATAL_ERROR)
   project(recipe-04 LANGUAGES CXX)
   set(CMAKE_CXX_STANDARD 11)
   set(CMAKE_CXX_EXTENSIONS OFF)
   set(CMAKE_CXX_STANDARD_REQUIRED ON)
   ```
2. 使用`example.cpp`构建`hello-conda`可执行目标：

   ```
   add_executable(hello-conda "")
   target_sources(hello-conda
     PRIVATE
         example.cpp
     )
   ```
3. 使用`CMakeLists.txt`定义安装目标：

   ```
   nstall(
     TARGETS
         hello-conda
     DESTINATION
         bin
     )
   ```
4. 将在一个名为`meta.yaml`的文件中，对Conda包进行描述。我们将把它放在`conda-recipe`目录下，文件结构如下：

   ```
   .
   ├── CMakeLists.txt
   ├── conda-recipe
   │    └── meta.yaml
   └── example.cpp
   ```
5. `meta.yaml`包含如下内容：

   ```yaml
   package:
     name: conda-example-simple
     version: "0.0.0"

   source:
     path: .. /  # this can be changed to git-url

   build:
     number: 0
     binary_relocation: true
     script:
       - cmake -H. -Bbuild_conda -G "${CMAKE_GENERATOR}" -DCMAKE_INSTALL_PREFIX=${PREFIX} # [not win]
       - cmake -H. -Bbuild_conda -G "%CMAKE_GENERATOR%" -DCMAKE_INSTALL_PREFIX="%LIBRARY_PREFIX%" # [win]
       - cmake - -build build_conda - -target install

   requirements:
     build:
       - cmake >=3.5
       - { { compiler('cxx') } }

   about:
     home: http://www.example.com
     license: MIT
     summary: "Summary in here ..."
   ```
6. 现在来构建包：

   ```
   $ conda build conda-recipe
   ```
7. 过程中屏幕上看到大量输出，但是一旦构建完成，就可以对包进行安装。首先，在本地进行测试：

   ```
   $ conda install --use-local conda-example-simple
   ```
8. 现在准备测试安装包，打开一个新的终端(假设Anaconda处于激活状态)，并输入以下内容：

   ```
   $ hello-conda

   hello from your conda package!
   ```
9. 测试成功后，再移除包装：

   ```
   $ conda remove conda-example-simple
   ```

## 工作原理

`CMakeLists.txt`中，安装目标是这个示例的一个基本组件:

```
install(
  TARGETS
      hello-conda
  DESTINATION
      bin
  )
```

目标的二进制文件会安装到`${CMAKE_INSTALL_PREFIX}/bin`中。变量由Conda定义，并且构建步骤中定义在`meta.yaml`：

```yaml
build:
  number: 0
  binary_relocation: true
  script:
    - cmake -H. -Bbuild_conda -G "${CMAKE_GENERATOR}" -DCMAKE_INSTALL_PREFIX=${PREFIX} # [not win]
    - cmake -H. -Bbuild_conda -G "%CMAKE_GENERATOR%" -DCMAKE_INSTALL_PREFIX="%LIBRARY_PREFIX%" # [win]
    - cmake - -build build_conda - -target install
```

将安装目录设置为`${prefix}` (Conda的内部变量)，然后构建并安装项目。调用构建目录命名为`build_conda`的动机与前面的示例类似：特定的构建目录名可能已经命名为`build`。

## 更多信息

配置文件`meta.yaml`可为任何项目指定构建、测试和安装步骤。详情请参考官方文档：<https://conda.io/docs/user-guide/tasks/build-packages/define-metadata.html>

要将Conda包上传到Anaconda云，请遵循官方的Anaconda文档: <https://docs.anaconda.com/anaconda-cloud/user-guide/>

此外，也可以考虑将Miniconda，作为Anaconda的轻量级替代品：<https://conda.io/miniconda.html>