此元素包含基本清单中不支持的功能的信息。
注意
本文假定你熟悉 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。
- 邮箱 1.3(如果父 <VersionOverrides> 类型为 Mail 1.0)。
- 邮箱 1.5(如果父 <VersionOverrides> 类型为 Mail 1.1)。
示例
下面展示了一个非常简单的示例。 有关更复杂的示例,请参阅 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>