package_id
的计算方式¶
让我们以某个包为例,列出其二进制文件
$ conan list "zlib/1.2.13:*" -r=conancenter
Local Cache
zlib
zlib/1.2.13
revisions
97d5730b529b4224045fe7090592d4c1 (2023-08-22 02:51:57 UTC)
packages
d62dff20d86436b9c58ddc0162499d197be9de1e # package_id
info
settings
arch: x86_64
build_type: Release
compiler: apple-clang
compiler.version: 13
os: Macos
options
fPIC: True
shared: False
abe5e2b04ea92ce2ee91bc9834317dbe66628206 # package_id
info
settings
arch: x86_64
build_type: Release
compiler: gcc
compiler.version: 11
os: Linux
options
shared: True
我们可以看到 zlib/1.2.13
最新配方修订版的几个二进制文件。每个二进制文件都由其自己的 package_id
标识,并在其下方,我们可以在 info
下看到该二进制文件的一些信息。这些信息用于计算 package_id
。每当此信息中的任何内容发生更改时,例如体系结构或静态库或共享库,都会计算一个新的 package_id
,因为它表示不同的二进制文件。
package_id
计算为 conaninfo.txt
文件的 sha1 哈希值,其中包含上面显示的 info
。显示此文件相对容易
$ conan install --requires=zlib/1.2.13 --build=missing
# Use the <package-id> listed in the install
$ conan cache path zlib/1.2.13:<package-id>
# cat the conaninfo.txt in the returned path
$ cat <path>/conaninfo.txt
[settings]
arch=x86_64
build_type=Release
compiler=msvc
compiler.runtime=dynamic
compiler.runtime_type=Release
compiler.version=193
os=Windows
[options]
shared=False
$ sha1sum <path>/conaninfo.txt
# Should be the "package_id"!
package_id
是包内 conaninfo.txt
文件的 sha1 校验和。您可以使用 sha1sum
实用程序验证它。
如果现在我们查看 openssl
的二进制文件,我们会看到类似以下内容
$ conan list "openssl/3.1.2:*" -r=conancenter
conancenter
openssl
openssl/3.1.2
revisions
8879e931d726a8aad7f372e28470faa1 (2023-09-13 18:52:54 UTC)
packages
0348efdcd0e319fb58ea747bb94dbd88850d6dd1 # package_id
info
settings
arch: x86_64
build_type: Release
compiler: apple-clang
compiler.version: 13
os: Macos
options
386: False
...
shared: True
requires
zlib/1.3.Z
我们现在看到 conaninfo.txt
包含一个新的部分,即 requires
部分。这是因为 openssl
依赖于 zlib
,并且由于 C 和 C++ 编译模型,依赖项可能会影响使用它们的二进制文件。一些示例是在使用依赖项的 #include
头文件中的内联或模板。
扩展上面的图片
如您所见,即使 settings
和 options
相同,如果依赖项版本发生更改,也会获得不同的二进制文件。在下一节 版本如何影响 package_id 中对此进行了说明。