测试拉取请求

许多人正在GitHub上开发新功能或修复错误。为了帮助引擎开发,你可能会被要求用Godot构建来测试这些拉取请求,该构建包括有关拉取请求中的代码。

感谢GitHub Actions,所有的 拉取请求pull requests 都有持续构建。这些构建可以让你尝试拉取请求,而不需要从源代码编译任何东西。

下载编译后的版本

你可以从GitHub Actions中下载拉取请求构建。由于只有已登录的用户可以直接从GitHub Actions下载构建,因此根据你是否有GitHub账户,程序会有所不同。

备注

由于GitHub Actions的限制,构建只在拉取请求最后更新后的90天内可用。如果你仍然希望在本地尝试拉取请求,你可以 从源代码编译拉取请求 分支来代替。

如果你有一个GitHub账户

  • 打开拉取请求页面。点击页面顶部附近的 检查Checks 标签:

../../_images/testing_pull_requests_access_checks.png

  • 在左边出现的平台列表中,通过点击选择你的平台,然后选择你需要的构建类型,编辑器或导出模板。如果有疑虑,请选择一个编辑器构建:

../../_images/testing_pull_requests_checks_platforms.png

  • 点击页面右侧的 工件Artifacts 下拉菜单,然后点击工件的名称来下载它:

../../_images/testing_pull_requests_checks_artifacts.png

  • 提取ZIP档案,然后运行可执行文件。注意,Windows和macOS的二进制文件是没有代码签名的。这意味着你可能必须在运行可执行文件之前绕过安全警告。如果你经常测试拉取请求的构建,可能最好永久地禁用Windows SmartScreen或 禁用macOS Gatekeeper

如果你没有GitHub账户

如果你没有GitHub账户,也无法注册,你可以使用第三方的 nightly.link 服务来生成一个通用的下载链接。

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

../../_images/testing_pull_requests_access_fork.png

  • 现在你在 fork 的分支页面上,点击文件列表顶部的 .github 文件夹。然后,点击 workflows 文件夹(位于 .github 文件夹内)。点击你想下载工件的平台的工作流程文件。在点击文件(打开文件视图)之后,从浏览器的地址栏复制页面 URL。

  • 打开 nightly.link 网站,将刚才复制的 URL 粘贴到 Paste a GitHub link, get a nightly.link! 标题下的文本字段。粘贴完 URL 后,点击右侧的 Get Links 。如果你粘贴的 URL 格式正确,你应该看到一个像这样的页面:

../../_images/testing_pull_requests_nightly_link.png

  • 点击你想下载的工件的URL。

  • 提取ZIP档案,然后运行可执行文件。注意,Windows和macOS的二进制文件是没有代码签名的。这意味着你可能必须在运行可执行文件之前绕过安全警告。如果你经常测试拉取请求的构建,可能最好永久地禁用Windows SmartScreen或 禁用macOS Gatekeeper

从源编译拉取请求分支

对于最后一次更新超过90天的拉取请求,或者在Godot的GitHub Actions设置不支持的平台和配置上进行测试,可能需要采用这种方法。

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

../../_images/testing_pull_requests_access_fork.png

  • 现在你在fork的分支页面上,点击页面右侧的绿色 Code 按钮,然后在下拉菜单中选择 下载ZIP :

../../_images/testing_pull_requests_fork_zip.png

  • 提取ZIP压缩包,并按照你的操作系统的 编译compiling 说明。