Share via

教程：将端口添加到 vcpkg 开源注册表

  • 项目

本教程指导你如何使用自定义覆盖为 vcpkg 打包库。 建议先阅读打包库教程，然后再继续操作。

先决条件

1 - 创建 vcpkg 存储库分支

  1. 导航到 vcpkg GitHub 存储库。
  2. 单击页面右上角的“创建分支”按钮。
  3. 选择 GitHub 帐户作为分支的目标。

2 - 将分支添加为远程

导航到克隆原始 vcpkg 存储库所在的目录，然后将分支添加为远程分支。 将 <Your-GitHub-Username> 替换为你的 GitHub 用户名。

git remote add myfork https://github.com/<Your-GitHub-Username>/vcpkg.git

可以通过运行以下命令检查远程分支是否已正确添加：

git remote -v

你应会看到 myfork 在远程分支中列出。

3 - 创建主题分支

在进行更改之前，通常最好是创建新分支：

git checkout -b <topic-branch-name>

4 - 将覆盖端口复制到 ports 目录

将在打包库教程中创建的 vcpkg-sample-library 端口添加到 vcpkg\ports 目录：

cp -R <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library>

xcopy <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library> /E

Copy-Item -Path <path/to/vcpkg-sample-library> -Destination <ports/vcpkg-sample-library> -Recurse

5 - 提交和推送更改

  1. 落实更改：

     git add ports/<library-name>
 git commit -m "Add vcpkg-sample-library to vcpkg"

  2. 运行 vcpkg x-add-version：

    vcpkg x-add-version vcpkg-sample-library

  3. 提交版本更改

     git commit -m "version database"

  4. 将更改推送到分支：

    git push myfork <topic-branch-name>

6 - 创建拉取请求

  1. 导航到 GitHub 上的已创建分支的存储库。
  2. 单击“比较 & 拉取请求”按钮。
    1. 验证更改
    2. 添加描述性标题和注释
    3. 填写 pr 审阅清单
  3. 单击“创建拉取请求”。

就这么简单！ 你已成功将 port 添加到 vcpkg 的策展注册表。

后续步骤

有关详细信息，请参阅：