其他分享
首页 > 其他分享> > VCPKG 特性 - Versioning

VCPKG 特性 - Versioning

作者:互联网

背景

在实际项目中,您的项目代码需要依赖第三方库的历史版本,以往的做法是将vcpkg回退到需要使用的版本,或者是自定义版本,这会导致其他的库也回退到以前的版本。 现在vcpkg提供了versioning 特性,可以方便地解决这个问题。Versioning 特性是默认开启的,不需要额外的设置来启用。注意:此特性依赖于manifest模式,使用这个特性前请先了解manifest特性。

使用示例

1. 创建一个简单的cmake工程, 然后让它依赖于 fmt 和 zlib, 假设需要依赖fmt版本大于等于 7.1.3。 创建文件夹 versioning 并包含以下3个文件 vcpkg.json,main.cpp, CMakeLists.txt:

 vcpkg.json:

{
    "name": "versions-test",
    "version": "1.0.0",
    "dependencies": [
     {
        "name": "fmt",
        "version>=": "7.1.3"
      },
      "zlib"
    ],
    "builtin-baseline": "99dc49dae7e170c3be63dd097230007f3bb73c4f"
}

 main.cpp:

#include <fmt/core.h>
#include <zlib.h>
int main()
{
    fmt::print("fmt version is {}\n"
               "zlib version is {}\n",
               FMT_VERSION, ZLIB_VERSION);
    return 0;
}

 CMakeLists.txt:

cmake_minimum_required(VERSION 3.18)

project(versionstest CXX)
add_executable(main main.cpp)

find_package(ZLIB REQUIRED)
find_package(fmt CONFIG REQUIRED)
target_link_libraries(main PRIVATE ZLIB::ZLIB fmt::fmt)

 

现在可以构建和运行cmake工程:

1. 创建cmake工程构建目录:

E:\vcpkg\vcpkgtest\versioning>mkdir build
E:\vcpkg\vcpkgtest\versioning>cd build

 2. 配置CMake工程:

cmake -G "Visual Studio 16 2019" -DVCPKG_TARGET_TRIPLET=x64-windows "-DCMAKE_TOOLCHAIN_FILE=E:/vcpkg/vcpkg_debug/vcpkg/scripts/buildsystems/vcpkg.cmake" ..
E:\vcpkg\vcpkgtest\versioning\build>cmake  -G "Visual Studio 16 2019" "-DCMAKE_TOOLCHAIN_FILE=E:/vcpkg/vcpkg_debug/vcpkg/scripts/buildsystems/vcpkg.cmake" ..
-- Running vcpkg install
Detecting compiler hash for triplet x64-windows...
A suitable version of powershell-core was not found (required v7.1.3). Downloading portable powershell-core v7.1.3...
Extracting powershell-core...
The following packages will be built and installed:
    fmt[core]:x64-windows -> 7.1.3 -- E:\vcpkg\vcpkg_debug\vcpkg\buildtrees\versioning\versions\fmt\dd8cf5e1a2dce2680189a0744102d4b0f1cfb8b6
    zlib[core]:x64-windows -> 1.2.11#9 -- E:\vcpkg\vcpkg_debug\vcpkg\buildtrees\versioning\versions\zlib\827111046e37c98153d9d82bb6fa4183b6d728e4
Using cached binary package: C:\Users\phoebe\AppData\Local\vcpkg\archives\c1\c1284fcdc26b903209c61a3a1cdaf0c511f63183f33d6586b7012a778638af17.zip
Could not locate cached archive: C:\Users\phoebe\AppData\Local\vcpkg\archives\66\6651ef3a357c7ae220bedb6037b75b52421c637c7ecce7da40b8ac8a5067686c.zip
Starting package 1/2: fmt:x64-windows
…
Stored binary cache: C:\Users\phoebe\AppData\Local\vcpkg\archives\66\6651ef3a357c7ae220bedb6037b75b52421c637c7ecce7da40b8ac8a5067686c.zip
Building package zlib[core]:x64-windows... done
Installing package zlib[core]:x64-windows...
Installing package zlib[core]:x64-windows... done
Elapsed time for package zlib:x64-windows: 12.73 s
 
Total elapsed time: 13.39 s
 
-- Running vcpkg install - done
-- Selecting Windows SDK version 10.0.19041.0 to target Windows 10.0.19043.
-- The CXX compiler identification is MSVC 19.28.29915.0
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.28.29910/bin/Hostx64/x64/cl.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Found ZLIB: optimized;E:/vcpkg/vcpkgtest/versioning/build/vcpkg_installed/x64-windows/lib/zlib.lib;debug;E:/vcpkg/vcpkgtest/versioning/build/vcpkg_installed/x64-windows/debug/lib/zlibd.lib (found version "1.2.11")
-- Configuring done
-- Generating done
-- Build files have been written to: E:/vcpkg/vcpkgtest/versioning/build
Output

3. 构建cmake工程:

E:\vcpkg\vcpkgtest\versioning\build>cmake --build .
Microsoft (R) Build Engine version 16.9.0+5e4b48a27 for .NET Framework
Copyright (C) Microsoft Corporation. All rights reserved.

Checking Build System
Building Custom Rule E:/vcpkg/vcpkgtest/versioning/CMakeLists.txt
main.cpp
main.vcxproj -> E:\vcpkg\vcpkgtest\versioning\build\Debug\main.exe
Building Custom Rule E:/vcpkg/vcpkgtest/versioning/CMakeLists.txt

4. 运行cmake工程:

E:\vcpkg\vcpkgtest\versioning\build>.\Debug\main.exe
fmt version is 70103
zlib version is 1.2.11

 请重点关注以下输出:

fmt[core]:x64-windows -> 7.1.3 -- E:\vcpkg\vcpkg_debug\vcpkg\buildtrees\versioning\versions\fmt\dd8cf5e1a2dce2680189a0744102d4b0f1cfb8b6
zlib[core]:x64-windows -> 1.2.11#9 -- E:\vcpkg\vcpkg_debug\vcpkg\buildtrees\versioning\versions\zlib\827111046e37c98153d9d82bb6fa4183b6d728e4

可以看到 fmt选用了7.1.3版本, 而不是使用了本地 .\ports\fmt 提供的版本。注意:cmake3.18 及以后的版本才支持输出日志到命令框。如果使用cmake 3.18之前的版本,则需要从当前目录vcpkg-manifest-install.log 文件查看输出信息。

Versioning 字段

下面介绍versioning特性中涉及到的3个关键字段:

overrides

如果想指定fmt的版本,例如6.0.0, 而不是自动从baseline中查找,可以通过添加overrides去实现。它会覆盖任何其他的配置,而使用指定的 6.0.0 版本,这个方式对于解决版本之间的冲突问题特别实用。示例:

 vcpkg.json 文件:

{
    "name": "versions-test",
    "version": "1.0.0",
    "dependencies": [
    {
      "name": "fmt",
      "version>=": "7.1.3"
     },
     "zlib"
    ],
    "builtin-baseline": "99dc49dae7e170c3be63dd097230007f3bb73c4f",
    "overrides": [
    {
       "name": "fmt",
       "version": "6.0.0"
     }
    ]
}

builtin-baseline

关注以上示例中的zlib,可以发现 vcpkg.json 文件中并没有声明任何版本,它使用的版本为1.2.11#9,这个版本其实就是来源于 builtin-baseline。以下是获取 builtin-baseline 的方法:

1. builtin-baseline 实际上是vcpkg仓库包含的 commit id,实际操作中我们可以通过执行以下git命令来获取vcpkg库最新的 commit id:

git rev-parse HEAD

实际上,vcpkg是通过以下命令来获取该commit中包含的baseline.json 文件版本。 

git show 99dc49dae7e170c3be63dd097230007f3bb73c4f:versions/baseline.json

 2. 若需要查找某个库对应的历史版本,可以使用以下命令:       

 vcpkg x-history PORT_NAME

 注意:只能选择 date > 1/22/2021 以后的 version 所对应的 vcpkg commit, 将其设置为 builtin-baseline。这是因为在这之后,vcpkg才支持versioning特性,才有 baseline.json 文件。 例如:

 E:\vcpkg\clean\vcpkg> ./vcpkg x-history fmt
             version          date    vcpkg commit
             7.1.3#5    2021-07-01    9a7d5a29dd0e066ff4a7dbeba4bd8af4daae8b60
             7.1.3#4    2021-04-28    345921bce4ee724d4c5b164eb93d051667d2d990
             7.1.3#3    2021-04-07    5f77fef68d9f2f5ddc921432914dcbf92b31e989
             7.1.3#2    2021-03-18    c8f6537b80831b1bd951b764bb4fa1f1c7973d83
             7.1.3#1    2021-02-28    3426db05b996481ca31e95fff3734cf23e0f51bc
             7.1.3#0    2020-11-30    1380e8fd4aabfb502023fb8c640fb7b5d73834e9
             7.1.2#0    2020-11-06    d218ca7e6f6eab8679d2e968b43a208e689ac920
             7.1.1#0    2020-11-03    c4c020828aa1b743707876ffaeb0dccf091e96f5
             7.1.0#0    2020-10-26    c31cfd3c81a792d7073e71e8e4f9ab604f0f305e
             7.0.3#3    2020-10-08    54dbd5ca9e808d3437a364c434bff7c6621f42ae
             7.0.3#2    2020-09-04    d951a0033260a63e8d82c64ee1514b1c53364b55
             7.0.3#0    2020-08-07    fbb5131bbc6a66d3950fdd44fbeca85d67fb0ff0
             7.0.2#0    2020-08-06    4f9117c0dea8e58be6dc4102e40238f57b7b8533
             6.2.1#0    2020-06-11    8d399bd86b94fdb4abf8d5c56f2a94b2d3aefda5
           6.2.0-1#0    2020-06-02    c5c350086508005af936a185949e910bfda2821d
             6.2.0#0    2020-04-09    279867cb0c22b1251c5dd50f2dc17030ed9861c9
             6.1.2#0    2020-03-02    705764c63549953c049b34c7a2d67b377d0bd006
           6.0.0-1#0    2020-01-06    153cab79c76175118f5b5d28135a57e00ae75a8d
             6.0.0#0    2019-08-27    8b7f940d82f829bb7d6dbf986225d69b07cbcb40
           5.3.0-2#0    2019-06-15    18b029a5e3997fa4fdc7d3d06d56568a1d6f74ad
           5.3.0-1#0    2019-03-16    d7bf0e581942fca27ef9bf79c6684c8d19ae1967
             5.3.0#0    2019-01-14    e86780d75ffb4476f58c725d40e2456eb503b766
             5.2.1#0    2018-10-25    9c62c6a37ac940abbb4f19237d9a891881421a1a
             5.2.0#0    2018-09-19    64a7483a4a4c9d176896ec7aec08a6acef4ea8f3
             5.1.0#0    2018-07-10    0606add12f907733deba699611eb8692c6c4be9e
           5.0.0-1#0    2018-06-28    3a5b12004e4d9854f4a44337d5fa986b910c6bd6
             5.0.0#0    2018-05-29    b82bbc4945a550c070af351fd769885047b54557
             4.1.0#0    2017-12-26    178517052f42d428bb2f304946e635d3c1f318e9
           4.0.0-1#0    2017-09-09    26516fe485b0e9048dd4809256a7e4526957c6e9
             4.0.0#0    2017-06-27    0ee8ad5cb2ed21731885fa40bd0e2776eec39c71
             3.0.2#0    2017-06-15    2752e690b9230e8078d0688f0b9830874d0662df
           3.0.1-4#0    2017-02-09    43665857a3ad11de8135c7fd6cd9839269212d7d
           3.0.1-3#0    2017-02-03    95af9aac7c39765d1524b7c9c39dc283e9f0facf
           3.0.1-2#0    2017-02-02    62e7557545c17462670b7741d74dd2db4f5612eb
           3.0.1-1#0    2017-01-10    4f5f52ff470e83fa041ac4c6797bfa4e61ed2501
             3.0.1#0    2016-11-22    1f22f927e2f2ba1eb8c702ced4bc6ad811da2bdc
           3.0.0-1#0    2016-11-10    b56819ec88f85d401160197b578b508916ac9962
             3.0.0#0    2016-09-28    36799555441089420f29fcb2724d9fde23bc9ec1
vcpkg x-history fmt

 builtin-baseline 具体作用过程:

1. 从给定的 builtin-baseline(commit id)版本中查找是否含有 baseline.json 文件,如果有,就从这个文件中查找该库的版本。

2. 如果没有baseline.json,就会报错。

3. 如果有baseline.json,但是它不包含库的历史版本,也会报错。

version>=

以上示例中,zlib 的版本号 1.2.11#9 是由 version 和 port-version 两部分组成,version(1.2.11) 是zlib的实际的版本号,port-version(9) 是这个版本在vcpkg中的补丁版本。两者组合可以获取该库在vcpkg中的具体版本。

当version 版本更新时,port-version 重置为0 ,每次改动都加1。如上图所示,记录中从上到下显示了fmt版本的补丁修正与版本更新。

 在vcpkg中,版本是如何比较大小呢?实际是比较版本的新旧,例如:

1.2.0 < 1.2.0#1 < 1.2.0#2 < 1.2.0#10
2021-01-01#20 < 2021-01-01.1
windows#7 < windows#8

 注意:

1. Version>=  主要用于表示需要使用的最低版本,只有作为 "dependencies"的一部分时才是被允许的。

2. 如果使用Version>=, vcpkg会从所有满足条件的版本中选用最低版本,这种做法的好处是更新vcpkg时,避免依赖升级出现异常的问题。可以总结为:

如果使用 overrides,那么会使用 overrides 提供的版本,例如 fmt 6.0.0。如果没有,会选择 version>= 和 builtin-baseline 中最高的版本,例如:

    version>= 7.1.3  +  builtin-baseline(7.1.4) , 会安装 fmt 7.1.4;

    version>= 7.1.3  +  builtin-baseline(7.1.2) , 会安装 fmt 7.1.3。

3. Vcpkg允许升级版本,例如: 如果zlib依赖fmt,而且声明依赖fmt 的 7.1.4 版本,那么vcpkg就会安装 7.1.4 版本,而不是 7.1.3。

4. 在您的项目中,如果想升级依赖库的版本,只需把最低版本改掉,或者是把 builtin-baseline 改为更新的版本。

5. Vcpkg 不会比较version类型不同的版本,例如:同一个库的2 个版本 ‘version-string: 7.1.3’ 与 `version: 7.1.4`,version 类型不同,所以不能比较。

Versions 文件

在vcpkg 的仓库中,文件夹https://github.com/microsoft/vcpkg/tree/master/versions 目录下,有baseline.json文件及对应 portname.json 文件。

例如 zlib:baseline.json 文件包含zlib 当前最新的版本,versions/z-/zlib.json 中包含vcpkg 中 zlib的所有可选版本:

{
  "versions": [
    {
      "git-tree": "53a4615c8bb9b98a3864b834a6bbe51cc6c849ef",
      "version-string": "1.2.11",
      "port-version": 10
    },

    {
      "git-tree": "827111046e37c98153d9d82bb6fa4183b6d728e4",
      "version-string": "1.2.11",
      "port-version": 9
    }
}

  示例中git-tree是 SHA 哈希值,是由 以下 git 命令获取的:

git rev-parse <commit>:<path>
E:\vcpkg\vcpkg_debug\vcpkg> git rev-parse HEAD:ports/zlib
53a4615c8bb9b98a3864b834a6bbe51cc6c849ef

 每次更新时,只需要执行 'vcpkg x-add-version zlib' 或者 'vcpkg x-add-version --overwrite-version zlib' 会自动更新zlib.json文件,不需要手动获取git-tree SHA 哈希值。可以使用 'vcpkg x-add-version --all' 去更新所有port的版本。

参考: 

https://github.com/microsoft/vcpkg/blob/master/docs/examples/versioning.getting-started.md

https://github.com/microsoft/vcpkg/blob/master/docs/users/versioning.md

标签:7.1,fmt,zlib,特性,version,vcpkg,版本,VCPKG,Versioning
来源: https://www.cnblogs.com/vcpkg/p/15019907.html