创建与 Conan 无关的依赖项部署供开发者使用¶

使用 full_deploy 部署器，可以创建一份与 Conan 无关的依赖项副本，开发者无需在其计算机上安装 Conan 即可使用这些依赖项。

在大多数情况下，常用且推荐的流程是直接从 Conan 缓存中使用 Conan 包

../../../../_images/packages_from_cache.png

然而，在某些情况下，将依赖项的副本部署到用户文件夹中可能会很有用，这样依赖项就可以位于该文件夹中，而不是 Conan 缓存中。使用 Conan 部署器可以实现这一点。

让我们通过一个示例来看一看。所有源代码都在 examples2.0 Github 仓库中。

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/extensions/deployers/development_deploy

在该文件夹中，我们可以找到以下 conanfile.txt 文件：

[requires]
zlib/1.2.13

[tool_requires]
cmake/3.25.3

[generators]
CMakeDeps
CMakeToolchain

[layout]
cmake_layout

该文件夹还包含一个标准的 CMakeLists.txt 和一个 main.cpp 源文件，可以创建一个与 zlib 库链接的可执行文件。

我们可以安装 Debug 和 Release 依赖项，并使用以下命令部署本地副本：

$ conan install . --deployer=full_deploy --build=missing
$ conan install . --deployer=full_deploy -s build_type=Debug --build=missing

这将创建以下文件夹：

├──src
├──build
│   ├──generators
|         └── ZLibConfig.cmake
├──full_deploy
│   ├──build
│   │   └──cmake
│   │       └──3.25.3
│   │           └──x86_64
│   │               ├──bin
│   │
│   └──host
│       └──zlib
│           └──1.2.13
│               ├──Debug
│               │   └──x86_64
│               │       ├──include
│               │       ├──lib
│               └──Release
│                   └──x86_64
│                       ├──include
│                       ├──lib

（请注意，您可以使用 --deployer-folder 参数来更改部署器输出的基本文件夹路径）

这个文件夹是完全自包含的。它包含必要的工具（例如 cmake 可执行文件）、zlib 的头文件和编译后的库，以及 build/generators 文件夹中指向 full_deploy 内部二进制文件的必要文件，例如使用相对路径引用的 ZLibConfig.cmake。

../../../../_images/independent_dependencies_deploy.png

可以移除 Conan 缓存，甚至卸载 Conan，然后将该文件夹移动到计算机的其他位置或复制到另一台计算机，前提是它具有相同的操作系统、编译器等配置。

$ cd ..
$ cp -R development_deploy /some/other/place
$ cd /some/other/place

开发者可以按如下方式使用这些文件：

Windows¶

$ cd build
# Activate the environment to use CMake 3.25
$ generators\conanbuild.bat
$ cmake --version
cmake version 3.25.3
# Configure, should match the settings used at install
$ cmake .. -G \"Visual Studio 17 2022\" -DCMAKE_TOOLCHAIN_FILE=generators/conan_toolchain.cmake
$ cmake --build . --config Release
$ Release\compressor.exe
ZLIB VERSION: 1.2.13

Linux 和 OSX 中的环境脚本不可重定位，因为它们包含绝对路径，并且 sh shell 无法为源文件提供访问当前脚本目录的方法。

这不应该是一个大的障碍，因为可以使用 sed 在 generators 文件夹中进行“查找和替换”来修复它。

Linux¶

$ cd build/Release/generators
# Fix folders in Linux
$ sed -i 's,{old_folder},{new_folder},g' *
# Fix folders in MacOS
$ sed -i '' 's,{old_folder},{new_folder},g' *
$ source conanbuild.sh
$ cd ..
$ cmake --version
cmake version 3.25.3
$ cmake ../.. -DCMAKE_TOOLCHAIN_FILE=generators/conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release
$ cmake --build .
$ ./compressor
ZLIB VERSION: 1.2.13

注意

最佳实践

虽然这种流程是可能的，但这并不意味着在大多数情况下推荐使用它。它有一些限制：

效率较低，需要额外复制一份依赖项
目前只有 CMakeDeps 和 CMakeToolchain 是可重定位的。对于其他构建系统集成，请在 Github 上创建工单。
Linux 和 OSX shell 脚本不可重定位，需要手动使用 sed
二进制变化仅限于 Release/Debug。生成的文件仅适用于当前配置，更改任何其他设置（操作系统、编译器、架构）将需要重新部署。

一般来说，建议正常使用缓存。这种“可重定位的开发部署”对于向不使用 Conan 的项目消费者分发看起来像 SDK 的最终产品可能很有用。