升级Forge应用以同时支持Revit 2022与Revit 2023版本

我们有一款Autodesk Forge应用，可接收Revit文件作为输入并转换为自定义格式，当前应用运行稳定，最高支持Revit 2022版本文件。

随着Revit 2023版本发布，其API引入诸多变更并移除了部分方法，我们面临版本兼容难题——希望同时支持Revit 2023及更早版本的文件格式。

当前后端基于Revit API开发，想咨询：是否必须维护两套后端代码，分别调用Revit API 2022和2023的独立DLL，还是有更优的解决方案？

应用架构示意图：

双DLL调用示意图：

不需要维护两套独立代码，以下是几种更优的实现思路：

1. 基于反射的版本适配 #

利用.NET反射机制，根据加载的Revit API版本动态调用对应的方法：

• 核心逻辑：先检测当前加载的Revit API版本，对存在版本差异的方法，通过反射获取对应版本的方法并执行
• 示例代码片段：

Assembly revitAssembly = typeof(Autodesk.Revit.DB.Document).Assembly;
Version revitVersion = revitAssembly.GetName().Version;

if (revitVersion.Major >= 23)
{
    // 通过反射调用Revit 2023新增/变更的方法
    MethodInfo newMethod = typeof(SomeRevitClass).GetMethod("NewMethodName");
    newMethod.Invoke(instance, parameters);
}
else
{
    // 调用旧版本方法
    instance.OldMethodName(parameters);
}

• 优势：单套代码兼容多版本，无需拆分项目；缺点：反射会带来轻微性能损耗，代码可读性略有下降

2. 抽象层+多实现策略 #

定义统一的抽象接口封装Revit API操作，针对不同版本实现具体的适配类：

• 步骤：
  • 定义IRevitAdapter接口，包含所有需要的操作方法
  • 分别实现Revit2022Adapter和Revit2023Adapter，对应不同版本的API调用逻辑
  • 运行时根据文件版本或加载的API版本，动态实例化对应的适配器类
• 示例结构：

public interface IRevitAdapter
{
    void ExportToCustomFormat(Document doc, string outputPath);
}

public class Revit2022Adapter : IRevitAdapter
{
    public void ExportToCustomFormat(Document doc, string outputPath)
    {
        // 使用Revit 2022 API实现逻辑
    }
}

public class Revit2023Adapter : IRevitAdapter
{
    public void ExportToCustomFormat(Document doc, string outputPath)
    {
        // 使用Revit 2023 API实现逻辑（适配变更后的方法）
    }
}

• 优势：代码结构清晰，各版本逻辑隔离，易于维护；缺点：需要额外编写适配层代码

3. 使用条件编译符号 #

在项目中通过条件编译区分不同版本的代码：

• 步骤：
  • 为项目添加编译符号，如REVIT2022和REVIT2023
  • 在代码中通过#if指令区分不同版本的实现
• 示例代码：

#if REVIT2023
    // Revit 2023专属代码逻辑
    doc.UseNewApiMethod();
#else
    // 旧版本代码逻辑
    doc.UseOldApiMethod();
#endif

• 优势：编译时就确定版本逻辑，性能无损耗；缺点：需要针对不同版本编译不同的程序集，部署时需区分版本分发

额外注意事项 #

• 确保项目引用的Revit API DLL采用最低兼容版本引用，或通过NuGet管理不同版本的依赖（Autodesk官方提供了Revit API的NuGet包）
• 对于Revit 2023中移除的方法，可自行封装兼容层，在旧版本中调用原方法，在新版本中调用替代方案
• 测试时需分别在Revit 2022和2023环境中验证所有核心功能，避免版本差异导致的隐性问题

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