Tekla Structures插件WPF UI本地化：Common库多语言方案问题排查

一、两种方案的问题根源 #

1. 共享*.ail文件失效的原因 #

• Tekla Structures的*.ail本地化机制是插件程序集绑定的加载逻辑：每个插件只会自动加载与自身主程序集同名的*.ail文件，不会主动扫描并加载依赖类库的*.ail文件。Common.WPF作为类库，它的*.ail不在插件的本地化查找范围内，自然无法被读取。
• .ail文件的放置路径和命名有严格要求：必须与插件主程序集同名，且放在Tekla指定的本地化目录或插件的部署目录下，类库的.ail如果未被关联到插件的加载上下文，会被忽略。

2. Resx资源在Tekla插件中失效的原因 #

• Tekla的插件运行环境是独立应用域，宿主进程会强制使用自身的文化设置，覆盖插件代码中对Thread.CurrentThread.CurrentUICulture的修改，导致类库无法感知到文化切换。
• 资源程序集部署不规范：类库的本地化资源dll（如Common.WPF.resources.dll）未放在插件目录的对应文化子目录下，导致WPF无法找到并加载本地化资源。
• WPF资源绑定方式问题：如果使用StaticResource绑定，资源会在程序启动时一次性加载默认文化内容，后续文化切换无法自动更新。

二、优雅的本地化实现方案 #

方案1：基于Tekla官方*.ail机制的共享优化 #

• 创建共享基础*.ail文件（如Common.ail），将通用资源的翻译内容集中存放，放在Tekla的公共本地化目录（如%TEKLA_STRUCTURES_DIR%\Localization\zh-CN）或插件的公共部署目录。
• 在每个插件的自有*.ail文件中，通过引用语法导入共享内容，避免重复翻译。例如在MyPlugin.ail中添加：

  #include "Common.ail"
  

  注意：如果共享文件放在插件目录下，需填写正确的相对路径；确保共享文件的键名唯一，避免与插件自有键冲突。

方案2：适配Tekla环境的Resx本地化方案 #

1. 修正资源加载逻辑

• 在Common.WPF类库中创建强类型资源管理器，显式接收文化参数获取资源，不依赖线程文化设置：

  public static class LocalizationHelper
  {
      public static string GetString(string key, CultureInfo targetCulture)
      {
          return CommonResources.ResourceManager.GetString(key, targetCulture) ?? key;
      }
  }
  

• 在Tekla插件中，通过Tekla API获取当前系统的语言设置（而非手动设置线程文化），传递给上述方法：

  var teklaCulture = new CultureInfo(Tekla.Structures.Language.CurrentLanguage);
  var localizedText = LocalizationHelper.GetString("Common_Button_OK", teklaCulture);
  

2. 规范资源程序集部署

• 将Common.WPF的本地化资源dll（如Common.WPF.resources.dll）放置在插件目录的对应文化子目录下，例如：

  MyPlugin/
  ├─ zh-CN/
  │  └─ Common.WPF.resources.dll
  ├─ en-US/
  │  └─ Common.WPF.resources.dll
  └─ MyPlugin.dll
  

• 插件安装时确保这些子目录和文件被完整复制到Tekla的插件部署路径。

3. WPF控件绑定优化

• 对于WPF界面元素，使用DynamicResource替代StaticResource绑定本地化字符串，确保文化切换时自动更新内容：

  <Button Content="{DynamicResource Common_Button_OK}" />
  

• 若需要主动切换文化，可手动刷新应用资源字典：

  public static void UpdateCultureResources(CultureInfo culture)
  {
      var resourceUri = new Uri($"pack://application:,,,/Common.WPF;component/Resources/Language.{culture.Name}.xaml");
      var newDict = new ResourceDictionary { Source = resourceUri };
      
      Application.Current.Resources.MergedDictionaries.Clear();
      Application.Current.Resources.MergedDictionaries.Add(newDict);
  }
  

三、额外注意事项 #

• 测试时需确保Tekla Structures的系统语言设置与插件的目标文化一致，避免环境差异导致的显示问题。
• 使用*.ail引用语法时，需确认对应Tekla版本的官方文档，部分旧版本可能对#include语法的支持有限。

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