上传游戏编译版本
要将游戏编译版本上传到更新服务器，请使用上传助手命令行工具。
上传助手系统要求：
- Windows 10 64位操作系统或macOS 12.4.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>— 文件块大小，即游戏压缩包分成的文件块大小。支持的值为10mb到500mb。默认为500mb。–retry-timeout <timeout>— 上传文件尝试之间的超时值，单位为秒。支持的值为10到60，默认为20。–retry-count <retry-count>— 上传文件的尝试次数。支持的值为1到10，默认为3。–set-build-on-test— 将游戏编译版本置于草稿暂存区。游戏将仅对测试可用。–set-build-on-master— 将游戏编译版本置于已发布暂存区。游戏将对最终用户可用。如果指定了–set-build-on-test，将忽略此选项。-no-progressbar— 禁用进度条。
要上传游戏编译版本：
- 前往发布商帐户 > 编译版本设置。
- 复制API密钥。
- 下载并安装上传助手。
- 初始化该工具。
- 上传游戏编译版本到服务器。
- 将游戏编译版本置于暂存。
- 设置游戏文件。
下载及安装上传助手
要下载及安装上传助手：
- 在游戏部分，单击游戏右侧的设置。
- 前往编译版本 > 游戏编译版本。
- 单击符合您操作系统的BuildLoader.zip下载上传助手的压缩包。
- 提取压缩包内容。
工具相对于解压缩包文件夹的位置：
- 对于Windows：
Win\build_loader.exe - 对于macOS：
Mac/build_loader
初始化上传助手
要初始化上传助手：
- 在游戏部分，单击游戏右侧的设置。
- 前往编译版本 > 游戏编译版本部分。
- 单击API密钥（启动器ID）中的+图标复制API密钥。上传助手需使用该密钥将您的游戏上传到服务器。
- 运行以下命令初始化该工具：
Copy
build_loader.exe --init --api-key <api-key> --game-path <path-to-game>
示例
Copy
build_loader.exe --init --api-key E51DPZ486S9IUGVF43AH4T48QB7246OQ --game-path C:\Games\LastGameBuild
其中：
api-key— 之前复制的API密钥。path-to-game— 机器上游戏编译版本的路径。路径须只包含英文字母。
注：
- 如无需更改API密钥或游戏编译版本的路径，则该工具只需初始化一次。
- 游戏编译版本路径只能包含英文字母。
将游戏编译版本上传到服务器
要将游戏编译版本上传到服务器，请运行以下命令：
Copy
build_loader --update --game-path <path-to-game> --descr <build-description>
示例
Copy
build_loader.exe --update --game-path C:\Games\LastGameBuild
如初始化工具或上传上一个编译版本时已指定过该参数，则可省略–game-path参数。
首次上传时，更新服务器将接收整个游戏编译版本。之后，其将接收上传助手生成的补丁。
注：
强烈建议您指定
–descr参数，以便区分上传的不同编译版本。- 在发布商帐户中打开您的项目。
- 在侧边栏中单击启动器。
- 在游戏部分，单击游戏右侧的设置。
- 前往编译版本 > 游戏编译版本。
- 向下滚动至游戏编译版本表格。
注：
如游戏编译版本包含会在游戏过程中改变的文件（如设置、用户资料或保存文件），请将它们添加到忽略文件列表。否则启动器在更新游戏时会检测到文件完整性冲突进而重新下载整个游戏
将游戏编译版本置于相应阶段
您可以进行如下操作将游戏编译版本置于暂存区：
- 将编译版本上传到服务器时，将相应选项传入上传助手：
--set-build-on-master或--set-build-on-test。 - 将编译版本上传到服务器后，在启动器项目中进行以下操作：
- 在游戏中单击游戏右侧的设置。
- 前往编译版本 > 游戏编译版本。
- 向下滚动至游戏编译版本表格。
- 在游戏编译版本表格中，单击所需编译版本右侧的铅笔图标。
- 单击设置为已发布将游戏编译版本置于已发布暂存区，或单击设置为草稿将其置于草稿暂存区。
- 确认您的选择。
- 单击关闭。
- 您将在游戏编译版本表格的分支列中看到编译版本相应的分支名。此外，您的编译版本也将在分支表格中显示。
设置游戏文件
要让启动器向用户发送正确的文件，请先在启动器项目中设置并初始化安装文件：
- 在游戏中，单击游戏右侧的设置。
- 前往可执行文件选项卡。
- 对每个操作系统输入启动游戏的文件的名称和扩展名。该文件应位于游戏文件夹的根目录，例如
game.exe - 如游戏有可再发行文件：
- 前往可再发行文件选项卡，然后单击上传。
- 在显示的窗口中：
- 输入文件名称。
- 单击上传文件，然后选择一个可执行文件。
- 单击上传。
启动器向游戏发送以下参数：
–xsolla-locale <locale>：界面语言；–xsolla-login-token <token>：艾克索拉登录管理器JWT（JSON Web令牌）。
Copy
game.exe --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en
教程
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。继续阅读
下一步
生成安装程序发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
