上传游戏编译版本

要将游戏编译版本上传到更新服务器，请使用上传助手命令行工具。

上传助手系统要求：

  • Windows 7/8/10 64位操作系统或macOS 10.14.0及更高版本
  • 1.6 GHz CPU
  • 100 MB可用内存
  • 可用磁盘空间：1.5 x 游戏编译版本大小

上传助手接受以下选项：

  • --init — 初始化该工具。
  • --update — 将游戏编译版本发送至服务器。
  • --builds-list — 游戏编译版本列表。
  • --descr <build-description> — 编译版本描述。
  • --api-key <API-key> — API密钥。
  • --game-path <path-to-game> — 游戏编译版本的路径。
  • --chunk-size <chunk-size> — 文件块大小，即游戏压缩包分成的文件块大小。单位可以是MB或GB。支持的值为10mb到5120mb，或1gb到5gb。默认为5gb。
  • --retry-timeout <timeout> — 上传文件尝试之间的超时值，单位为秒。支持的值为10到60，默认为20。
  • --retry-count <retry-count> — 上传文件的尝试次数。支持的值为1到10，默认为3。
  • --set-build-on-test — 将游戏编译版本置于test阶段。游戏将仅对测试可用。
  • --set-build-on-master — 将游戏编译版本置于master阶段。游戏将对最终用户可用。如果指定了--set-build-on-test，将忽略此选项。

要上传游戏编译版本：

  1. 前往发布商帐户 > 编译版本设置。
  2. 复制API密钥。
  3. 下载并安装上传助手。
  4. 初始化该工具。
  5. 上传游戏编译版本到服务器。
  6. 将游戏编译版本置于暂存。
  7. 设置游戏文件。

下载及安装上传助手

要下载及安装上传助手：

  1. 在游戏部分，单击游戏右侧的设置。
  2. 前往编译版本 > 游戏编译版本。
  3. 单击符合您操作系统的BuildLoader.zip下载上传助手的压缩包。
  4. 提取压缩包内容。

工具相对于解压缩包文件夹的位置：

  • 对于Windows：Win\build_loader.exe
  • 对于MacOS：Mac/build_loader

初始化上传助手

要初始化上传助手：

  1. 在游戏部分，单击游戏右侧的设置。
  2. 前往编译版本 > 游戏编译版本部分。
  3. 单击API密钥（启动器ID）中的+图标复制API密钥。上传助手需使用该密钥将您的游戏上传到服务器。
  4. 运行以下命令初始化该工具：

将游戏编译版本上传到服务器

要将游戏编译版本上传到服务器，请运行以下命令：

如初始化工具或上传上一个编译版本时已指定过该参数，则可省略--game-path参数。 首次上传时，更新服务器将接收整个游戏编译版本。之后，其将接收上传助手生成的补丁。
注：
强烈建议您指定--descr参数，以便区分上传的不同编译版本。
要查看游戏编译版本：
  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击启动器。
  3. 在游戏部分，单击游戏右侧的设置。
  4. 前往编译版本 > 游戏编译版本。
  5. 向下滚动至游戏编译版本表格。
注：
如游戏编译版本包含会在游戏过程中改变的文件（如设置、用户资料或保存文件），请将它们添加到忽略文件列表。否则启动器在更新游戏时会检测到文件完整性冲突进而重新下载整个游戏

将游戏编译版本置于相应阶段

您可以进行如下操作将游戏编译版本置于暂存区：
  • 将编译版本上传到服务器时，将相应选项传入上传助手：--set-build-on-master或--set-build-on-test。
  • 将编译版本上传到服务器后，在启动器项目中进行以下操作：
    1. 在游戏中单击游戏右侧的设置。
    2. 前往编译版本 > 游戏编译版本。
    3. 向下滚动至游戏编译版本表格。
    4. 在游戏编译版本表格中，单击所需编译版本右侧的铅笔图标。
    5. 单击设置为主要将游戏编译版本置于主暂存区，或单击设置为暂存将其置于测试暂存区。如添加到主暂存区，则游戏编译版本将添加到启动器的已发布编译版本。如添加到测试暂存区，则游戏编译版本将添加到启动器的草稿编译版本。
    6. 确认您的选择。
    7. 单击关闭。
    8. 您将在游戏编译版本表格的分支列中看到编译版本相应的分支名。此外，您的编译版本也将在分支表格中显示。
注：
要测试游戏，请在控制台中传入-game_stage test参数来启动启动器。例如：launcher.exe -game_stage test。

设置游戏文件

要让启动器向用户发送正确的文件，请先在启动器项目中设置并初始化安装文件：
  1. 在游戏中，单击游戏右侧的设置。
  2. 前往可执行文件选项卡。
  3. 对每个操作系统输入启动游戏的文件的名称和扩展名。该文件应位于游戏文件夹的根目录，例如game.exe
  4. 如游戏有可再发行文件：
    1. 前往可再发行文件选项卡，然后单击上传。
    2. 在显示的窗口中：
      1. 输入文件名称。
      2. 单击上传文件，然后选择一个可执行文件。
      3. 单击上传。
启动器向游戏发送以下参数：
  • --xsolla-locale <locale>：界面语言；
  • --xsolla-login-token <token>：艾克索拉登录管理器JWT（JSON Web令牌）。
示例

教程

您的进度
感谢您的反馈！

继续阅读

下一步

生成安装程序
上次更新时间: 2023年10月10日

发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈！