在 WiX 安装中无缝集成 COM TypeLib

2024-03-24 23:47:41

COM 库的 TypeLib 生成和 WiX 安装

问题

在 COM（组件对象模型）开发中，注册类型库 (TypeLib) 是必不可少的，它使 COM 库的类型信息对应用程序可用。在使用 WiX 创建 COM 库安装程序时，如何生成和注册 TypeLib 成为一个常见问题。本文将详细介绍使用 WiX 中的 TypeLib 和 Interface 元素来实现这一目标。

WiX 中的 TypeLib 元素

WiX 提供了 TypeLib 元素，可用于向文件添加 COM 库的 TypeLib 信息。它必须作为文件元素的子元素包含在内。TypeLib 元素有以下属性：

Id： TypeLib 的唯一标识符
Name： TypeLib 的显示名称

Interface 元素

每个 TypeLib 都包含一个或多个 Interface 元素，用于 COM 库中可用的接口。Interface 元素有以下属性：

Id： 接口的唯一标识符
Name： 接口的显示名称
ProxyStubClassId32： 一个预定义的 GUID，用于生成代理和存根类
ClassId： COM 类的 CLSID
ProgId： COM 类的 ProgID
InterfaceId： COM 接口的 IID

信息获取

填写 Interface 元素所需的信息可以通过以下工具获得：

OLEView (OLE/COM Object Viewer) ：一个 Microsoft 工具，用于查看和编辑 COM 组件
TlbImp： 一个 Microsoft 工具，用于从 TypeLib 创建托管互操作程序集
TypeLibExporter： 一个第三方工具，用于从 TypeLib 生成 TypeLib 元素

生成和安装 TypeLib

将 TypeLib 元素添加到 WiX 文件后，WiX 安装程序将负责在安装过程中生成和注册 TypeLib。这将确保使用该库的应用程序能够访问其类型信息。

示例

以下是一个使用 WiX 中的 TypeLib 和 Interface 元素的示例：

<File Id="MyComLibrary" Name="MyComLibrary.dll">
  <Typelib Id="MyComLibraryTypeLib" Name="MyComLibrary Type Library">
    <Interface Id="MyComInterface1" Name="MyComInterface1" ProxyStubClassId32="{00020424-0000-0000-C000-000000000046}" ClassId="{B55B0756-63C3-40D6-90F5-5E846830A9E2}" ProgId="MyComLibrary.MyComInterface1">
      <Version MinVersion="1.0" MajorVersion="1" MinorVersion="0" BuildNumber="0">
        <TypeLib>MyComLibrary.tlb</TypeLib>
      </Version>
    </Interface>
    <Interface Id="MyComInterface2" Name="MyComInterface2" ProxyStubClassId32="{00020424-0000-0000-C000-000000000046}" ClassId="{216546B0-82D2-437D-976B-B2D0A322646F}" ProgId="MyComLibrary.MyComInterface2">
      <Version MinVersion="1.0" MajorVersion="1" MinorVersion="0" BuildNumber="0">
        <TypeLib>MyComLibrary.tlb</TypeLib>
      </Version>
    </Interface>
  </Typelib>
</File>