vcpkg manifest 的使用

最近项目上要使用 CMakeLists 管理，由于 Windows 版本有依赖到 vcpkg 提供的库，所以需要使用 vcpkg manifest 来统一设置库的版本，方便后续维护

推荐一个文章，介绍的可以说是非常全面了

• VCPKG 特性 - Versioning

不过里面也有一些过时的特性，我在后面会补充一下

为了防止上面文章的链接失效，故列出一些常用的命令

这是一个完整的 vcpkg.json

原文中说使用 git rev-parse HEAD 获取 builtin-baseline 其实是不准确的

git rev-parse HEAD 是获取 .git 中当前分支的最新 commit_id，这与库是没什么关系的，如下

所以说用上述方法查看 builtin-baseline 是不准确的，包括后面说的使用 x-history 命令也是过时的

新方法是使用 git blame -l 方法

相关文档：How do I get history versions of a port now

实际使用：

c- 就是 versions 文件夹的子文件夹

 curl.json 是 c- 文件夹下的 json 文件

那 versions 与 builtin-baseline 是如何配合使用呢？

借助一开始文章链接，我贴出主要部分，

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。

在 vcpkg 中，版本是如何比较大小呢？实际是比较版本的新旧，例如：

以上大概都是能用到的知识

---

下面是我在项目中遇到的一些问题包括尝试的解决方案：

第一个问题：

因为 manifest 无法识别 "triplet" 字段，故无法在 vcpkg,json 中指定该字段，只能在外部创建本地的 vcpkg 三方库

最后会在项目的 build 文件下生成相关库

第二个问题：

我们随便打开一个自动生成的 vcpkg.json 会发现多了一些字段，比如 “port-version”

“port-version” 其实就是补丁，上面有提到，那么如何获取呢？

我们拿 curl 来举例，git show xxx(git show 命令后跟着一个特定的文件路径参数可以用于查看 Git 仓库中特定文件在指定提交（17fc556532840f436f67f8d08c943d1ff97ea2f9）的版本)

可以看到 port_version 是 2，git-tree 是 commit-id，跟 builtin-baseline 不同，我们一般用不到它

顺便补充下图：

最下面的图显示的绿颜色字符都是新增的，说明当前分支新增了一个 8.2.1  的版本