通过

邮件加载项清单文件中的 VersionOverrides 1.1 元素

  • 项目

此元素包含基本清单中不支持的功能的信息。

注意

本文假定你熟悉 VersionOverrides 元素的概述，其中包含有关元素属性和变体的重要信息。

外接程序类型： 邮件

仅在以下 VersionOverrides 架构中有效：

  • 邮件 1.1

有关详细信息，请参阅 清单中的版本替代。

与以下要求集关联：

  • Mailbox 1.5
  • 某些子元素可能与其他要求集相关联。

子元素

下表仅适用于 VersionOverrides> 元素的 1.1 版<，仅适用于邮件加载项。

注意

在 iOS 中，仅 <支持 WebApplicationInfo> 。 将忽略 VersionOverrides> 的<所有其他子元素。

元素 必需 说明
说明 否 描述外接程序。
Requirements 否 指定必须支持的最低要求集，以便父 <VersionOverrides> 中的标记生效。 这应始终比清单基部分中的 <Requirements> 元素更严格。
Hosts 是 指定 Office 应用程序的集合。 子 Hosts 元素替代清单父部分中的 Hosts 元素。
资源 是 定义其他清单元素引用的资源集合（字符串、URL 和图像）。
EquivalentAddins 否 指定与 Web 加载项等效的本机 (COM/XLL) 加载项。 如果安装了等效的本机加载项，则不会激活 Web 加载项。
<VersionOverrides> 否 当前无法在 VersionOverrides 1.1 中用于邮件加载项。
WebApplicationInfo 否 指定有关外接程序向安全令牌颁发者（例如 Azure Active Directory V2.0）注册的详细信息。
ExtendedPermissions 否 指定扩展权限的集合。

说明

描述外接程序。 这将覆盖清单的任何父部分中的 Description> 元素。< 说明文本包含在 Rescources 元素中的 LongString 元素的子元素中。 residDescription> 元素的属性<不能超过 32 个字符，并且必须与 Resources 元素中包含的 ShortString> 元素的<子元素的 属性的值id匹配。

加载项类型： 任务窗格，邮件

仅在以下 VersionOverrides 架构中有效：

  • 任务窗格 1.0
  • 邮件 1.0
  • 邮件 1.1

有关详细信息，请参阅 清单中的版本替代。

与以下要求集关联：

  • 当父 <VersionOverrides> 类型为 Taskpane 1.0 时，AddinCommands 1.1。
  • 当父 <VersionOverrides> 类型为 Mail 1.0 时邮箱 1.3。
  • 当父 <VersionOverrides> 类型为 Mail 1.1 时邮箱 1.5。

示例

下面展示了一个非常简单的示例。 有关更复杂的示例，请参阅 Office 外接程序代码示例中示例加载项的清单。

下面是典型的 <VersionOverrides> 元素的示例，包括一些不需要但通常使用的子元素。

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>

实现多个版本

清单可以实现 VersionOverrides 元素的多个版本，这些版本支持不同版本的 VersionOverrides 架构。 为此，可以视情况支持新版架构中的新功能，同时仍支持不支持新功能的旧版客户端。

新版架构的 VersionOverrides 元素必须是旧版架构的 VersionOverrides 元素的子元素，才能实现多个版本。 VersionOverrides 子元素不会从父元素继承任何值。

若要同时实现 VersionOverrides v1.0 和 v1.1 架构，清单将类似于以下示例。

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>

    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
      <Description resid="residDescription" />
      <Requirements>
        <!-- add information on requirements -->
      </Requirements>
      <Hosts>
        <Host xsi:type="MailHost">
          <!-- add information on form factors -->
        </Host>
      </Hosts>
      <Resources>
        <!-- add information on resources -->
      </Resources>
    </VersionOverrides>  
  </VersionOverrides>
...
</OfficeApp>