邮件加载项清单文件中的 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 元素的子元素中。 resid Description> 元素的属性<不能超过 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>