HotPatcher 插件教程

HotPatcher 插件教程

项目地址:https://gitcode.com/gh_mirrors/ho/HotPatcher

1. 项目介绍

HotPatcher 是一款专为虚幻引擎（Unreal Engine）设计的资源管理和热更新工具。它提供了一套全面的解决方案，覆盖热更新、构建优化、包体减小、资源审计等多个方面。HotPatcher 支持跨引擎版本（从 UE4.21 到 UE5 最新版本），并且具有以下主要特性：

• 热更新管理：管理不同版本的热更资源，跟踪资源变动。
• 版本差异对比：对比不同版本的资源差异，便于打包。
• 资源审计：分析和管理工程中的资源，提升资源管理效率。
• 自动化打包：支持多平台打包，以及多种热更新策略。

2. 项目快速启动

安装 HotPatcher

1. 克隆仓库：

   git clone https://github.com/hxhb/HotPatcher.git
   

2. 将 HotPatcher 添加到你的虚幻项目： 将 HotPatcher/Source 文件夹复制到你的 UE 工程的 Plugins 目录下。

3. 启用插件： 在你的项目设置中，打开 Plugins，找到 HotPatcher 并启用它。

4. 配置项目： 在 Build.cs 文件中添加以下依赖：

   PublicDependencyModuleNames.AddRange(new string[] { "HotPatcherRuntime", "HotPatcherCore", "HotPatcherEditor" });
   

5. 重建项目： 保存更改并重新构建你的项目。

使用 HotPatcher

1. 创建 Release 配置： 打开 HotPatcher，在 ByRelease 中导出 _Release.json 文件，记录当前资源状态。

2. 打包基础包： 使用 UE 正常打包你的项目，例如 Windows 平台。

3. 制作 Patch： 在 HotPatcher 的 ByPatch 中，选择之前创建的 _Release.json 文件作为基准，然后配置想要打包的平台，勾选 bCookPatcherAssets 选项，执行 Cook。

4. 应用 Patch： 在目标机器上安装基础包，然后用 Patch 文件更新资源。

3. 应用案例和最佳实践

• 元梦之星、QQ Apex Legends Mobile、WitiSports MOSSAI 和 二之国：交错世界 等游戏项目已成功应用 HotPatcher 进行热更新和资源管理。
• 结合 Git 版本控制系统，通过版本回溯实现可靠的资源版本管理。
• 使用 HotPatcher 的模块化特性，为特定业务场景定制打包和资源管理系统。
• 利用 Commandlet 集成 CI/CD 流程，自动化构建和部署过程。

4. 典型生态项目

虽然没有明确列出其他生态项目，但是 HotPatcher 是一个开放源代码的项目，社区开发者可以根据其框架扩展开发自己的工具和解决方案。

---

本教程简要介绍了 HotPatcher 插件的安装、基本使用方法以及一些最佳实践。更多详细信息和高级功能，请参考项目官方文档或参与相关社群讨论。

HotPatcher Unreal Engine hot update manage and package plugin. 项目地址: https://gitcode.com/gh_mirrors/ho/HotPatcher