Live Coding 实时编译

原理与用法

• Live Coding 是对 Live++ 的集成，能在引擎运行时重新编译应用的 C++ 代码并给二进制打补丁。Hot Reload 仍可作为备选，但 Live Coding「显著更快、更灵活」。（Using Live Coding to recompile Unreal Engine Applications at Runtime）
• 新安装默认启用。打开 IDE 时，Live Coding Console 会自动启动但保持隐藏，开始构建时会弹出；它有独立的输出日志，只显示 Live Coding 的构建信息。在 IDE 或引擎中按 Ctrl+Alt+F11 开始构建。可用于打开的编辑器、PIE，以及在本机桌面环境中附加到打包后的程序。（Using Live Coding to recompile Unreal Engine Applications at Runtime）
• 设置在 Editor Preferences > General > Live Coding；关闭 Enable Live Coding 后，编辑器会回退到 Hot Reload。（Using Live Coding to recompile Unreal Engine Applications at Runtime）

对象重实例化

flowchart LR
  E["修改 C++"] --> C["Ctrl+Alt+F11 编译补丁"]
  C --> Q{"Object Reinstancing 开启？"}
  Q -->|"是"| R["替换已有的 UCLASS/USTRUCT/UENUM… 实例<br/>可以承受结构性修改"]
  Q -->|"否"| S["只适合小改动：改值、改函数体<br/>结构性修改通常会崩溃"]

图中编译出补丁后，是否开启对象重实例化决定了能安全承受多大的代码改动。

• 对象重实例化会在整个程序和编辑器中替换现有的对象实例，使它们立即采用 Live Coding 编译进来的大规模结构改动。被重实例化的包括所有使用 UCLASS、UFUNCTION、USTRUCT、UENUM、UDELEGATE 宏的对象，以及 UHT 根据这些宏生成的对象（例如蓝图节点）。默认开启。（Using Live Coding to recompile Unreal Engine Applications at Runtime，宏与 UHT 见 UObject 与反射系统）
• 关闭时，Live Coding 仍能处理小改动（变量值、对已有函数的小修改），但新增函数、新增成员变量、大幅重构等「行为不可预测，通常会导致崩溃」。开启时则需要额外的步骤来清理指针。（Using Live Coding to recompile Unreal Engine Applications at Runtime）

坑

• 构造函数中的默认值：改了 .cpp 构造函数里设置的默认值后，已经存在的对象实例不会更新。（Using Live Coding to recompile Unreal Engine Applications at Runtime）
• 可以设置新增 C++ 类时自动用 Live Coding 编译；Preload Named Modules 可以指定要预加载的模块（模块见 模块、插件与构建系统）。（Using Live Coding to recompile Unreal Engine Applications at Runtime）
• 大的结构性修改之后，稳妥的做法仍是关闭编辑器、完整编译（这是工程经验，官方页说的是「不开启重实例化时会崩溃」）。