如何计算 `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 最新 recipe 修订版的几个二进制文件。每个二进制文件都由其自己的 package_id 标识，在它下面我们可以看到 info 下的该二进制文件的一些信息。此信息用于计算 package_id。每次此信息发生更改时，例如架构，或者作为静态库还是共享库，都会计算新的 package_id，因为它代表不同的二进制文件。

package_id 被计算为包含上面显示的 info 的 conaninfo.txt 文件的 sha1 哈希值。显示此文件相对容易

$ 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。

如何计算 package_id¶

如何计算 `package_id`¶