通过

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

  • 项目

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

注意

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

外接程序类型： 邮件

仅在以下 VersionOverrides 架构中有效：

  • 邮件 1.0

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

与以下要求集关联：

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

子元素

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

注意

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

元素 必需 说明
说明 否 描述外接程序。
Requirements 否 指定必须支持的最低要求集，以便父 <VersionOverrides> 中的标记生效。 这应始终比清单基部分中的 <Requirements> 元素更严格。
Hosts 是 指定 Office 应用程序的集合。 子 <Hosts> 元素替代 <清单父部分中的 Hosts> 元素。
资源 是 定义其他清单元素引用的资源集合（字符串、URL 和图像）。
<VersionOverrides> 否 在新版架构下定义外接程序命令。 有关详细信息，请参阅实现多个版本。
WebApplicationInfo 否 指定有关外接程序向安全令牌颁发者（例如 Azure Active Directory V2.0）注册的详细信息。

说明

描述外接程序。 这将覆盖清单的任何父部分中的 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 外接程序代码示例中示例加载项的清单。

<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>
...
</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>