居家办公

您可以通过 RDP 直接与办公室的 Incredibuild Agent 连接。如果连接的 Agent 为 Initiator，您就可以使用办公室网络而不必依赖家里的网络。需要确保您没有连接至不属于办公室网络环境的 Helper Agent，例如其他居家办公的同事使用的设备。

虚拟桌面基础架构 (VDI) 的定义为在中央服务器上托管桌面环境。它是桌面虚拟化的一种形式，特定的桌面图像在虚拟机 (VM) 内运行，并通过网络传递给最终用户客户端。

虽然在家就能访问 VDI，但资源部署在您的办公室或云中，所以很大程度上也降低了对家中网络的依赖。

您可以借助 Incredibuild 的云解决方案， 使用云技术按需部署 Helper Agent。该解决方案只有在您家里的网络连接稳定可靠的情况下才会起作用。建议在满足下列条件的前提下采用该方案：

• 家中网络连接稳定可靠，但 Helper Agent 计算机连接不稳定 （其他居家办公的同事）。

• 您的网络连接稳定可靠，但您需要使用网络质量不太理想的 VPN 与 Helper Agent 进行连接。

若存在上述情况，您可以将自己的计算机用作 Initiator，并根据您的需求在云端充分利用 Agent。

如果上述解决方案均无法实现，并且您的居家环境中存在多台计算机，那么您可以创建一个迷你居家网络。这样您就能将计算机的空闲内核利用起来，加快构建进程。

1. 在您的所有计算机设备上安装 Incredibuild

2. 在其中一台计算机上安装 Coordinator

注意： 以下为使用 Unreal Engine 4.24，以及 100 Mbps 下行、5 Mbps 上行不对称带宽连接进行测试和验证后提供的建议。

在家庭网络环境下使用 Unreal Enginewith，由于上行带宽存在限制，所以会严重影响性能。导致性能受影响的两个主要因素：

• Unreal Engine 在每次构建中都会创建大量的 PCH 文件。

• 目标工具集（如 Visual Studio 编译器工具集）的链接远程方式运行，将许多 OBJ 和 PDB 文件同步到远端机器上。

在十分有限的上传带宽条件下尝试将大量 PCH、OBJ 和 PDB 文件同步到远端机器上，这会大幅降低任务的执行速度，甚至可能导致任务突然终止和断开连接。因此，为克服性能受损问题并实现加速，这两个问题必须得以解决。

禁用 PCH 文件使用

为提升居家场景中使用 Unreal Engine 进行构建的性能，建议禁用 PCH 文件。您可以通过 Unreal Engine 的 BuildConfiguration.xml 文件禁用 PCH 文件。BuildConfiguration.xml 文件路径： install_dir\Unreal Engine\UnrealBuildTool\BuildConfiguration.xml

> 禁用 PCH 文件使用操作步骤：

将下列 XML 元素添加到 Unreal Engine 的 BuildConfiguration.xml 文件中：

<BuildConfiguration>
     <bUsePCHFiles>false</bUsePCHFiles>
</BuildConfiguration>

例如，在以下 BuildConfiguration.xml 文件中禁用 PCH 文件：

<?xml version="1.0" encoding="utf-8" ?>
<Configuration >
    <BuildConfiguration>
        <bUsePCHFiles>false</bUsePCHFiles>
    </BuildConfiguration>
</Configuration>

强制链接本地运行

为提高居家环境下使用 Unreal Engine 进行构建的性能，我们还建议强制改变链接的运行，不以远程模式运行可避免在带宽连接十分有限的情况下将大量 OBJ 和 PDB 文件同步到远程计算机上。

可通过将 LinkAction.bCanExecuteRemotely 链接器参数设置为 False 进行更改。设置为 False 后，与 Incredibuild 集成的 Unreal Build System 将收到指示，并在本地计算机上执行所有链接任务。该标志单独应用于每个工具集，驻留在所选工具集的 .cs 文件中。

默认情况下，所有工具集的 LinkAction.bCanExecuteRemotely 参数均已设置为 False。这样，所有链接都会在您的本地计算机上运行，您也无需更改相应配置。但是，有两个工具集需要您更改配置：

• VCToolChain

  配置文件路径：

  Install_dir:\UE4\Engine\Source\Programs\UnrealBuildTool\Platform\Windows\VCToolChain.cs

• HoloLensToolChain

  配置文件路径：

  Install_dir:\UE4\Engine\Source\Programs\UnrealBuildTool\Platform\HoloLens\HoloLensToolChain.cs

> 强制链接本地运行的操作步骤：

1. 打开您当前使用的工具集适用的 .cs 文件。

2. 找到 LinkAction.bCanExecuteRemotely 参数，将参数值更改为 False。

例如，在以下 VCToolChain.cs 文件中将 VCToolChain 的链接设置为不允许远程运行：

为了确保您家里计算机的互联网带宽限制不会影响从其他机器上启动的构建进程速度，请禁用您的 Initiator Agent 用作 Helper 的功能。

您可以右键任务栏的 Incredibuild Agent 图标，然后点击 Disable as Helper 进行禁用。

如果条件允许，我们建议通过物理有线连接确保网络连接速度和可靠性。

即使家庭网络的速度很快，通过 VPN 进行连接仍有可能导致新的性能限制问题。如果您必须使用 VPN 连接网络，请确保您的带宽能够满足使用需求。

建议尽量避免从您家庭环境中的计算机上分配需要大量输入文件的任务。比如尽量避免使用 PCH 和 PDB 文件。

禁用该功能后，缓存会保存在 Helper 计算机上供将来进行重新构建，并提高性能。进入 Coordinator Settings 对话框 > Coordinator > Advanced 并取消勾选 Enable automatic file cache cleaning。

该功能有助于避免业务“等待”处理速度缓慢的远程计算机完成当前执行任务的情况。如果某台计算机反应速度较慢，Incredibuild 则会同时在远程计算机以及您的本地计算机上执行任务，然后优先使用最先输出的结果。

鉴于居家办公时远程计算机运行速度慢的可能性较大，因此我们建议您启用该功能。

前往 Agent Settings > Initiator > General，勾选 Restart remote processes on local machine when possible。

如果有可能使用数量更少的计算机获得相同数量的内核，就能够减少总共需要的网络流量，从而提高性能。

居家办公时，在某些情况下针对每次构建减少使用的 Helper 计算机内核可以提高性能。

您可以在一台个人 Initiator Agent 上更改相应配置，或是通过 Coordinator 将配置应用到所有 Agent 上：

• 在 Initiator Agent 中，进入 Agent Settings > Initiator > General。勾选 Limit maximum number of cores utilized in build to 并减少数量。

• 在 Coordinator 中，进入 Coordinator Settings > Agent Assignment > Advanced 并减少数量。

• 用作 Helper 的虚拟计算机应使用数量更多的 CPU 内核，例如 32 或 64 核。只作为 Initiator 的计算机则不需要。

• 使用 Incredibuild 的 Cloud 解决方案时，需测试您的内存池大小，确保能够容纳所有您计划用于任务提速的 Helper 虚拟机，从而避免缓存数据丢失问题。在 Incredibuild Cloud 解决方案的 Settings 页面，测试 Total Cores Limit 是否等于 Number of Cores 乘以 Pool 中的 Number of VMs。如果 Total Cores Limit 数值更大，则虚拟机会在运行后终止运行，导致缓存数据丢失，降低居家办公效率。在该示例中：160 Total Cores = 32 Cores * 5 VMs in Pool