邮件加载项清单文件中的 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 元素的子元素中。 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 外接程序代码示例中示例加载项的清单。

下面是典型的 <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>