BuildPatch Tool Instructions (1.4.0)

介绍设置和处理方法(封闭测试版)

阅读时间12分钟

开始之前

如何查找凭证ID

你需要在开发人员门户中找到多个ID。

产品的客户端ID和客户端密钥

  1. 打开 开发人员门户操作面板(Developer Portal Dashboard)> 产品(Product)>游戏服务(Games Services)> 产品设置(Product Settings)按钮。
  2. 产品设置(Product Settings) > SDK凭证(SDK Credentials) > BPT凭证(BPT Credentials) 中查看凭证。

商品的构件名称和ID

  • 转到 产品(Product)>构件(Artifacts) 页面 > 商品构件(Offer Artifact)> 编辑细节(Edit Details) 下拉菜单。

  • 构件名称和ID显示在 管理构件(Manage Artifact) 模态 > 编辑细节(Edit Details) 下拉菜单上。

商品的商品ID

  • 转到 产品(Product)>“商品(Offers)”页面> 商品(Offer)

  • 商品ID位于 编辑商品(Edit Offer) 底部。

查看组织的BuildPatch工具凭证

在你的组织中,任何属于所有者、管理员或商城角色的用户都可以查看产品的BuildPatch工具凭证。他们还可以将证书复制到剪贴板上。

如需查看组织的BuildPatch工具凭证:

  1. 登录开发者门户
  2. 选择你想查看证书的产品。
  3. 选择 产品设置
  4. 向下滚动到 SDK凭证 > BPT凭证
  5. 点击 复制,复制证书到剪贴板:

命令行中的路径

由于命令提示符在命令行上对 \"(反斜杠直接后跟双引号)有独特的解释方式,所以在BuildPatchTool参数中指定路径时,要遵循以下至少一个指导意见:

  • 目录名称不要附加尾部斜杠。
  • 目录分隔符用正斜杠。
  • 不要将路径括在引号内(如果路径包含一个或多个空格,这一点无法做到)。
  • 只有使用反斜杠并且使用双引号时,才需要用另一个反斜杠进行转义(不推荐,因为容易出错)

有效路径示例

  • -BuildRoot="D:/MyFolder/"
  • -BuildRoot=D:\MyFolder\
  • -BuildRoot=D:\MyFolder
  • -BuildRoot="D:\MyFolder"
  • -BuildRoot=D:/MyFolder/
  • -BuildRoot=D:/MyFolder
  • -BuildRoot="D:\MyFolder\\"

无效路径

在命令行中使用路径时,以下路径 无效

-BuildRoot="D:\MyFolder\"

初始设置

BuildPatchTool ZIP 文件的内容提取到可访问待上传版本的机器。 该机器还需要能够联网,以便与Epic后端通信。

注意: ZIP文件链接始终与最新版BPT保持同步更新。如果无法访问该文件,请创建案例

身份验证

身份验证是通过向BuildPatchTool提供 客户端ID客户端密钥 来执行的。必须使用命令行参数为每个操作提供这些信息。

注意: BuildPatchTool使用唯一的客户端ID和客户端密钥,独立于你的游戏可能使用的EOS客户端ID。EOS客户端ID(通常以 xyza 开头)无法用于BuildPatchTool。

凡是与Epic的后端服务进行交互的操作,必须 提供 ClientId 参数。客户端密钥必须使用 ClientSecretClientSecretEnvVar 参数提供。

使用 ClientSecret 参数时,客户端密钥应该一字不差地作为参数值传递:

Engine\Binaries\Win64>BuildPatchTool.exe
-ClientId="<YourClientId>"
-ClientSecret="<YourClientSecret>"