vcpkg 从清单文件安装依赖项

原创已于 2024-10-29 17:06:58 修改 · 1.8k 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#1024程序员节 #包管理器

于 2024-10-23 15:30:21 首次发布

个人经验专栏收录该内容

37 篇文章

订阅专栏

vcpkg 有两种运行模式：经典模式和清单模式。清单文件有自己的 vcpkg_installed 目录，可在其中安装依赖项，与所有包都安装在通用 %VCPKG_ROOT%/installed 目录中的经典模式不同。因此，每个项目都可以有自己的清单和自己的一组依赖项，这些依赖项不会与其他项目的依赖项发生冲突。

1. 创建包含清单的项目

#include <iostream>
#include <sqlite3.h>

int main() {
    sqlite3 *db;
    int exit = 0;

    exit = sqlite3_open("test.db", &db);

    if (exit) {
        std::cerr << "Can't open database: " << sqlite3_errmsg(db) << std::endl;
    } else {
        std::cout << "Opened database successfully!" << std::endl;
    }

    sqlite3_close(db);
    return 0;
}

2. 添加依赖项

2.1 在项目路径打开命令行工具

依次点击工具 -> 命令行 -> 开发者 PowerShell。

2.2 创建清单文件

vcpkg new --application

2.3 添加依赖项

vcpkg add port fmt
vcpkg add port sqlite3

默认 vcpkg-configuration.json 文件引入了基线约束，指定项目应使用的依赖项的最低版本。

3. 手动安装依赖项

只需在包含清单文件的目录中运行 vcpkg install。该命令完成后，所有生成的包都将出现在 vcpkg_installed 目录中。

vcpkg install

4. 构建项目（可选）

默认情况下，Visual Studio 项目中禁用清单模式。要启用清单，请在解决方案资源管理器中右键单击项目，选择属性，选择左侧的 vcpkg 选项卡，然后将 Use Vcpkg Manifest 设置为是。

补充：

1.）已存在清单

error: D:\SynologyDrive\Workstation\Demo\SQLiteDemo\vcpkg.json 下已存在清单。

原因：已经存在 vcpkg.json 文件。

解决：删除 vcpkg.json 文件。

2.）不支持单个包参数

error: 在清单模式下，`vcpkg install` 不支持单个包参数。
要安装其他包，请编辑 vcpkg.json，然后在没有任何包参数的情况下运行 `vcpkg install`。
有关详细信息，请参阅 https://learn.microsoft.com/vcpkg/users/manifests。

原因：使用 vcpkg install 时，多加参数。如：vcpkg install sqlite3。

解决：在清单模式下，直接使用 vcpkg install。

3.）MSB3073错误

严重性代码说明项目文件行禁止显示状态详细信息
错误 MSB3073 命令“"C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\vcpkg\vcpkg.exe" install --x-wait-for-lock --triplet "x64-windows" --vcpkg-root "C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\vcpkg\\" "--x-manifest-root=D:\SynologyDrive\Workstation\Demo\SQLiteDemo\\" "--x-install-root=D:\SynologyDrive\Workstation\Demo\SQLiteDemo\vcpkg_installed\x64-windows\\" ”已退出，代码为 1。 SQLiteDemo C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\vcpkg\scripts\buildsystems\msbuild\vcpkg.targets 183

原因：路径问题、权限问题、锁文件问题、三元组 (Triplet) 问题或清单文件配置错误。

解决：以管理员身份运行 Visual Studio，打开命令行尝试手动安装。