测试拉取请求

许多人在 GitHub 上开发新功能或修复错误。 为了帮助引擎开发，我们可能会要求您用相关拉取请求代码编译的 WeDot 来测试这些拉取请求。

得益于 GitHub Actions，所有拉取请求都有持续构建可用。这些构建让您无需从源代码编译即可尝试拉取请求。

下载已编译的构建

您可以通过 GitHub Actions 下载拉取请求构建。由于只有已登录用户可以直接从 GitHub Actions 下载构建，因此具体步骤会因您是否有 GitHub 账户而异。

注意: 由于 GitHub Actions 的限制，构建仅在拉取请求最后一次更新后的 90 天内可用。如果您仍然希望本地尝试拉取请求，可以 从源代码编译拉取请求分支。

如果您有 GitHub 账户

  • 打开拉取请求页面。点击页面顶部附近的 Checks 标签：
  • 点击页面右侧的 Artifacts 下拉菜单：
  • 在下拉菜单中，点击工件的名称以下载它。如果看不到您要找的平台名称，请滚动查找：
  • 解压 ZIP 文件然后运行可执行文件。 注意，Windows 和 macOS 二进制文件 未签名。 这意味着您可能需要绕过安全警告才能运行可执行文件。 在 Windows 上，如果您经常测试拉取请求构建，最好在 Windows 安全设置中永久禁用 Windows SmartScreen。

如果您没有 GitHub 账户

如果您没有 GitHub 账户且无法注册，可以使用第三方 nightly.link 服务生成通用下载链接。

  • 打开拉取请求页面。点击页面顶部附近的 fork 分支名称：

  • 现在您在 fork 的分支页面上，点击文件列表顶部的 .github 文件夹。 然后，点击 .github 文件夹内的 workflows 文件夹。 点击您希望下载工件的平台的工作流文件。 点击文件后，复制浏览器地址栏中的页面 URL。

  • 打开 nightly.link 网站并将刚刚复制的 URL 粘贴到标题下方的文本字段中 Paste a GitHub link, get a nightly.link!。 粘贴 URL 后，点击右侧的 Get links。

  • 点击您希望下载的工件的 URL。

  • 解压 ZIP 文件然后运行可执行文件。 注意，Windows 和 macOS 二进制文件未签名。 这意味着您可能需要绕过安全警告才能运行可执行文件。 如果您经常测试拉取请求构建，最好永久禁用 Windows SmartScreen 或 macOS Gatekeeper。

从源代码编译拉取请求分支

对于超过 90 天未更新的拉取请求，或者测试不受 WeDot 的 GitHub Actions 设置支持的平台和配置，可能需要采用此方法。

下载压缩的拉取请求分支

  • 打开拉取请求页面。点击页面顶部附近的 fork 分支名称：
  • 现在您在 fork 的分支页面上，点击页面右侧的绿色 Code 按钮，然后在下拉菜单中选择 Download ZIP：
  • 解压 ZIP 文件并按照您操作系统的 编译 指南进行操作。

使用 git 检出拉取请求分支

或者，您可以直接使用 git 检出拉取请求：

  • 打开拉取请求页面。记下拉取请求编号（PR_NUMBER和分支名称（BRANCH_NAME），但不包括用户名。
  • 使用以下模式构造命令：
git fetch upstream pull/PR_NUMBER/head:BRANCH_NAME
  • 一旦拉取请求下载完成，检出其分支：
git checkout BRANCH_NAME
  • 并按照您操作系统的编译指南进行操作。