Unity Addressables构建AB耗时，如何实现分布式/并行构建？

一、本地多线程构建优化（快速落地） #

• 启用内置并行构建：在AddressableAssetSettings面板的Build & Play Mode Scripts下，确认DefaultBuildScript已启用多线程构建（Unity 2021+版本默认开启，低版本可通过自定义构建脚本强制开启）。调用AddressableAssetSettings.BuildPlayerContent()时，传入BuildPlayerContentParameters并设置enableMultiThreadedBuilding = true。
• 按Group拆分并行构建：将资源按类型/模块拆分为独立Addressables Group，通过C# Task异步启动多个Group的构建任务，示例代码：

  public static async Task BuildGroupsInParallel(List<string> groupNames)
  {
      var settings = AddressableAssetSettingsDefaultObject.Settings;
      var tasks = new List<Task>();
      foreach (var name in groupNames)
      {
          var group = settings.groups.First(g => g.Name == name);
          tasks.Add(Task.Run(() => 
          {
              var buildParams = new BuildPlayerContentParameters();
              buildParams.groupsToBuild = new List<AddressableAssetGroup> { group };
              AddressableAssetSettings.BuildPlayerContent(buildParams);
          }));
      }
      await Task.WhenAll(tasks);
  }
  

  注意：共享依赖资源需放在单独的Shared Group，提前构建完成避免冲突。

二、局域网分布式构建（大幅提速） #

核心思路是拆分Group到多台机器并行构建，最后合并元数据文件，步骤如下：

1. 任务拆分与依赖预处理
   • 将Addressables Group按资源类型拆分（如场景、纹理、音频），确保各Group无跨Group硬依赖；共享依赖统一放入Shared Group，提前在一台机器上构建完成，同步到所有构建节点的本地缓存或共享目录。
   • 为每台机器分配专属Group任务，比如机器A负责场景Group，机器B负责纹理Group。
2. 节点构建配置
   • 所有节点使用完全一致的Unity版本、Addressables版本、项目代码和资源快照（通过Git或共享目录同步）。
   • 每台机器通过命令行触发指定Group的构建，示例命令：

     Unity.exe -batchmode -projectPath "D:/YourProject" -executeMethod BuildTools.BuildSpecificGroup "场景Group" -buildOutput "D:/BuildOutput/SceneGroup" -quit
     

     对应的构建方法：

     public static void BuildSpecificGroup(string groupName)
     {
         var settings = AddressableAssetSettingsDefaultObject.Settings;
         var group = settings.groups.First(g => g.Name == groupName);
         var buildParams = new BuildPlayerContentParameters();
         buildParams.groupsToBuild = new List<AddressableAssetGroup> { group };
         buildParams.outputPath = CommandLineParser.GetArgumentValue("-buildOutput");
         AddressableAssetSettings.BuildPlayerContent(buildParams);
     }
     

3. 元数据文件合并
   • catalog.json：解析各节点输出的catalog，提取m_Entries、m_Locations等核心字段，合并到主catalog中，确保资源GUID、地址唯一，去重重复条目。
   • link.xml：合并所有节点link.xml中的<assembly>和<type>节点，去重后生成最终文件。
   • catalog_*.hash：对合并后的catalog.json重新计算Hash128，覆盖原哈希文件。
   • addressables_content_state.bin：以Shared Group的构建状态为基础，合并其他Group的状态信息，或调用AddressableAssetSettings.SaveContentState()重新生成。

三、关键注意事项 #

• 依赖一致性：所有构建节点必须能访问到共享依赖的AB包，避免构建时重新打包依赖资源。
• 版本对齐：Unity、Addressables及相关插件版本必须完全一致，否则会出现元数据格式不兼容问题。
• 自动化脚本：用Python或C#编写全流程脚本，完成任务分配、构建触发、文件收集与合并，减少手动操作误差。

内容的提问来源于stack exchange，提问作者R_Perry