将补丁版本上传到服务器

如果您之前在沙盒或实时环境中使用 Crossplay Launcher 分发了 PC 版本的应用程序，则需要将补丁版本上传到 Hive 控制台沙盒或生产服务器以更新此应用程序。

上传补丁版本主要有两种方式：

1. 仅上传补丁文件
2. 上传补丁文件以及整个应用程序文件

仅上传补丁文件意味着用户仅使用补丁文件更新应用程序。当补丁文件大小不大时，可以使用此方法。然而，当初始版本和最新版本之间有许多中间版本时（例如，1.0.0.0、1.0.0.1、1.0.0.2、...、1.1.0.0），此方法可能会导致问题。由于Crossplay Launcher通过中间版本顺序更新版本（例如，1.0.0.0 → 1.0.0.1 → 1.0.0.2 → ... → 1.1.0.0），仅使用补丁文件持续更新应用程序可能会花费首次安装应用程序或重新安装应用程序的用户很长时间。

上传补丁文件以及整个应用程序文件意味着用户重新安装应用程序以进行更新。当整个应用程序的大小不是过于庞大并且有许多中间版本时，可以使用这种方法。在这种情况下，用户更新应用程序所需的时间可能比仅使用补丁文件更新应用程序的时间更短。

最后，选择其中一种方法取决于应用程序文件的总大小、中间版本的数量以及应用程序补丁文件的大小等考虑因素。应用程序开发人员应在检查应用程序安装和更新所需时间后进行选择。

创建补丁文件¶

对于这两种方法，您需要首先创建补丁文件。使用补丁生成器分析应用程序当前版本与新版本之间的差异并生成补丁文件。然后，通过上传工具将补丁文件上传到Hive 服务器。新版本应用程序的文件总大小必须小于30GB，并且新版本应用程序每个文件的大小必须小于4GB。

补丁制作器和上传器有两种类型：GUI和CUI。根据您的开发环境选择这两种方法中的一种。下面，我们将指导您如何在更新游戏应用版本的情况下使用GUI或CUI补丁制作器。

场景

• AppID: com.gcp2.stepbystep.windows.google.global.normal
• Hive 控制台服务器上传到: LIVE
• 之前的应用版本: 1.0.0.0
• 之前版本应用的位置: D:\myGame_v1_0_0_0
• 最新的应用版本: 1.0.0.1
• 最新版本应用的位置: D:\myGame_v1_0_0_1
• 生成补丁文件的位置: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1

选项 1：使用 GUI 创建补丁文件¶

GUI 补丁生成器通过 GUI 界面创建补丁文件。

1. 从这里下载Crossplay Launcher工具并解压，然后运行_GUI/patch_maker/CrossplayLauncherPatchFileMaker.exe_。
2. 在补丁制作器界面中，输入以下内容并按**开始**：
   • 先前版本路径：D:\myGame_v1_0_0_0
   • 当前版本路径：D:\myGame_v1_0_0_1
   • 补丁文件路径：D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1
   • 环境：使用SANDBOX作为沙盒环境，LIVE(REAL)作为实时环境
   • 应用程序ID：com.gcp2.stepbystep.windows.google.global.normal
   • 先前版本：1.0.0.0

选项 2：使用 CUI 生成补丁文件¶

1. 下载 Crossplay Launcher 工具并从 这里 解压缩。
2. 在 CUI/patch_maker/cpflPtc.exe 所在的同一目录中创建 Pre_Version_Folder 和 Cur_Version_Folder 文件夹，并分别将 D:\myGame_v1_0_0_0 和 D:\myGame_v1_0_0_1 中的文件复制到这些文件夹中。

3. 在 Windows 终端或 PowerShell 中运行 CUI/patch_maker/cpflPtc.exe，并使用以下命令行参数：

   • ‐‐prePath: D:\myGame_v1_0_0_0，默认是 Pre_Version_Foler
   • ‐‐nextPath: D:\myGame_v1_0_0_1，默认是 Cur_Version_Foler
   • ‐‐patchPath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1，默认是 Patch_Files_Folder
   • -envi: 沙盒环境是 SANDBOX，实时环境是 LIVE（必须与版本 1.0.0.0 应用文件上传时的环境相同）
   • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
   • ‐‐version: 输入之前的版本，1.0.0.0
   • -runbatch: y（是否在补丁过程中跳过问题提示）

   
   cpflPtc.exe \
   ‐‐prePath="D:\myGame_v1_0_0_0" \
   ‐‐nextPath="D:\myGame_v1_0_0_1" \
   ‐‐patchPath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
   -envi="LIVE" \
   -appid="com.gcp2.stepbystep.windows.google.global.normal" \
   -version="1.0.0.0" \
   -runbatch="y"
               

验证生成的补丁文件¶

检查在GUI或CUI补丁制作器中生成的补丁文件，位于Patch_Files_Folder。如果文件数据不同，即使文件路径在旧版本和新版本之间相同，也会生成补丁文件。如果在新版本中添加了在旧版本中不存在的文件，则将在Patch_Files_Folder中的相应文件路径下创建一个文件。

选项 1：仅上传补丁文件¶

将生成的补丁文件上传到 Hive 控制台沙盒服务器或 Hive 控制台实时服务器。有两种类型的上传工具可用：GUI 和 CUI。根据您的开发环境，选择其中一种方法上传补丁文件。

选项 1：使用 GUI 上传补丁文件¶

GUI 上传工具通过图形界面进行上传。

1. 从Hive 沙盒控制台或 Hive 直播控制台导航到_Crossplay Launcher > 应用管理 > 上传 IP_，并选择游戏和 AppID。将将要上传应用文件的 PC 的 IP 地址注册为代表 IP（Rep IP）。
2. 下载 Crossplay Launcher 工具并从这里解压。
3. 执行_GUI/uploader/CrossplayLauncherFileUploader.exe_。
4. 在上传器界面，输入以下内容并点击**开始**：
   • 上传文件夹路径：D:\myGame_v1_0_0_1
   • 补丁文件夹路径：D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1（补丁制作工具生成的补丁文件所在路径）
   • 不是第一次上传：已勾选
   • 环境：沙盒环境为SANDBOX，直播环境为LIVE(REAL)（必须与版本1.0.0.0应用文件上传的环境匹配）
   • 平台：Windows
   • 是否发布：N
   • APP ID：com.gcp2.stepbystep.windows.google.global.normal
   • 应用版本：1.0.0.1
5. 如果上传成功，处理窗口将显示状态代码201。

选项 2：使用 CUI 上传补丁文件¶

1. 从 沙盒控制台或 直播控制台，导航到Crossplay Launcher > 应用管理 > 上传 IP，选择游戏和AppID。将将要上传应用文件的PC的IP地址注册为代表IP（Rep IP）。
2. 下载 Crossplay Launcher 工具并从这里解压。

3. 在Windows 终端或 PowerShell 中执行CUI/uploader/cpflupl.exe，并使用以下命令行参数：

   • -envi: 沙盒环境为 SANDBOX，直播环境为 LIVE（必须与版本 1.0.0.0 应用文件上传的环境匹配）
   • ‐‐platform: w
   • ‐‐release: n
   • -notfirstupload: 适用（仅在上传补丁文件时适用，不适用于上传新应用）
   • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
   • ‐‐version: 1.0.0.1
   • ‐‐filepath: D:\myGame_v1_0_0_1
   • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1，默认值为 toUploadPatchFiles
   • -runbatch: 适用

   
   cpflupl.exe \
   ‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
   ‐‐platform="w" \
   --version="1.0.0.1" \
   -envi="LIVE" \
   ‐‐filepath="D:\myGame_v1_0_0_1" \
   ‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
   -runbatch ‐‐notfirstupload ‐‐release="n"
               

4. 如果上传成功，您将在终端或 shell 中看到状态代码 201。

选项 2：同时上传补丁文件和整个应用程序文件¶

将创建的补丁文件和完整的应用程序文件上传到 Hive 控制台沙盒服务器或 Hive 控制台实时服务器。有两种类型的上传工具：GUI 和 CUI。根据您的开发环境选择其中一种方法来上传补丁文件和整个应用程序文件。

选项 1：使用 GUI 上传补丁文件和完整应用程序文件¶

GUI 上传器通过 GUI 界面上传。

1. 在 Crossplay Launcher > App Management > Upload IP 下选择游戏和 AppID，在 Sandbox console or Live console 中，并将将上传应用文件的 PC 的 IP 地址注册为代表 IP (Rep IP)。
2. 从 这里 下载并解压 Crossplay Launcher 工具。
3. 运行 GUI/uploader/CrossplayLauncherFileUploader.exe。
4. 在上传器界面，输入以下详细信息并点击 开始：
   • 上传文件夹路径: D:\myGame_v1_0_0_1
   • 补丁文件夹路径: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1 (补丁制作工具生成的补丁文件所在目录)
   • 不是第一次上传: 已勾选
   • 环境: SANDBOX 表示沙盒环境，LIVE(REAL) 表示实时环境（应与版本 1.0.0.0 应用文件上传的环境匹配）
   • 平台: Windows
   • 是否发布: Y
   • APP ID: com.gcp2.stepbystep.windows.google.global.normal
   • 应用版本: 1.0.0.1
5. 如果上传成功，处理窗口将显示状态代码 201。

选项 2：使用 CUI 上传补丁文件和完整应用程序文件¶

1. 在 Crossplay Launcher > 应用管理 > 上传 IP 下选择游戏和 AppID，并在 沙盒控制台或 直播控制台 中注册将要上传应用程序文件的 PC 的代表 IP 地址 (Rep IP)。
2. 从 这里 下载并解压 Crossplay Launcher 工具。

3. 在 Windows 终端或 PowerShell 中使用以下命令行参数执行 CUI/uploader/cpflupl.exe：

   • -envi: 沙盒环境为 SANDBOX，直播环境为 LIVE（必须与版本 1.0.0.0 应用程序文件上传的环境匹配）
   • ‐‐platform: w
   • ‐‐release: y
   • -notfirstupload: 适用（仅在上传补丁文件时适用，不适用于上传新应用程序）
   • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
   • ‐‐version: 1.0.0.1
   • ‐‐filepath: D:\myGame_v1_0_0_1
   • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1，默认值为 toUploadPatchFiles
   • -runbatch: 适用

   
   cpflupl.exe \
   ‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
   ‐‐platform="w" \
   --version="1.0.0.1" \
   -envi="LIVE" \
   ‐‐filepath="D:\myGame_v1_0_0_1" \
   ‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
   -runbatch ‐‐notfirstupload ‐‐release="n"
               

4. 如果上传成功，您将在终端或 shell 中看到状态代码 201。

检查上传结果¶

上传完成后，前往 Hive 控制台 > 跨平台启动器 > 应用管理 > 下载设置 验证应用是否已成功上传。

• 沙盒
• 在线