``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` 是作为 `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 中对此进行了解释。

`package_id` 如何计算¶

``package_id`` 如何计算¶