警告:这部分内容我认为暂时不可用!(2023/08/19

时效性提醒 - 最后更新时间:2023/10/15

官网:vcpkg.io
Github:microsoft/vcpkg (github.com)

下载仓库到本地

  1. 按照官网说法,第一步需要克隆仓库(需要Git)。但是默认的使用HTTPS协议克隆好慢,以下是其他方法:

    1. 使用SSH协议来克隆git clone git@github.com:microsoft/vcpkg.git,可以自行切换镜像。

      提示:vcpkg 使用 git 控制其软件库的版本,使用镜像可能会导致更新不及时。

    2. 直接下了.zip压缩包找地方解压。

      提示:之后如果需要进行git push等操作请*手动初始化仓库*

    3. 使用代理。

    *提示:之后所有操作都视作在 vcpkg 根目录下进行,并且使用 Powershell 7 执行。

  2. 官网写着,运行引导脚本来构建 vcpkg ,执行.\bootstrap-vcpkg.bat,是下了个 vcpkg.exe ,下载超时。

    但是它提示了这么一句:下载源地址 -> 下载到本地的目标地址,可以直接把源地址扔浏览器下载,然后把下载好的文件放入对应地址(这次应该是放在根目录,放好的文件路径应该为.\vcpkg.exe)。

开始使用 - vcpkg

  1. 在下载库之前,可以使用.\vcpkg search [packages to install]来搜索是否存在或者了解这个库具体的名字,如果下载失败了也可以搜索一下试试看。

  2. 下载库,使用.\vcpkg install [packages to install]下载库,还是下载超时。

    1. 我选择手动下载

      通过给的下载源地址去把文件下载好。(比如第一次使用会下载 PowerShell-7.2.11-win-x86.zip

      然后放入对应地址(应该是放在根目录的downloads文件夹下,文件路径为.\downloads\[packages].zip)。

      提示:可能有些时候还需要手动更改下载好的文件的文件名,具体看终端的文件路径。

      然后重新执行.\vcpkg install [packages to install]

    2. (待补充……)

开始使用 - 集成到VS工程

  1. 安装好所需要的库后,在终端内(此时位于 vcpkg 根目录)输入.\vcpkg integrate project来生成配置。

  2. 按照输出的提示,打开Visual Studio,上方选项卡选择并打开工具 -> NuGet 包管理器 -> 程序包管理器控制台,往控制台输入终端提示的命令,类似下面这样。

    Install-Package "生成的文件.vcpkg" -Source "<你的vcpkg路径>"
    
  3. 到此完成安装。

可能遇到的问题

手动初始化git仓库

  1. 如果已经下载了 vcpkg-master.zip 并解压来使用,可能会需要手动初始化git仓库,打开终端进入文件夹,输入git init(完成后输出:*Initialized empty Git repository in [你的安装路径]/vcpkg/.git/*)。
  2. 设置远程仓库链接git remote add origin git@github.com:microsoft/vcpkg.git,已经设置过的可以用git remote set-url来修改。