Package 文件: package() 方法¶
我们已经在我们的 hello 包中使用了 package()
方法来调用 CMake 的安装步骤。在本教程中,我们将更详细地解释 CMake.install() 的用法,以及如何修改此方法来执行以下操作,例如
使用 conan.tools.files 工具将生成的 artifacts 从构建文件夹复制到 package 文件夹
复制 package 许可证
管理符号链接的打包
请先克隆源代码以重新创建此项目。你可以在 GitHub 上的 examples2 仓库 中找到它们
$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/tutorial/creating_packages/package_method
在 package() 方法中使用 CMake 安装步骤¶
当你在你的 CMakeLists.txt 中已经定义了从构建和源文件夹中提取 artifacts(头文件、库、二进制文件)到预定位置的功能,并且可能对这些 artifacts 进行一些后处理时,这是最简单的选择。这将在不更改你的 CMakeLists.txt 的情况下工作,因为 Conan 将设置 CMAKE_INSTALL_PREFIX
CMake 变量以指向 recipe 的 package_folder 属性。然后,只需在 CMakeLists.txt 中对创建的目标调用 install() 就足以让 Conan 将构建的 artifacts 移动到 Conan 本地缓存中的正确位置。
cmake_minimum_required(VERSION 3.15)
project(hello CXX)
add_library(hello src/hello.cpp)
target_include_directories(hello PUBLIC include)
set_target_properties(hello PROPERTIES PUBLIC_HEADER "include/hello.h")
...
install(TARGETS hello)
def package(self):
cmake = CMake(self)
cmake.install()
让我们再次构建我们的 package,并注意关于在 Conan 本地缓存中打包文件的行
$ conan create . --build=missing -tf=""
...
hello/1.0: Build folder /Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/b/build/Release
hello/1.0: Generated conaninfo.txt
hello/1.0: Generating the package
hello/1.0: Temporary package folder /Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/p
hello/1.0: Calling package()
hello/1.0: CMake command: cmake --install "/Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/b/build/Release" --prefix "/Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/p"
hello/1.0: RUN: cmake --install "/Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/b/build/Release" --prefix "/Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/p"
-- Install configuration: "Release"
-- Installing: /Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/p/lib/libhello.a
-- Installing: /Users/user/.conan2/p/tmp/b5857f2e70d1b2fd/p/include/hello.h
hello/1.0 package(): Packaged 1 '.h' file: hello.h
hello/1.0 package(): Packaged 1 '.a' file: libhello.a
hello/1.0: Package 'fd7c4113dad406f7d8211b3470c16627b54ff3af' created
hello/1.0: Created package revision bf7f5b9a3bb2c957742be4be216dfcbb
hello/1.0: Full package reference: hello/1.0#25e0b5c00ae41ef9fbfbbb1e5ac86e1e:fd7c4113dad406f7d8211b3470c16627b54ff3af#bf7f5b9a3bb2c957742be4be216dfcbb
hello/1.0: Package folder /Users/user/.conan2/p/47b4c4c61c8616e5/p
正如你所看到的,在调用 cmake.install()
方法后,include 和 library 文件都被复制到了 package 文件夹。
在 package() 方法中使用 conan.tools.files.copy() 和打包许可证¶
对于你不想依赖 CMake 的安装功能,或者你正在使用另一个构建系统的情况,Conan 提供了工具来将选定的文件复制到 package_folder。在这种情况下,你可以使用 tools.files.copy 函数来进行复制。我们可以用自定义的文件复制来替换之前的 cmake.install()
步骤,结果将是相同的。
请注意,我们还在 licenses 文件夹中打包了来自库源的 LICENSE
文件。这是 Conan 包中的常见模式,也可以添加到之前的示例中,使用 cmake.install()
,因为 CMakeLists.txt 不会将此文件复制到 package folder。
def package(self):
copy(self, "LICENSE", src=self.source_folder, dst=os.path.join(self.package_folder, "licenses"))
copy(self, pattern="*.h", src=os.path.join(self.source_folder, "include"), dst=os.path.join(self.package_folder, "include"))
copy(self, pattern="*.a", src=self.build_folder, dst=os.path.join(self.package_folder, "lib"), keep_path=False)
copy(self, pattern="*.so", src=self.build_folder, dst=os.path.join(self.package_folder, "lib"), keep_path=False)
copy(self, pattern="*.lib", src=self.build_folder, dst=os.path.join(self.package_folder, "lib"), keep_path=False)
copy(self, pattern="*.dll", src=self.build_folder, dst=os.path.join(self.package_folder, "bin"), keep_path=False)
copy(self, pattern="*.dylib", src=self.build_folder, dst=os.path.join(self.package_folder, "lib"), keep_path=False)
让我们再次构建我们的 package,并注意关于在 Conan 本地缓存中打包文件的行
$ conan create . --build=missing -tf=""
...
hello/1.0: Build folder /Users/user/.conan2/p/tmp/222db0532bba7cbc/b/build/Release
hello/1.0: Generated conaninfo.txt
hello/1.0: Generating the package
hello/1.0: Temporary package folder /Users/user/.conan2/p/tmp/222db0532bba7cbc/p
hello/1.0: Calling package()
hello/1.0: Copied 1 file: LICENSE
hello/1.0: Copied 1 '.h' file: hello.h
hello/1.0: Copied 1 '.a' file: libhello.a
hello/1.0 package(): Packaged 1 file: LICENSE
hello/1.0 package(): Packaged 1 '.h' file: hello.h
hello/1.0 package(): Packaged 1 '.a' file: libhello.a
hello/1.0: Package 'fd7c4113dad406f7d8211b3470c16627b54ff3af' created
hello/1.0: Created package revision 50f91e204d09b64b24b29df3b87a2f3a
hello/1.0: Full package reference: hello/1.0#96ed9fb1f78bc96708b1abf4841523b0:fd7c4113dad406f7d8211b3470c16627b54ff3af#50f91e204d09b64b24b29df3b87a2f3a
hello/1.0: Package folder /Users/user/.conan2/p/21ec37b931782de8/p
检查 include 和 library 文件是如何打包的。LICENSE 文件也像我们上面解释的那样被复制。
在 package() 方法中管理符号链接¶
你可以在 package 方法中做的另一件事是控制如何打包符号链接。默认情况下,Conan 不会操作符号链接,因此我们提供了一些 工具 来将绝对符号链接转换为相对符号链接,并删除外部或损坏的符号链接。
假设上一个示例中打包的一些文件是指向 Conan 缓存内绝对位置的符号链接。然后,调用 conan.tools.files.symlinks.absolute_to_relative_symlinks()
会将这些绝对链接转换为相对路径,并使 package 可重定位。
from conan.tools.files.symlinks import absolute_to_relative_symlinks
def package(self):
copy(self, "LICENSE", src=self.source_folder, dst=os.path.join(self.package_folder, "licenses"))
copy(self, pattern="*.h", src=os.path.join(self.source_folder, "include"), dst=os.path.join(self.package_folder, "include"))
copy(self, pattern="*.a", src=self.build_folder, dst=os.path.join(self.package_folder, "lib"), keep_path=False)
...
absolute_to_relative_symlinks(self, self.package_folder)
另请参阅