cmake-conan 项目技术文档

cmake-conan 项目技术文档

cmake-conan CMake wrapper for conan C and C++ package manager 项目地址: https://gitcode.com/gh_mirrors/cm/cmake-conan

1. 安装指南

前提条件

• CMake 3.24
• Conan 2.0.5
• 一个基于CMake的项目，包含conanfile.txt或conanfile.py文件，用于列出所需的依赖项。

安装步骤

1. 克隆cmake-conan仓库的develop2分支：

   git clone https://github.com/conan-io/cmake-conan.git -b develop2
   

2. 进入项目目录并创建构建目录：

   cd cmake-conan/example
   mkdir build
   

3. 使用CMake配置项目：

   cmake -B build -S . -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=../conan_provider.cmake -DCMAKE_BUILD_TYPE=Release
   

4. 构建项目：

   cmake --build build --config Release
   

2. 项目的使用说明

示例项目

cmake-conan仓库中包含一个依赖于fmt的示例项目。你可以按照以下步骤运行示例项目：

1. 进入示例项目目录：

   cd cmake-conan/example
   

2. 创建并进入构建目录：

   mkdir build
   cd build
   

3. 使用CMake配置和构建项目：

   cmake -B build -S . -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=../conan_provider.cmake -DCMAKE_BUILD_TYPE=Release
   cmake --build build --config Release
   

在自己的项目中使用

1. 确保在项目的根目录下放置一个conanfile.txt或conanfile.py文件，列出项目所需的依赖项。
2. 在首次调用CMake配置项目时，传递-DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=[path-to-cmake-conan]/conan_provider.cmake参数，以确保在CMake内部调用conan install。

   cd [your-project]
   mkdir build
   cmake -B build -S . -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=[path-to-cmake-conan]/conan_provider.cmake -DCMAKE_BUILD_TYPE=Release
   

3. 项目API使用文档

自定义Conan配置文件

CMake-Conan依赖提供程序将根据CMake检测到的设置创建一个Conan配置文件。你可以通过修改CONAN_HOST_PROFILE和CONAN_BUILD_PROFILE的值来自定义配置文件。例如：

• -DCONAN_HOST_PROFILE="default;auto-cmake"：执行自动检测，并回退到默认配置文件。
• -DCONAN_HOST_PROFILE=clang16：不执行自动检测，使用clang16配置文件。
• -DCONAN_BUILD_PROFILE="/path/to/profile"：提供配置文件的路径。
• -DCONAN_HOST_PROFILE="default;custom"：使用复合配置文件。

自定义conan install调用

你可以通过设置CONAN_INSTALL_ARGS变量来自定义conan install命令的调用。默认情况下，CONAN_INSTALL_ARGS初始化为传递--build=missing。例如：

• --build=never;--update;--lockfile-out=''

4. 项目安装方式

克隆仓库

git clone https://github.com/conan-io/cmake-conan.git -b develop2

配置和构建

cd cmake-conan/example
mkdir build
cmake -B build -S . -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=../conan_provider.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

在自己的项目中使用

cd [your-project]
mkdir build
cmake -B build -S . -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=[path-to-cmake-conan]/conan_provider.cmake -DCMAKE_BUILD_TYPE=Release

通过以上步骤，你可以成功安装和使用cmake-conan项目。

cmake-conan CMake wrapper for conan C and C++ package manager 项目地址: https://gitcode.com/gh_mirrors/cm/cmake-conan