上传补丁版本到服务器
如果您之前在 Sandbox 或 Live 環境中使用 Crossplay Launcher 分發了 PC 版本的應用程序，您需要將補丁版本上傳到 Hive 控制台的 Sandbox 或生產伺服器以更新此應用程序。
有兩種主要方式來上傳補丁版本：
- 僅上傳補丁檔案
- 連同整個應用程式檔案一起上傳補丁檔案
僅上傳補丁檔案意味著用戶僅使用補丁檔案來更新應用程式。當補丁檔案的大小不大時，可以使用此方法。然而，當初始版本和最新版本之間有許多中間版本時（例如，1.0.0.0、1.0.0.1、1.0.0.2、...、1.1.0.0），此方法可能會造成問題。由於Crossplay啟動器通過中間版本依次更新版本（例如，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
Note
使用防病毒程序时，其实时保护（或监控）功能可能会在创建补丁文件时导致错误，因为它会检测程序安装和文件更改。如果在创建补丁文件时错误持续存在，请考虑将补丁制作程序注册为防病毒软件中的受信任程序，或在关闭防病毒程序后再试一次。
選項 1：使用 GUI 創建補丁文件¶
GUI 補丁製作器通過 GUI 界面創建補丁文件。
- 從這裡下載Crossplay Launcher工具並解壓縮，然後運行_GUI/patch_maker/CrossplayLauncherPatchFileMaker.exe_。
- 在補丁製作器界面中，輸入以下內容並按**開始**：
- 先前版本路徑：
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 生成补丁文件¶
- 下载 Crossplay Launcher 工具并从 这里 解压缩。
- 在 CUI/patch_maker/cpflPtc.exe 所在的同一目录中创建 Pre_Version_Folder 和 Cur_Version_Folder 文件夹，并分别将文件从 D:\myGame_v1_0_0_0 和 D:\myGame_v1_0_0_1 复制到这些文件夹中。
在 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"- ‐‐prePath:
驗證生成的補丁文件¶
檢查由 GUI 或 CUI 補丁製作工具生成的補丁文件，位於 Patch_Files_Folder 中。如果文件數據不同，但舊版和新版之間的文件路徑相同，則會生成補丁文件。如果在新版本中添加了舊版本中不存在的文件，則會在 Patch_Files_Folder 中的相應文件路徑創建一個文件。
選項 1：僅上傳補丁檔案¶
將生成的補丁檔案上傳到 Hive 控制台沙盒伺服器或 Hive 控制台實時伺服器。有兩種類型的上傳工具可用：GUI 和 CUI。根據您的開發環境，選擇這些方法之一來上傳補丁檔案。
選項 1：使用 GUI 上傳補丁檔案¶
GUI 上傳器通過圖形界面上傳。
- 從Hive Sandbox 控制台或 Hive Live 控制台中，導航至_Crossplay Launcher > 應用管理 > 上傳 IP_，並選擇遊戲和 AppID。將將上傳應用檔案的 PC 的 IP 地址註冊為代表 IP（Rep IP）。
- 下載 Crossplay Launcher 工具並從這裡解壓縮。
- 執行_GUI/uploader/CrossplayLauncherFileUploader.exe_。
- 在上傳器螢幕上，輸入以下內容並點擊**開始**：
- 上傳資料夾路徑：
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
- 上傳資料夾路徑：
- 如果上傳成功，處理窗口將顯示狀態碼
201。
選項 2：使用 CUI 上傳補丁檔案¶
- 從 沙盒控制台或 實時控制台，導航到Crossplay Launcher > 應用管理 > 上傳 IP並選擇遊戲和AppID。將應用檔案將上傳的PC的IP地址註冊為代表IP（Rep IP）。
- 從這裡下載 Crossplay Launcher 工具並解壓縮。
在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"- -envi：沙盒環境為
- 如果上傳成功，您將在終端或 shell 中看到狀態碼
201。
Note
當上傳補丁檔案時，如果您即將上傳的版本與先前分發的版本相符（在GUI中稱為App Version，在CUI中稱為‐‐version），則不會執行上傳過程。
選項 2：同時上傳補丁檔案和整個應用程式檔案¶
將創建的補丁檔案和完整的應用程式檔案上傳到 Hive 控制台沙盒伺服器或 Hive 控制台實時伺服器。有兩種上傳方式：GUI 和 CUI。根據您的開發環境選擇這些方法之一來上傳補丁檔案和整個應用程式檔案。
選項 1：使用 GUI 上傳補丁檔案和完整應用程式檔案¶
GUI 上傳器通過 GUI 螢幕上傳。
- 在 Crossplay Launcher > App Management > Upload IP 下选择游戏和 AppID，在 Sandbox console or Live console 中，并将将要上传应用文件的 PC 的 IP 地址注册为代表 IP (Rep IP)。
- 从 这里 下载并提取 Crossplay Launcher 工具。
- 运行 GUI/uploader/CrossplayLauncherFileUploader.exe。
- 在上传器界面，输入以下详细信息并点击 开始：
- 上传文件夹路径:
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
- 上传文件夹路径:
- 如果上传成功，处理窗口将显示状态代码
201。
選項 2：使用 CUI 上傳補丁文件和完整應用程序文件¶
- 在 Crossplay Launcher > App Management > Upload IP 下，選擇遊戲和 AppID，然後在 沙盒控制台或 實時控制台 中，註冊將上傳應用程序文件的 PC 的代表 IP 地址 (Rep IP)。
- 從 這裡 下載並提取 Crossplay Launcher 工具。
在 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"- -envi: 沙盒環境為
- 如果上傳成功，您將在終端或 shell 中看到狀態碼
201。
Note
當上傳補丁檔案時，如果您即將上傳的版本與先前發佈的版本相符（在GUI中稱為App Version，在CUI中稱為‐‐version），則不會執行上傳過程。
檢查上傳結果¶
上傳完成後，前往 Hive 控制台 > 跨平台啟動器 > 應用管理 > 下載設定 驗證應用是否已成功上傳。